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

> VoiceAgent-Anrufe direkt aus Freshdesk automatisieren

<Note>
  In dieser Anleitung erfahren Sie, wie Sie mit Automation Rules automatisch einen CloudTalk VoiceAgent-Anruf aus Freshdesk auslösen. Die Aktion **Trigger Webhook** gibt Ihnen volle Kontrolle über HTTP-Methode, URL, Header und Body, sodass Anrufe direkt aus Ticket-Ereignissen gestartet werden können.
</Note>

**Benutzerebene**: Administrator

***

<h2 id="h_c4f65f76b0">
  Bevor Sie beginnen
</h2>

Sie benötigen:

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

* CloudTalk-API-Zugangsdaten (API-Schlüssel und Secret), die Sie unter **Unternehmenseinstellungen > Integrationen > API** finden ([So finden und generieren Sie Ihre CloudTalk-API-Schlüssel](/de/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Einen Freshdesk **Pro-Tarif** oder höher

* Eine Telefonnummer, die in den Contact-Datensätzen verfügbar ist

<h2 id="h_e32b3b4cc1">
  Authorization-Header generieren
</h2>

CloudTalk verwendet für API-Anfragen Basic Authentication.

1. Öffnen Sie [https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)

2. Geben Sie Ihren **CloudTalk-API-Schlüssel** als Username und Ihr **API-Secret** als Password ein

3. Kopieren Sie den generierten Wert. Er sieht so aus: `Basic XXXXXXXXX`

<Warning>
  **Hinweis:** Freshdesk akzeptiert in der Webhook-Konfiguration auch eine einfache Kombination aus Benutzername und Passwort, der Base64-codierte Header ist also optional. Beide Wege funktionieren.
</Warning>

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

<h3 id="h_e02ace1232">
  Automation Rule erstellen
</h3>

1\. Gehen Sie in Freshdesk zu **Admin > Automation > Ticket Creation** (oder **On Ticket Update**, je nachdem, wann die Anrufe ausgelöst werden sollen)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=5a7cc485d58bd1d956110794946f4af7" alt="" width="2936" height="1322" data-path="images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png" />
</Frame>

2\. Klicken Sie auf **Start from scratch**

3\. Legen Sie Ihre **Bedingungen** fest, zum Beispiel:

* *Ticket is created*

* *Contact phone is present*

* *Tag contains* `voiceagent`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f883a536c594b5986ed2490dbcdb112" alt="" width="2926" height="1310" data-path="images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png" />
</Frame>

4\. Klicken Sie unter **Actions** auf **Add action > Trigger Webhook**

5\. Konfigurieren Sie den Webhook:

| **Feld** | **Wert** |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88d12880285be17c78721cb9768b7c11" alt="" width="2926" height="1332" data-path="images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png" />
</Frame>

6\. Fügen Sie unter **Custom Headers** Folgendes hinzu:

* `Authorization` > `Basic XXXXXXXXX`

* `Content-Type` > `application/json`

7\. Fügen Sie unter **Content (Advanced)** den folgenden Body ein:

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

<Warning>
  `call_number` und `voice_agent_id` sind die einzigen Pflichtfelder. Je nach Konfiguration Ihres VoiceAgent können Sie auch optionale `call_properties` übergeben, etwa Variablen des System-Prompts und Ausgabevariablen. [Erfahren Sie, was Sie angeben können](/de/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=623092ba130f596b5667a223dc720089" alt="" width="2922" height="1316" data-path="images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png" />
</Frame>

8\. Klicken Sie auf **Preview and save** und aktivieren Sie dann die Regel.

<h3 id="h_9e07057933">
  Testen und überprüfen
</h3>

1. Erstellen oder aktualisieren Sie ein Ticket, das Ihren Auslösebedingungen entspricht

2. Gehen Sie zu **Admin > Automation** und prüfen Sie das Ausführungsprotokoll der Regel

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

**Fertig!** 🚀 Ihre Freshdesk-Automatisierungsregel löst jetzt einen CloudTalk VoiceAgent-Anruf aus, sobald ein Ticket Ihre gewählten Bedingungen erfüllt.

<Info>
  💡 **API-Limits, die Sie beachten sollten**

  *Damit keine Fehler oder Drosselungen auftreten, sollte Ihre Freshdesk-Automatisierung die Verteilung der Anrufe sorgfältig steuern. Nutzen Sie bei Bedarf Verzögerungen oder eine zeitliche Planung, denn für den VoiceAgent-Endpunkt gilt das Standard-API-Ratenlimit (60 Anfragen pro Minute).*
</Info>

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

| Fehler | Was zu prüfen ist |
| - | - |
| **401 Unauthorized** | Authorization-Header neu generieren und erneut eintragen |
| **400 Bad Request** | Stellen Sie sicher, dass die Telefonnummer im E.164-Format vorliegt (`+1234567890`) und dass `voice_agent_id` korrekt ist |
| **Regel wird nicht ausgelöst** | Prüfen Sie, ob alle Bedingungen erfüllt sind und die Regel aktiviert ist |

***

Brauchen Sie Hilfe oder haben Sie eine Frage? Wenden Sie sich an 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 Freshservice auslösen](/de/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
- [VoiceAgent-Anruf aus Pipedrive auslösen](/de/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)


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