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

> Ausgehende VoiceAgent-Anrufe direkt aus Freshworks CRM automatisieren

<Note>
  In dieser Anleitung erfahren Sie, wie Sie mit Workflow-Automatisierungen automatisch einen CloudTalk-VoiceAgent-Anruf aus Freshworks CRM (Freshsales) auslösen.
</Note>

**Benutzerebene**: Admin

***

<h2 id="h_79a9f66077">
  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) aus **Unternehmenseinstellungen > Integrationen > API** ([So greifen Sie auf Ihre CloudTalk-API-Schlüssel zu und generieren sie](/de/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Einen **Growth-Plan** oder höher in Freshworks CRM

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

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

CloudTalk verwendet Basic Authentication für API-Anfragen.

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 Benutzernamen und Ihr **API-Secret** als Passwort ein

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

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

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

<h3 id="h_f1af3c1b59">
  Workflow-Automatisierung erstellen
</h3>

1\. Gehen Sie in Freshworks CRM zu **Admin Settings > Teams & Territories > Workflows**

2\. Klicken Sie auf **Create your own workflow**

3\. Wählen Sie das Modul: **Contacts** (oder Accounts / Deals)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/4ed42b39df69-screenshot-2b2026-06-05-2bat-2b10-39-24.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=07b9b15294311943027b45315d1cfa2c" alt="" width="2938" height="1440" data-path="images/help-center/articles/15477534/4ed42b39df69-screenshot-2b2026-06-05-2bat-2b10-39-24.png" />
</Frame>

4\. Legen Sie das **Auslöseereignis** fest, zum Beispiel:

* *Contact is created*

* *Field is updated* (z. B. Status wechselt zu „Interested")

5\. Fügen Sie **Bedingungen** hinzu, um zu filtern, welche Datensätze den Anruf auslösen (z. B. Mobilnummer ist vorhanden)

<h3 id="h_f7ef74ca45">
  Webhook-Aktion hinzufügen
</h3>

1\. Klicken Sie unter **Actions** auf **Add Action > Webhook**

2\. Konfigurieren Sie den Webhook:

| Feld | Wert |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Authentication | Username / Password (Client ID / Client Secret) |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/8bcb703b957f-screenshot-2026-06-05-at-10-45-56.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=0aaef50a525a233f51bb969c28ba02a1" alt="" width="1616" height="1440" data-path="images/help-center/articles/15477534/8bcb703b957f-screenshot-2026-06-05-at-10-45-56.png" />
</Frame>

3\. Fügen Sie unter **Request body (Advanced)** Folgendes ein:

```json theme={"system"}
{   "call_number": "#{{contact.mobile_number}}",   "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 außerdem optionale `call_properties` übergeben, etwa Variablen für den System-Prompt und Ausgabevariablen. [Erfahren Sie, was Sie einbinden können](/de/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

4\. Klicken Sie auf **Save** und anschließend auf **Enable**, um den Workflow zu aktivieren.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/078179a91220-screenshot-2026-06-05-at-10-48-57.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bc5537be8d1094240414815a05b478c3" alt="" width="2938" height="1436" data-path="images/help-center/articles/15477534/078179a91220-screenshot-2026-06-05-at-10-48-57.png" />
</Frame>

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

1. Erstellen oder aktualisieren Sie einen Contact, der Ihre Auslösebedingungen erfüllt

2. Gehen Sie zu **Admin Settings > Automations > Workflow logs** und prüfen Sie den Ausführungsstatus

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

**Fertig!** 🚀 Ihr Freshworks-CRM-Workflow löst jetzt einen CloudTalk-VoiceAgent-Anruf aus, sobald ein Kontakt Ihre gewählten Bedingungen erfüllt.

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

  *Damit keine Fehler oder Drosselungen auftreten, sollte Ihr Freshworks-CRM-Workflow die Anrufverteilung sorgfältig steuern. Verwenden Sie bei Bedarf Verzögerungen oder eine Zeitplanungslogik, denn für den VoiceAgent-Endpunkt gilt das standardmäßige API-Rate-Limit (60 Anfragen pro Minute).*
</Info>

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

| Fehler | Was zu prüfen ist |
| - | - |
| **401 Unauthorized** | Generieren Sie den Authorization-Header bzw. die Zugangsdaten neu und geben Sie sie erneut ein |
| **400 Bad Request** | Stellen Sie sicher, dass die Telefonnummer im E.164-Format vorliegt (`+1234567890`) und dass `voice_agent_id` korrekt ist |
| **Workflow läuft nicht** | Prüfen Sie, ob alle Bedingungen erfüllt sind, das Auslöseereignis zutrifft und der Workflow aktiviert ist |

***

Sie brauchen Hilfe oder haben 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 Zoho CRM auslösen](/de/articles/15516182-triggering-a-voiceagent-call-from-zoho-crm.md)
- [VoiceAgent-Anruf über Zapier auslösen](/de/articles/11831224-triggering-a-voiceagent-call-from-zapier.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.