VoiceAgents für ausgehende Anrufe

In diesem Artikel erfahren Sie, wie Sie die VoiceAgent-Funktion von CloudTalk für ausgehende Anrufe einrichten und nutzen. Die Anleitung zeigt, wie Sie automatisierte Anrufe auslösen und Gespräche abwickeln, ohne dass Agenten in Echtzeit eingreifen müssen.

Benutzerebene: Admin

VoiceAgent für ausgehende Anrufe ermöglicht es Teams, ausgehende Kundeninteraktionen zu automatisieren, indem Anrufe durch KI-gesteuerte Agenten initiiert werden. Ideal ist das für Aufgaben wie Nachfassaktionen, Terminbestätigungen, Umfragen oder proaktive Benachrichtigungen – so bleibt Ihren Agenten mehr Zeit für komplexere Gespräche und die operative Effizienz steigt.

💡 Möchten Sie stattdessen eingehende Anrufe automatisiert bearbeiten? Werfen Sie einen Blick in die Anleitung zu VoiceAgent für eingehende Anrufe, um zu erfahren, wie Sie VoiceAgents für eingehende Szenarien einsetzen.

So funktioniert es

Ausgehende Anrufe mit VoiceAgent werden über den VoiceAgents-Endpunkt der CloudTalk API initiiert. Soll ein Anruf ausgeführt werden, sendet in der Regel ein externes Tool oder ein CRM eine Anfrage an die API, einschließlich der erforderlichen Angaben zur Person, die kontaktiert werden soll. Dazu gehören typischerweise Daten wie die Telefonnummer des Empfängers sowie alle Kontextinformationen, die der VoiceAgent während des Gesprächs verwenden soll. Die mit der API-Anfrage übergebenen anrufbezogenen Daten zieht der VoiceAgent während der Interaktion heran, sodass er entsprechend den Vorgaben in der VoiceAgent-Konfiguration reagiert und agiert. Der gesamte Prozess ist automatisiert und erfordert keinen menschlichen Agenten, wodurch eine effiziente und skalierbare Kommunikation bei ausgehenden Anrufen möglich wird.

Ausgehende VoiceAgent-Anrufe über die API auslösen

In diesem Abschnitt erfahren Sie, wie Sie ausgehende VoiceAgent-Anrufe über die API von CloudTalk auslösen – einschließlich der wichtigsten Konfigurationsschritte für eine korrekte Ausführung und Datenverarbeitung.

Voraussetzungen

Aktivierte VoiceAgents-Funktion in Ihrem CloudTalk Dashboard.
Ein konfigurierter VoiceAgent für ausgehende Anrufe in Ihrem Konto. Diesen können Sie erstellen, indem Sie:
- eine Vorlage auswählen, die die ausgehende Anrufrichtung enthält
- einen benutzerdefinierten VoiceAgent erstellen und die ausgehende Anrufrichtung auswählen.

Implementierung

Anstatt Anrufe manuell zu starten, werden ausgehende VoiceAgent-Anrufe über die CloudTalk API ausgelöst, in der Regel im Rahmen einer Workflow-Automatisierung mit:

HubSpot Workflows
Zapier
Make
Ihren internen Systemen
Webhook-basierten Automatisierungen

Konfigurieren Sie Ihre API-Anfrage nach diesen Anweisungen:

Legen Sie im Tool Ihrer Wahl den Endpunkt der API-Anfrage fest. Geben Sie zunächst den Ziel-Endpunkt für die Anfrage an:
POST https://api.cloudtalk.io/v1/voice-agent/calls
Konfigurieren Sie in den Headern der Konfiguration den Authorization-Header.
Authorization: Basic BASE64(api_key_id:api_key)
Die CloudTalk API verwendet Basic Authentication, wobei
- api_key_id : die ID Ihres API-Schlüssels aus CloudTalk Dashboard > Einstellungen > API-Schlüssel > API-Schlüssel-Detail > ID ist
- api_key Ihr unverschlüsselter API-Schlüssel aus CloudTalk Dashboard > Einstellungen > API-Schlüssel > API-Schlüssel-Detail > Schlüssel ist
Konfigurieren Sie im Anfragetext die erforderlichen Felder.
1. call_number – Telefonnummer, die der VoiceAgent anrufen soll, im Format E.164
2. voice_agent_id – Die ID des VoiceAgent. Sie finden sie im CloudTalk Dashboard → VoiceAgents -> Agenten. Öffnen Sie das Detail des gewünschten VoiceAgent und kopieren Sie die ID aus der URL dieser Seite.
3. call_properties mit
  1. system_prompt Variablen – werden an den System-Prompt des VoiceAgent übergeben und sind der KI während des Anrufs sichtbar. Nutzen Sie sie, um den Anruf zu personalisieren (z. B. #{{name}}, #{{order_id}}). Nur erforderlich, wenn Sie in der VoiceAgent-Konfiguration Variablen verwenden.
  2. Output-Variablen – im Payload des Anrufanalyse-Webhooks enthalten.

⚠️ Nehmen Sie das system_prompt Objekt und das output Objekt nur dann in die API-Anfrage auf, wenn Sie im Prompt des VoiceAgent tatsächlich Variablen verwenden.

Beispiel für eine API-Anfrage:

curl \--location 'https://api.cloudtalk.io/v1/voice-agent/calls' \--header 'Content-Type: application/json' \--header 'Authorization: Basic dfjag57df********f5gdf4gs4dgd' \--data '{  "call_number": "+421 903 123 123",  "voice_agent_id": "67eaa636148d700a8dmckaf1",  "call_properties": {    "system_prompt": {      "variables": {        "name": "John"      }    },    "output": {      "variables": {        "customer_id": 12345      }    }  }}'

System-Prompt-Variablen und Output-Variablen verstehen

Wenn Sie einen VoiceAgent-Anruf über die API konfigurieren, können Sie zwei Arten von Variablen mitgeben, um das Gespräch anzureichern und die Nachbearbeitung zu unterstützen:

System-Prompt-Variablen
Output-Variablen.

Diese Variablen erfüllen im VoiceAgent-Workflow unterschiedliche Zwecke und sollten entsprechend eingesetzt werden.

System-Prompt-Variablen

Kontaktvariablen werden bei ausgehenden Anrufen anhand der gewählten Nummer befüllt. Gehört die angerufene Nummer zu einem Kontakt in CloudTalk, werden Kontaktvariablen wie #{{contact.name}} mit den Daten dieses Kontakts befüllt. Teilen sich mehrere Kontakte die Nummer, wird der erste Treffer verwendet; um einen bestimmten Kontakt anzurufen, senden Sie dessen contact_id in der API-Anfrage. Passt kein Kontakt oder schlägt die Suche nach der Nummer fehl, wird der Anruf ohne Kontakt fortgesetzt und die Kontaktvariablen bleiben leer, sofern Sie keinen nicht leeren Wert dafür in system_prompt.variables übergeben; mit contact_id wird der Anruf bei einer fehlgeschlagenen Suche stattdessen abgelehnt. Ein nicht leerer Wert, den Sie für eine contact.*-Variable in system_prompt.variables übergeben, ersetzt den Wert des Kontakts. #{{caller_number}} wird nur bei Agenten für eingehende Anrufe befüllt. Die Liste der Kontaktvariablen finden Sie unter VoiceAgents für eingehende Anrufe.

System-Prompt-Variablen sind der KI während des Anrufs sichtbar und helfen dabei, das Gespräch zu personalisieren oder dem VoiceAgent wichtigen Kontext zu liefern. Fügen Sie Variablen mit doppelten geschweiften Klammern (#{{ }}) in Ihren Prompt ein. Beispiel für eine Begrüßung_:_

Hello #{{name}}, I'm calling to confirm your order number #{{order_id}} placed on #{{order_date}}.

Achten Sie beim Senden der API-Anfrage darauf, dass diese Variablen im Objekt system_prompt.variables im Anfragetext enthalten sind. Zum Beispiel:

"system_prompt": {
  "variables": {
    "name": "Alex",
    "order_id": "123456",
    "order_date": "2025-05-18"
  }
}

Wird eine Variable im Prompt verwendet, aber nicht in der API-Anfrage übergeben, kann der VoiceAgent sie nicht nutzen, was zu Fehlern oder einer schlechteren Nutzererfahrung führen kann. Kontaktvariablen wie #{{contact.name}} sind die Ausnahme: Sie werden, wie oben beschrieben, aus dem Kontakt des Anrufs befüllt und bleiben leer, wenn der Anruf keinen Kontakt hat.

Output-Variablen

Output-Variablen sind der KI während des Anrufs nicht sichtbar. Stattdessen dienen sie dazu, dem Gespräch Metadaten oder Kontext anzuhängen, die nach Gesprächsende in der Anrufanalyse und in den extrahierten Informationen verfügbar sind. Diese Variablen werden mit der API-Anfrage übermittelt und sind im Webhook-Payload enthalten, sodass Ihre Systeme das Anrufergebnis mit vollem Kontext verarbeiten können, obwohl der VoiceAgent diese Daten im Gespräch nicht verwendet hat. Beispiel Angenommen, Ihre Fähigkeit Informationen extrahieren ist wie folgt eingerichtet:

In Ihrer API-Anfrage geben Sie eine Output-Variable mit, um externen Kontext zu übergeben (in diesem Fall customer_id):

"output": {  "variables": {    "customer_id": 12345  }}

Dieser Wert ist für den VoiceAgent während des Anrufs nicht sichtbar, er ist aber im Webhook-Payload enthalten, der nach Gesprächsende gesendet wird. Der vollständige Webhook-Payload sieht so aus:

{  "data": {    "ct_call_context": {      "uuid": "160f677d-d2f2-419d-822d-b45f33e4fe6c",      "status": "Connected",      "datetime": "2026-06-17T08:38:31Z",      "duration": 23    },    "message_left_by_caller": {      "caller_name": null,      "content": null    },    "customer_id": 12345,    "Summary": "The caller confirmed they want a callback tomorrow morning.",    "Callback_Confirmed": true  }}

💡 Jeder Webhook-Payload enthält jetzt ein ct_call_context-Objekt mit der UUID, dem Status, der Startzeit und der Dauer des Anrufs. Über das Feld uuid können Sie den Anruf in CloudTalk nachschlagen oder ihn Datensätzen in Ihrem CRM oder Data Warehouse zuordnen. Die vollständige Payload-Referenz finden Sie unter VoiceAgent-Fähigkeiten – Informationen extrahieren.

So können Sie die Automatisierung oder das Reporting nach dem Anruf mit zusätzlichem Kontext anreichern, der nie Teil des gesprochenen Gesprächs war.

Durch die Kombination beider Variablentypen führen Sie während des Anrufs hochgradig personalisierte Gespräche und behalten danach den vollen operativen Kontext – ohne die KI mit unnötigen Daten zu überladen.

Brauchen Sie Hilfe oder haben Sie eine Frage? Melden Sie sich einfach über unser Support-Portal — wir sind für Sie da.

Erste Schritte

Nummern & Portierung

KI

AI Sales Dialer

CloudTalk Phone & Go

Nachrichten

Dashboard

Integrationen

Abrechnung & Abonnement

Tech-News & Updates

Altes Dashboard

VoiceAgents für ausgehende Anrufe