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

> Ausgehende VoiceAgent-Anrufe direkt aus Freshservice automatisieren

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

**Benutzerebene**: Administrator

***

<Warning>
  **Hinweis:** Verwenden Sie den **Web Request Node**, nicht den Trigger Webhook Node. Der Web Request Node wartet auf die API-Antwort und unterstützt das Parsen von JSON-Antworten, sodass Sie Fehler abfangen können. Der Trigger Webhook Node sendet die Anfrage lediglich ab und bestätigt keinen Erfolg.
</Warning>

<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), 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 Freshservice **Pro plan** oder höher

* Eine Telefonnummer, die in den Requester-Datensätzen hinterlegt ist

<h2 id="h_credentials">
  CloudTalk-Zugangsdaten finden
</h2>

Der Web Request Node verfügt über ein integriertes Basic-Auth-Formular, daher ist keine vorherige Kodierung nötig.

1. Gehen Sie in CloudTalk zu **Unternehmenseinstellungen > Integrationen > API**

2. Notieren Sie sich Ihre **API Key ID** -- diese wird der Username sein

3. Notieren Sie sich Ihr **API Secret** -- dieses wird das Password sein

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

<h3 id="h_create_workflow">
  Workflow erstellen
</h3>

1\. Gehen Sie in Freshservice zu **Admin > Workflow Automator**

2\. Klicken Sie auf **Create > Workflow**

3\. Legen Sie den **Event trigger** fest, zum Beispiel:

* *Ticket raised*

* *Ticket updated* (Status wechselt zu Pending)

* *Requester replies*

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/cfe5ebee1bfc-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=256f95008b25fbab2b0b2bbe4c572d8c" alt="" width="583" height="361" data-path="images/help-center/articles/15502021/cfe5ebee1bfc-image.png" />
</Frame>

4\. Fügen Sie **Bedingungen** hinzu, um zu filtern, welche Tickets den Anruf auslösen (z. B. Telefonnummer des Requesters vorhanden, bestimmte Kategorie)

<h3 id="h_web_request">
  Web Request Node hinzufügen
</h3>

1\. Klicken Sie auf **`+`**, um einen Aktionsblock hinzuzufügen

2\. Wählen Sie **Web Request Node**

3\. Konfigurieren Sie den Node:

| **Feld** | **Wert** |
| - | - |
| Request type | POST |
| Endpoint | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Credentials | Inline Credential |
| Authentication | Basic Auth |
| Username | Ihre CloudTalk API Key ID |
| Password | Ihr CloudTalk API Secret |
| Headers | `Content-Type`: `application/json` |

4\. Fügen Sie unter **Request body** Folgendes ein:

```json theme={"system"}
{  "call_number": "#{{ticket.requester.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 zusätzlich 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/15502021/bd0f895867f5-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=ab3441168ef857eb20660f388de7dc13" alt="" width="581" height="685" data-path="images/help-center/articles/15502021/bd0f895867f5-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/f00064942f5b-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6d8c792ec9cf6d9a0fa081cb3da4045a" alt="" width="561" height="608" data-path="images/help-center/articles/15502021/f00064942f5b-image.png" />
</Frame>

5\. Verbinden Sie den Node mit dem Trigger und klicken Sie auf **Activate**

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

1. Erstellen oder aktualisieren Sie ein Ticket, das Ihre Trigger-Bedingungen erfüllt

2. Öffnen Sie den **Workflow Automator** und prüfen Sie den Ausführungsverlauf

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

**Fertig!** 🚀 Ihr Freshservice-Workflow löst nun einen CloudTalk VoiceAgent-Anruf aus, sobald ein Ticket Ihre gewählten Bedingungen erfüllt.

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

  *Damit es nicht zu Fehlern oder Drosselungen kommt, sollte Ihr Workflow die Anrufverteilung sorgfältig steuern. Setzen Sie bei Bedarf Verzögerungen oder eine Zeitplanungslogik ein, da für den VoiceAgent-Endpunkt das Standard-Ratenlimit der API (60 Anfragen pro Minute) gilt.*
</Info>

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

| **Fehler** | **Was zu prüfen ist** |
| - | - |
| **401 Unauthorized** | Generieren Sie Ihre API-Zugangsdaten neu und tragen Sie sie erneut in die Basic-Auth-Felder ein |
| **400 Bad Request** | Stellen Sie sicher, dass die Telefonnummer im E.164-Format vorliegt (`+1234567890`) und dass `voice_agent_id` korrekt ist |
| **Workflow wird nicht ausgelöst** | Prüfen Sie, ob die Ereignisbedingungen zu Ihrem Testticket passen und ob 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 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 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.