Skip to main content
In dieser Anleitung erfahren Sie, wie Sie mit Automation Rules automatisch einen CloudTalk VoiceAgent-Anruf aus Freshdesk auslösen. Die Aktion Trigger Webhook gibt Ihnen volle Kontrolle über HTTP-Methode, URL, Header und Body, sodass Anrufe direkt aus Ticket-Ereignissen gestartet werden können.
Benutzerebene: Administrator

​
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 Freshdesk Pro-Tarif oder höher
  • Eine Telefonnummer, die in den Contact-Datensätzen verfügbar ist

​
Authorization-Header generieren

CloudTalk verwendet für API-Anfragen Basic Authentication.
  1. Öffnen Sie 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
Hinweis: Freshdesk akzeptiert in der Webhook-Konfiguration auch eine einfache Kombination aus Benutzername und Passwort, der Base64-codierte Header ist also optional. Beide Wege funktionieren.

​
Integration einrichten

​
Automation Rule erstellen

1. Gehen Sie in Freshdesk zu Admin > Automation > Ticket Creation (oder On Ticket Update, je nachdem, wann die Anrufe ausgelöst werden sollen)
2. Klicken Sie auf Start from scratch 3. Legen Sie Ihre Bedingungen fest, zum Beispiel:
  • Ticket is created
  • Contact phone is present
  • Tag contains voiceagent
4. Klicken Sie unter Actions auf Add action > Trigger Webhook 5. Konfigurieren Sie den Webhook:
6. Fügen Sie unter Custom Headers Folgendes hinzu:
  • Authorization > Basic XXXXXXXXX
  • Content-Type > application/json
7. Fügen Sie unter Content (Advanced) den folgenden Body ein:
call_number und voice_agent_id sind die einzigen Pflichtfelder. Je nach Konfiguration Ihres VoiceAgent können Sie auch optionale call_properties übergeben, etwa Variablen des System-Prompts und Ausgabevariablen. Erfahren Sie, was Sie angeben können
8. Klicken Sie auf Preview and save und aktivieren Sie dann die Regel.

​
Testen und überprüfen

  1. Erstellen oder aktualisieren Sie ein Ticket, das Ihren Auslösebedingungen entspricht
  2. Gehen Sie zu Admin > Automation und prüfen Sie das Ausführungsprotokoll der Regel
  3. Prüfen Sie in CloudTalk, ob der VoiceAgent-Anruf gestartet wurde
Fertig! 🚀 Ihre Freshdesk-Automatisierungsregel löst jetzt einen CloudTalk VoiceAgent-Anruf aus, sobald ein Ticket Ihre gewählten Bedingungen erfüllt.
💡 API-Limits, die Sie beachten solltenDamit keine Fehler oder Drosselungen auftreten, sollte Ihre Freshdesk-Automatisierung die Verteilung der Anrufe sorgfältig steuern. Nutzen Sie bei Bedarf Verzögerungen oder eine zeitliche Planung, denn für den VoiceAgent-Endpunkt gilt das Standard-API-Ratenlimit (60 Anfragen pro Minute).

​
Fehlerbehebung

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