> ## 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. # VoiceAgents für ausgehende Anrufe > Richten Sie die VoiceAgent-Funktion von CloudTalk ein und nutzen Sie sie, um ausgehende Anrufe effizient abzuwickeln. 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 ***

VoiceAgents für ausgehende Anrufe

**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](/de/articles/11399385-voiceagents-for-inbound-calls), um zu erfahren, wie Sie VoiceAgents für eingehende Szenarien einsetzen.

So funktioniert es

Ausgehende Anrufe mit [VoiceAgent](/de/articles/11053795-getting-started-with-voiceagents) werden ü**ber den [VoiceAgents-Endpunkt der CloudTalk API](/developers#tag/Voice-Agents/operation/createVoiceAgentCall) initiiert**[.](/developers#tag/Voice-Agents/operation/createVoiceAgentCall) 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](/developers#tag/Voice-Agents) 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](/developers#tag/Voice-Agents) ausgelöst**[,](/developers#tag/Voice-Agents) in der Regel im Rahmen einer Workflow-Automatisierung mit: * **HubSpot Workflows** * **Zapier** * **Make** * **Ihren internen Systemen** * **Webhook-basierten Automatisierungen** Konfigurieren Sie Ihre [API-Anfrage](/developers#tag/Voice-Agents) nach diesen Anweisungen: 1. Legen Sie im Tool Ihrer Wahl **den Endpunkt der API-Anfrage fest.** Geben Sie zunächst den Ziel-Endpunkt für die Anfrage an: ```http theme={"system"} POST https://api.cloudtalk.io/v1/voice-agent/calls ``` 2. 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 3. 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:** ```bash theme={"system"} 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](/de/articles/11399385-voiceagents-for-inbound-calls). **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](/de/articles/14072758-voiceagent-skills#h_d5557cb8f7)** 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: ```json theme={"system"} { "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](/de/articles/14072758-voiceagent-skills#h_364d85c8dd). 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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da. ## Related topics - [TCPA-Konformität bei ausgehenden VoiceAgent-Anrufen](/de/articles/17230144-tcpa-compliance-for-voiceagent-outbound-calls.md) - [Erste Schritte mit VoiceAgents](/de/articles/11053795-getting-started-with-voiceagents.md) - [VoiceAgent-Expertenmodus](/de/articles/15933044-voiceagent-expert-mode.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.