> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# VoiceAgent-Anruf aus HubSpot auslösen
> VoiceAgent-Anrufe aus HubSpot automatisieren
Sie können einen CloudTalk VoiceAgent-Anruf automatisch über HubSpot Workflows auslösen. Diese Anleitung zeigt Ihnen, wie Sie den Trigger einrichten, Kontaktdaten an CloudTalk übergeben und die Enrollment-Ergebnisse in HubSpot einsehen.
**Benutzerebene**: Agent
***
Bevor Sie beginnen
Sie benötigen:
* Einen bereits erstellten CloudTalk VoiceAgent
* CloudTalk-API-Zugangsdaten (API-Schlüssel und Secret)
* Ein HubSpot-Konto mit Zugriff auf Workflows
* Kontakteigenschaften, die mindestens eine Telefonnummer enthalten
HubSpot-Workflow-Trigger erstellen
1. Öffnen Sie **HubSpot > Workflows**.
2. Erstellen Sie einen neuen **Contact-based**-Workflow.
3. Wählen Sie einen Triggertyp, zum Beispiel:
* Property value changed
* List membership changed\
(Benutzerdefinierte Felder werden ebenfalls unterstützt.)
4. **Optional**: Aktivieren Sie **Re-enrollment**, wenn derselbe Kontakt mehrfach angerufen werden soll, sobald die Bedingungen erfüllt sind.
Custom-Code-Aktion hinzufügen
Nachdem Sie Ihren Trigger festgelegt haben:
1. Klicken Sie auf **`+ Aktion hinzufügen`**
2. Wählen Sie **Data ops > Custom code**
3. Konfigurieren Sie die Aktion:
* **Language:** Node.js 20.x
* **Secrets:** Leer lassen
* **Properties to include in code:**
* `phone` (erforderlich)
* Weitere Felder nach Bedarf, etwa `name` oder `contactId`
Diese Eigenschaften werden im Skript zu `event.inputFields[...]`.
Code-Snippet einfügen
```
const axios = require('axios');
exports.main = async (event, callback) => {
const phone = event.inputFields['phone'];
const name = event.inputFields['name'];
const contactId = event.inputFields['contactId'];
try {
// Convert hs_object_id to integer
const contactIDint = parseInt(contactId, 10);
// Check if conversion was successful
if (isNaN(contactIDint)) {
throw new Error('Invalid hs_object_id: not a number');
}
// Prepare request body
const data = {
call_number: phone,
voice_agent_id: "67eba86558ba995b89e05e08",
call_properties: {
system_prompt: {
variables: {
name: name
}
},
output: {
variables: {
contactID: contactIDint
}
}
}
};
// Send POST request
const response = await axios.post('https://api.cloudtalk.io/v1/voice-agent/calls', data, {
headers: {
'Authorization': 'Basic #{{ Auth Header}}',
'Content-Type': 'application/json'
}
});
// Log success and return
console.log('Call triggered successfully:', response.data);
callback({
outputFields: {
status: 'Call triggered successfully'
}
});
} catch (error) {
console.error('Error triggering call:', error.message);
callback({
outputFields: {
status: `Error: ${error.message}`
}
});
}
};
```
**Dieses Skript**:
* Sendet eine POST-Anfrage an die CloudTalk VoiceAgent API
* Übergibt die Telefonnummer des Kontakts
* Übergibt optional Variablen wie den Vornamen oder die Record ID
* Empfängt die VoiceAgent-Ausgabe an dem von Ihnen gewählten Endpunkt in CloudTalk
Authorization-Header generieren
CloudTalk verwendet Basic Authentication für API-Anfragen.\
So generieren Sie Ihren codierten Wert:
1. Gehen Sie zu **[https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)**
2. Geben Sie Ihren **CloudTalk API-Schlüssel** und Ihr **CloudTalk API Secret** ein\
(zu finden in Ihren CloudTalk-**Unternehmenseinstellungen**).
3. Kopieren Sie den generierten Header. Er sieht etwa so aus: `Basic XXXXXXXXX`
Ersetzen Sie `#{{ Auth Header }}` im Skript durch diesen Wert.
Workflow veröffentlichen und testen
1. Speichern Sie den Custom-Code-Schritt.
2. Klicken Sie auf **Review and publish**.
3. Entscheiden Sie, ob der Workflow:
* nur für neue Kontakte ausgeführt werden soll, die die Bedingungen erfüllen, oder
* auch für Kontakte ausgeführt werden soll, die die Bedingungen bei der Aktivierung des Workflows bereits erfüllen.
4. Lösen Sie den Workflow aus, indem Sie eine Eigenschaft oder die Listenzugehörigkeit eines Testkontakts aktualisieren.
Enrollment History prüfen
So prüfen Sie, ob Ihr VoiceAgent-Anruf ausgelöst wurde:
1. Öffnen Sie den Workflow
2. Gehen Sie zu **Performance history > Enrollment history**
3. Suchen Sie Ihren Testkontakt in der Liste
Wenn alles funktioniert hat, sehen Sie den registrierten Kontakt und die Aktion **Call triggered successfully**.
**Fertig!**
Ihr HubSpot-Workflow löst nun automatisch einen CloudTalk VoiceAgent-Anruf aus, sobald ein Kontakt Ihre gewählten Bedingungen erfüllt.
***
*Brauchen Sie Hilfe oder haben Sie eine Frage?* Melden Sie sich einfach über unser [Support-Portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da.
## Related topics
- [VoiceAgent-Anruf aus Kustomer auslösen](/de/articles/16063131-triggering-a-voiceagent-call-from-kustomer.md)
- [VoiceAgent-Anruf aus Freshdesk auslösen](/de/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [VoiceAgent-Anruf aus Freshservice auslösen](/de/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.