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

> VoiceAgent-Anrufe direkt aus Zoho Desk-Workflows automatisieren

<Note>
  Sie können einen CloudTalk VoiceAgent-Anruf direkt aus den Automation Rules in Zoho Desk automatisch auslösen. Diese Anleitung zeigt Ihnen, wie Sie eine Custom Function erstellen, sie mit einer Workflow-Regel verknüpfen und überprüfen, ob Anrufe korrekt initiiert werden.
</Note>

**Benutzerebene**: Admin

***

<h2 id="h_583de41e15">
  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) — zu finden unter **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))

* Ein Zoho Desk-Konto mit Zugriff auf Automation

* Kontaktdatensätze mit Telefonnummern

<h2 id="h_145e880437">
  Autorisierungs-Header generieren
</h2>

CloudTalk verwendet Basic Authentication für API-Anfragen. So generieren Sie Ihren codierten Wert:

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 Header. Er sieht etwa so aus: `Basic XXXXXXXXX`

Diesen Wert verwenden Sie im Skript der Custom Function weiter unten.

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

<h3 id="h_d35cb3411c">
  Custom Function erstellen
</h3>

1\. Gehen Sie zu **Setup > Developer Space > Custom Functions**

2\. Klicken Sie auf **New Function**

3\. Konfigurieren Sie die Funktion:

* **Function Name:** CloudTalk VoiceAgent

* **Module:** Wählen Sie das Modul aus, das den Anruf auslösen soll (z. B. Contacts, Tickets)

4\. Fügen Sie unter **Argument Mapping** Folgendes hinzu:

* **Argument Name:** `phoneNumber` > **Select Field:** Contact Phone (oder das entsprechende Telefonfeld Ihres Moduls)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/f7b454104051-screenshot-2026-06-08-at-15-17-51.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=cfc3d5d04d921cb621be8e03dc85ae6f" alt="" width="2068" height="1234" data-path="images/help-center/articles/15442851/f7b454104051-screenshot-2026-06-08-at-15-17-51.png" />
</Frame>

5\. Fügen Sie das folgende Skript in den Editor **Function Script** ein:

```
phoneVal = phoneNumber;
agentId = "YOUR_VOICE_AGENT_ID";
jsonBody = '{"call_number":"' + phoneVal + '","voice_agent_id":"' + agentId + '"}';

headers = Map();
headers.put("Authorization","Basic XXXXXXXXX");
headers.put("Content-Type","application/json");

response = invokeurl
[
    url: "https://api.cloudtalk.io/v1/voice-agent/calls"
    type: POST
    parameters: jsonBody
    headers: headers
];

info response;
```

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/bfcf2a7d44d3-screenshot-2026-06-08-at-15-18-12.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1beb14b5d1aa22ae780946174f885432" alt="" width="2060" height="1230" data-path="images/help-center/articles/15442851/bfcf2a7d44d3-screenshot-2026-06-08-at-15-18-12.png" />
</Frame>

Ersetzen Sie `YOUR_VOICE_AGENT_ID` durch Ihre tatsächliche VoiceAgent-ID und `XXXXXXXXX` durch Ihre Base64-codierten Zugangsdaten aus dem vorherigen Schritt.

<Tip>
  `call_number` und `voice_agent_id` sind die einzigen Pflichtfelder. Optional können Sie weitere `call_properties` übergeben, etwa Variablen für den System-Prompt oder Ausgabevariablen – je nach Konfiguration Ihres VoiceAgent. [Erfahren Sie, was Sie einbeziehen können](/de/articles/11401649-voiceagents-for-outbound-calls).
</Tip>

6\. Klicken Sie auf **Save Script** und anschließend auf **Save.**

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

1. Gehen Sie zu **Setup > Automation > Workflow Rules**

2. Klicken Sie auf **New Rule** und wählen Sie dasselbe Modul aus, das Sie in Schritt 1 gewählt haben

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/f2490da4deee-screenshot-2026-06-08-at-15-17-27.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a833428c1a45abed512a500c62a44f1c" alt="" width="2932" height="1438" data-path="images/help-center/articles/15442851/f2490da4deee-screenshot-2026-06-08-at-15-17-27.png" />
   </Frame>

3\. Legen Sie das auslösende Ereignis fest, zum Beispiel:

* Kontakt erstellt

* Ticketstatus auf Open geändert

4**. Optional:** Fügen Sie Bedingungen hinzu, um einzugrenzen, welche Datensätze den Anruf auslösen (z. B. Telefonfeld ist nicht leer, bestimmte Abteilung)

5\. Wählen Sie unter **Actions** die Option **Custom Function > CloudTalk VoiceAgent**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/3474f1a58059-screenshot-2026-06-08-at-15-17-38.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1eefb6c3c83bb50c99b88ccc67e177bf" alt="" width="2928" height="1348" data-path="images/help-center/articles/15442851/3474f1a58059-screenshot-2026-06-08-at-15-17-38.png" />
</Frame>

6\. Speichern und aktivieren Sie die Regel

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

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

2. Gehen Sie zu **Setup > Automation > Workflow Rules**, öffnen Sie Ihre Regel und prüfen Sie die **Logs**

3. Bestätigen Sie in CloudTalk, dass der VoiceAgent-Anruf initiiert wurde

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

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

  *Damit keine Fehler oder Drosselungen auftreten, achten Sie darauf, dass Ihre Zoho Desk-Automatisierung die Anrufverteilung sorgfältig steuert. Nutzen Sie bei Bedarf Verzögerungen oder eine Zeitplanung, denn für den VoiceAgent-Endpunkt gilt das Standard-API-Ratenlimit (60 Anfragen pro Minute).*
</Info>

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

<Warning>
  Bevor Sie sich mit einzelnen Fehlern befassen, prüfen Sie, ob Ihre Automation Rule aktiviert ist und ob ein Testdatensatz die Auslösebedingungen tatsächlich erfüllt.
</Warning>

| **Fehler** | **Mögliche Ursache** | **Lösung** |
| - | - | - |
| `401 Unauthorized` | Ungültige oder abgelaufene Zugangsdaten | Generieren Sie den `Autorisierung`-Header neu und aktualisieren Sie ihn in Ihrer Custom Function |
| `400 Bad Request` | Falsch formatierte Telefonnummer | Stellen Sie sicher, dass die Telefonnummer im E.164-Format vorliegt (z. B. `+1234567890`) |
| Regel wird nicht ausgelöst | Regel ist deaktiviert oder die Auslösebedingungen treffen nicht zu | Prüfen Sie, ob die Regel aktiv ist und ob der Datensatz alle Bedingungen 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 Zoho CRM auslösen](/de/articles/15516182-triggering-a-voiceagent-call-from-zoho-crm.md)
- [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)


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