> ## 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 über Zapier auslösen

> Lösen Sie CloudTalk VoiceAgent-Anrufe über Zapier mit einem Webhook-Schritt aus: Anrufe automatisieren, Daten übergeben und anpassen – ganz ohne Programmieren.

<Note>
  Diese Anleitung zeigt Ihnen, wie Sie einen Anruf des **CloudTalk VoiceAgent** mit **Zapier** und der App **Webhooks by Zapier** auslösen. So starten Sie automatisierte Sprachanrufe auf Basis von Echtzeit-Ereignissen in Ihren Tools – ganz ohne Programmierung.
</Note>

**Benutzerebene:**

* Admin

***

<h2 id="h_bc6a9f4970">
  CloudTalk VoiceAgents in Zapier
</h2>

Zapier verbindet Ihre bevorzugten Tools und automatisiert Aufgaben zwischen ihnen. By Zapier hilft Ihnen dabei, Ihre Tools zu verbinden und Aufgaben zwischen ihnen zu automatisieren. Wenn Sie es mit dem **CloudTalk VoiceAgent** verbinden, können Sie Sprachanrufe auf Basis von Live-Daten aus Tools wie CRMs, Formularen oder Helpdesk-Systemen auslösen. So bestätigen Sie Termine, fassen bei Leads nach oder versenden Sprach-Erinnerungen mit den Daten, die Sie ohnehin schon erfassen. Damit wird Sprachautomatisierung direkt Teil Ihrer bestehenden Workflows.

Um einen **VoiceAgent-Anruf aus Zapier** auszulösen, senden Sie mit der [Webhooks-App](https://zapier.com/apps/webhook/integrations) in einem der Schritte Ihres Zaps eine API-Anfrage an den [CloudTalk VoiceAgent-Endpunkt](/developers#tag/VoiceAgent).

<h3 id="h_a9cc30eafb">
  Voraussetzungen
</h3>

Bevor Sie den Webhook Custom Request in Zapier einrichten, stellen Sie sicher, dass Sie Folgendes haben:

* *CloudTalk API-Zugangsdaten*

  * Gehen Sie zu **CloudTalk Dashboard → Konto → Einstellungen → API-Schlüssel**

  * Kopieren Sie sowohl die **API Key ID** als auch das **API Key Secret**

* *VoiceAgent-ID*

  * Die VoiceAgent-ID finden Sie im CloudTalk **Dashboard > VoiceAgents**

  <Frame>
    <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/66af489dee4a-vaid.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=067b7d34380535b6ce267b80b228d17a" alt="" width="1622" height="477" data-path="images/help-center/articles/11831224/66af489dee4a-vaid.png" />
  </Frame>

<h3 id="h_b36bf33918">
  Einrichtung
</h3>

Befolgen Sie diese Schritte, um einen VoiceAgent-Anruf aus Zapier auszulösen:

1. Fügen Sie in dem Zap Ihrer Wahl einen **Action**-Schritt hinzu und wählen Sie **Webhooks by Zapier.**

2. Wählen Sie **Custom Request** als Aktionsereignis.

3. Wählen Sie bei **Method** die Option POST

4. Verwenden Sie als API-Endpunkt diese **URL**:\
   [`https://api.cloudtalk.io/v1/voice-agent/calls`](https://api.cloudtalk.io/v1/voice-agent/calls)

5. Konfigurieren Sie unter Data den Body der Anfrage gemäß der [API-Dokumentation](/developers#tag/VoiceAgent)

   * Erstellen Sie eine JSON-Payload im folgenden Format:

     ```json theme={"system"}
     {
     "call_number": "#{{phone_number}}",
     "voice_agent_id": "#{{voice_agent_id}}",
     "call_properties": {
     "system_prompt": {
     "variables": {
     "contact_name": "#{{name}}"
     }
     },
     "output": {
     "variables": {
     "custom_field": "value"
     }
     }
     }
     }
     ```

   * Ersetzen Sie die Variablen (`#{{...}}`) durch Daten aus vorherigen Schritten Ihres Szenarios.

   * Fügen Sie in `call_number` einen Verweis auf die anzurufende Telefonnummer (e.164) ein, die aus vorherigen Schritten stammt.

   * Fügen Sie in `voice_agent_id` die ID des VoiceAgent ein, die Sie im CloudTalk Dashboard erhalten.

   * Konfigurieren Sie bei Bedarf `call_properties`, wobei gilt:

     1. Die Daten in `call_properties.system_prompt.variables` enthalten anfragespezifische Informationen, die der VoiceAgent während des Anrufs verwenden soll (z. B. den Namen des Kontakts).

     2. Die Daten in `call_properties.output.variables` legen fest, welche Werte der VoiceAgent nach dem Anruf zusätzlich zu den im Gespräch erfassten Informationen an den externen Endpunkt übergeben soll.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/bdcbf8b7ba06-image.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=1ac248ff9179fe93b91e2045d354e3b6" alt="" width="867" height="254" data-path="images/help-center/articles/11831224/bdcbf8b7ba06-image.png" />
   </Frame>

<Warning>
  📘 **Möchten Sie tiefer einsteigen?** Erfahren Sie in [diesem eigenen Artikel](/de/articles/11401649-voiceagents-for-outbound-calls#h_91064c3683), wie System-Prompt-Variablen und Output-Variablen das Verhalten Ihres VoiceAgent beeinflussen!
</Warning>

6\. Fügen Sie im Feld **Headers** den Header `"Content-Type": "application/json"` hinzu

8\. Richten Sie **Basic Authentication** ein: Verwenden Sie Ihre **API Key ID** als Benutzernamen und das **API Key Secret** als Passwort, beides aus dem CloudTalk Dashboard.

9\. Klicken Sie auf **Continue**. Wenn Sie die Einrichtung überprüfen möchten, senden Sie mit **Test Step** einen Testanruf.

<Note>
  ⚠️ **Achtung:** Beim Testen des Schritts wird ein echter VoiceAgent-Anruf ausgelöst. Stellen Sie sicher, dass die beim Test verwendete `call_number` eine Nummer ist, die Sie zu diesem Zeitpunkt tatsächlich anrufen möchten.
</Note>

**Alles ist bereit!** 🚀 Ihre Einrichtung ist abgeschlossen und bereit, VoiceAgent-Anrufe ganz einfach auszulösen. Auf geht's mit der Automatisierung!

<Info>
  **💡 API-Limits, die Sie im Blick behalten sollten**

  *Damit es nicht zu Fehlern oder Drosselungen kommt, sollte Ihr Make-Szenario die Anrufverteilung sorgfältig steuern. Nutzen Sie bei Bedarf Verzögerungen, Warteschlangen oder eine Zeitsteuerung, denn für den VoiceAgent-Endpunkt gilt das Standard-API-Ratenlimit (60 Anfragen pro Minute).*
</Info>

***

*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 über Make auslösen](/de/articles/11830974-triggering-a-voiceagent-call-from-make.md)
- [VoiceAgent-Anruf aus Zendesk auslösen](/de/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)
- [VoiceAgent-Anruf aus Kustomer auslösen](/de/articles/16063131-triggering-a-voiceagent-call-from-kustomer.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.