> ## 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 Zendesk auslösen

> VoiceAgent-Anrufe über Zendesk Triggers und Automations automatisieren

<Note>
  Sie können einen CloudTalk VoiceAgent-Anruf automatisch über Zendesk Triggers oder Automations auslösen. Zendesk unterstützt Basic Authentication in seiner Webhooks-Konfiguration nativ, sodass keine Middleware erforderlich ist. Diese Anleitung zeigt Ihnen, wie Sie den Webhook einrichten, ihn mit einem Trigger verbinden und prüfen, ob der Anruf gestartet wurde.
</Note>

**Benutzerebene**: Admin

***

<h2 id="before-you-start">
  Bevor Sie beginnen
</h2>

Sie benötigen:

* Einen bereits erstellten CloudTalk VoiceAgent (notieren Sie sich die VoiceAgent-ID)

* CloudTalk API-Schlüssel und Secret (**Unternehmenseinstellungen > Integrationen > API**)

* Zendesk Support Professional Plan oder höher

* Kontakt-/Anfragendatensätze mit einer Telefonnummer

<h2 id="h_b1f5f41ac5">
  Integration einrichten
</h2>

<h3 id="h_a74c65c2a1">
  Webhook erstellen
</h3>

1. Gehen Sie im Zendesk Admin Center zu **Apps and integrations > Webhooks**.

2. Klicken Sie auf **Create webhook**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/b1a87fcbfc33-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3b3b2435d5b92b81e7ff3e70e6d73eac" alt="" width="3600" height="2064" data-path="images/help-center/articles/15934846/b1a87fcbfc33-image.png" />
   </Frame>

3. Wählen Sie **Trigger or automation** und klicken Sie auf **Next**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/d66feedd2495-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=506cf3c3e35dd681833fb33a90c56c46" alt="" width="2970" height="1896" data-path="images/help-center/articles/15934846/d66feedd2495-image.png" />
   </Frame>

4. Konfigurieren Sie den Webhook:

   * **Name:** CloudTalk VoiceAgent

   * **Endpoint URL:** `https://api.cloudtalk.io/v1/voice-agent/calls`

   * **Request method:** POST

   * **Request format:** JSON

   * **Authentication:** Basic authentication

     * **Username:** Ihr CloudTalk API-Schlüssel

     * **Password:** Ihr CloudTalk API Secret

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/6295a2943f0e-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=78c8949f05e2337d22167fae3481702c" alt="" width="1586" height="1528" data-path="images/help-center/articles/15934846/6295a2943f0e-image.png" />
   </Frame>

5. Klicken Sie auf **Create webhook > Finish Setup**.

<Note>
  Zendesk übernimmt die Base64-Kodierung der Zugangsdaten automatisch, wenn Basic authentication ausgewählt ist.
</Note>

<h3 id="h_81ccd62750">
  Trigger erstellen
</h3>

1. Gehen Sie im Admin Center zu **Objects and rules > Business rules > Triggers** (oder **Automations**).

2. Klicken Sie auf **Create trigger**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/e30863086760-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=45848cc42f215461c9dbbff9d8c3c689" alt="" width="3628" height="1532" data-path="images/help-center/articles/15934846/e30863086760-image.png" />
   </Frame>

3. Geben Sie einen **Trigger name** ein (z. B. Ticket Solved).

4. Wählen Sie eine **Trigger category**: Erstellen Sie eine neue Kategorie oder wählen Sie eine passende bestehende aus.

5. Legen Sie Ihre **Conditions** fest (z. B. Ticket > Status > Is > Solved).

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15934846/036d3ef902d4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=15d81021252741ab2093e78d05d3fba1" alt="" width="1538" height="1242" data-path="images/help-center/articles/15934846/036d3ef902d4-image.png" />
   </Frame>

6. Klicken Sie unter **Actions** auf **Add action** und wählen Sie **Notify active webhook**.

7. Wählen Sie den in Schritt 1 erstellten Webhook aus. Es erscheint ein Textfeld für den JSON-Body.

8. Geben Sie Ihre JSON-Payload in das Textfeld ein. Verwenden Sie den Zendesk-Platzhalter `#{{ticket.requester.phone}}`, um die Telefonnummer des Anfragenden auf `call_number` zu mappen:

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/bd395bb986f2-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=abcee019a5e4d70d2fa724ad55563348" alt="" width="1574" height="1770" data-path="images/help-center/articles/15934846/bd395bb986f2-image.png" />
   </Frame>

```json theme={"system"}
{
  "call_number": "#{{ticket.requester.phone}}",
  "voice_agent_id": "YOUR_VOICE_AGENT_ID"
}
```

<Note>
  `call_number` und `voice_agent_id` sind die einzigen Pflichtfelder. Zusätzliche `call_properties` wie System-Prompt-Variablen und Ausgabevariablen sind optional und hängen von Ihrer VoiceAgent-Konfiguration ab. [Erfahren Sie, was Sie angeben sollten](/de/articles/11401649-voiceagents-for-outbound-calls).
</Note>

9\. Setzen Sie den Trigger unten rechts auf **Active** und klicken Sie auf **Create**.

<h3 id="h_b45d7e4a09">
  Testen und prüfen
</h3>

1. Aktualisieren Sie ein Testticket so, dass es die Trigger-Bedingungen erfüllt.

2. Gehen Sie zu **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity**, um die Zustellung zu bestätigen.

3. Prüfen Sie in CloudTalk, ob der VoiceAgent-Anruf gestartet wurde.

**Fertig!**

Zendesk löst nun automatisch einen CloudTalk VoiceAgent-Anruf aus, sobald ein Ticket Ihre gewählten Bedingungen erfüllt.

<h2 id="troubleshooting">
  Fehlerbehebung
</h2>

Wenn der Anruf nicht gestartet wurde, gehen Sie zu **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity**, um zu sehen, warum die Zustellung fehlgeschlagen ist.

Die häufigsten Ursachen sind:

* **Autorisierung**: falsche CloudTalk API-Zugangsdaten im Webhook

* **Telefonnummernformat**: Die Nummer liegt nicht im E.164-Format vor (`+1234567890`)

* **Falsche VoiceAgent-ID**: Es wurde die falsche `voice_agent_id` gesendet

* **Webhook nicht ausgelöst**: Der Trigger ist nicht aktiv oder seine Bedingungen wurden nicht 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.