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 funktionieren bei Agenten für ausgehende Anrufe nicht. Variablen wie #{{contact.name}} oder #{{caller_number}} werden nur bei Agenten für eingehende Anrufe automatisch befüllt. Für ausgehende Anrufe definieren Sie eigene benutzerdefinierte Variablen und übergeben deren Werte in der API-Anfrage, wie unten beschrieben. Informationen zur Personalisierung bei eingehenden Anrufen 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.

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