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

> Ausgehende VoiceAgent-Anrufe direkt aus Zoho CRM automatisieren

<Note>
  In dieser Anleitung erfahren Sie, wie Sie mit Workflow Rules automatisch einen CloudTalk VoiceAgent-Anruf aus Zoho CRM auslösen.
</Note>

**Benutzerebene**: Admin

***

<h2 id="h_before_you_start">
  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))

* Zoho CRM **Professional-Tarif** oder höher

* Ein Telefonfeld in Contact- oder Lead-Datensätzen

<h2 id="h_generate_auth">
  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 Username und Ihr **API Secret** als Password ein

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

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

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

1\. Klicken Sie in Zoho CRM oben rechts auf das **Zahnradsymbol** und gehen Sie dann zu **Automation > Actions > Webhooks**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/98feae8fe1a4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c66f0979edeb7832e8f6616f11539e01" alt="" width="2840" height="1160" data-path="images/help-center/articles/15516182/98feae8fe1a4-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/73f55ba967b7-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88bd7e10c27198c0b30f581ff28cba2e" alt="" width="2384" height="544" data-path="images/help-center/articles/15516182/73f55ba967b7-image.png" />
</Frame>

2\. Klicken Sie auf **Configure Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/c29a495b2b90-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1fc63b01d658701a43e6dfce477807bf" alt="" width="2384" height="530" data-path="images/help-center/articles/15516182/c29a495b2b90-image.png" />
</Frame>

3\. Tragen Sie die Webhook-Details ein:

| **Feld** | **Wert** |
| - | - |
| Name | CloudTalk VoiceAgent |
| URL to Notify | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Method | POST |
| Authorization Type | General |
| Module | Contacts oder Leads |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/4a5c1aef7583-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a28db82730d3f7679e9ffb17a0c66e40" alt="" width="1385" height="949" data-path="images/help-center/articles/15516182/4a5c1aef7583-image.png" />
</Frame>

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

* `Authorization` → `Basic XXXXXXXXX` (Ihr generierter Wert)

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

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5242d55f0b27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=553381a3ed9fd980e2c3a4d21af4a47b" alt="" width="1644" height="514" data-path="images/help-center/articles/15516182/5242d55f0b27-image.png" />
</Frame>

5\. Setzen Sie unter **Body** den **Type** auf Raw und das **Format** auf JSON und fügen Sie dann Folgendes ein:

```json theme={"system"}
{  "call_number": "${Contacts.Phone}",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

<Warning>
  `call_number` und `voice_agent_id` sind die einzigen Pflichtfelder. Sie können außerdem optionale `call_properties` übergeben, etwa Variablen für den System-Prompt und Ausgabevariablen, abhängig von Ihrer VoiceAgent-Konfiguration. [Erfahren Sie, was Sie angeben sollten](/de/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5dae1c82d009-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=eeb1d0596d12ab9a036373e3e3ca726f" alt="" width="2298" height="474" data-path="images/help-center/articles/15516182/5dae1c82d009-image.png" />
</Frame>

6\. Klicken Sie auf **Save**

<h3 id="h_create_rule">
  Workflow Rule erstellen
</h3>

1\. Klicken Sie oben rechts auf das **Zahnradsymbol** und gehen Sie dann zu **Automation > Workflow Rules**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/801053f501d3-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bcca196dfb6b5f1365ed0d7a3ded13f5" alt="" width="2856" height="1114" data-path="images/help-center/articles/15516182/801053f501d3-image.png" />
</Frame>

2\. Klicken Sie auf **Create Rule**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5ef19e32b2ee-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c3e2c947e6af57bfcdc914cca28bf0de" alt="" width="2850" height="874" data-path="images/help-center/articles/15516182/5ef19e32b2ee-image.png" />
</Frame>

<Warning>
  **Hinweis:** Webhooks sind ab der Zoho CRM Professional Edition verfügbar.
</Warning>

3\. Konfigurieren Sie die Regel:

* Wählen Sie das **Modul** (z. B. Contacts oder Leads) und geben Sie der Regel einen Namen

* Legen Sie den **Trigger** fest (z. B. ein Datensatz wird erstellt, ein Feld wird geändert)

* Fügen Sie **Bedingungen** hinzu, um Datensätze zu filtern (z. B. Telefonfeld ist nicht leer)

* Fügen Sie unter **Instant Actions** hinzu: **Webhook > CloudTalk VoiceAgent**

4\. Klicken Sie auf **Save** und aktivieren Sie die Regel anschließend mit **Activate**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/51a5a32cd713-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c7d4b1550da7b824c867024705ed11b0" alt="" width="2016" height="1258" data-path="images/help-center/articles/15516182/51a5a32cd713-image.png" />
</Frame>

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

1. Erstellen oder aktualisieren Sie einen Contact, der Ihre Trigger-Bedingungen erfüllt

2. Gehen Sie zu **Zahnradsymbol > Automation > Workflow Rules**, wählen Sie Ihre Regel aus und klicken Sie auf **View Usage**, um die Ausführung zu prüfen

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

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

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

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

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

Wenn der VoiceAgent-Anruf nicht zustande kam, gehen Sie zu **View Usage** und klicken Sie auf **Failures**. Suchen Sie Ihren Datensatz und prüfen Sie die Spalte **Reason For Failures**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/f6fcd150ee27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=186290eea2a7b0d1b57b663a9c28e4dd" alt="" width="2828" height="1232" data-path="images/help-center/articles/15516182/f6fcd150ee27-image.png" />
</Frame>

| **Fehler** | **Was Sie prüfen sollten** |
| - | - |
| **Autorisierung** | Falsche CloudTalk-API-Zugangsdaten im Webhook – generieren Sie sie neu und tragen Sie sie erneut ein |
| **Telefonformat** | Stellen Sie sicher, dass die Nummer im E.164-Format vorliegt (`+1234567890`) |
| **Falsche VoiceAgent-ID** | Prüfen Sie, ob die `voice_agent_id` im Webhook-Body korrekt ist |
| **Webhook wurde nicht ausgelöst** | Prüfen Sie, ob die Workflow-Regel aktiv ist und ihre Bedingungen erfüllt wurden |

***

Brauchen Sie Hilfe oder haben Sie eine Frage? Melden Sie sich ü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 Zoho Desk auslösen](/de/articles/15442851-triggering-a-voiceagent-call-from-zoho-desk.md)
- [VoiceAgent-Anruf aus Freshworks CRM auslösen](/de/articles/15477534-triggering-a-voiceagent-call-from-freshworks-crm.md)
- [VoiceAgent-Anruf über Zapier auslösen](/de/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)


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