Skip to main content
In dieser Anleitung erfahren Sie, wie Sie mit dem Workflow Automator automatisch einen CloudTalk VoiceAgent-Anruf aus Freshservice auslösen.
Benutzerebene: Administrator
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.

​
Bevor Sie beginnen

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)
  • Einen Freshservice Pro plan oder höher
  • Eine Telefonnummer, die in den Requester-Datensätzen hinterlegt ist

​
CloudTalk-Zugangsdaten finden

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

​
Integration einrichten

​
Workflow erstellen

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
4. Fügen Sie Bedingungen hinzu, um zu filtern, welche Tickets den Anruf auslösen (z. B. Telefonnummer des Requesters vorhanden, bestimmte Kategorie)

​
Web Request Node hinzufügen

1. Klicken Sie auf +, um einen Aktionsblock hinzuzufügen 2. Wählen Sie Web Request Node 3. Konfigurieren Sie den Node: 4. Fügen Sie unter Request body Folgendes ein:
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
5. Verbinden Sie den Node mit dem Trigger und klicken Sie auf Activate

​
Testen und überprüfen

  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.
💡 API-Limits, die Sie beachten solltenDamit 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.

​
Fehlerbehebung

Sie brauchen Hilfe oder haben eine Frage? Wenden Sie sich an unser Support-Portal. Wir sind für Sie da.