VoiceAgent-Anruf über Zapier auslösen

• Admin

​

CloudTalk VoiceAgents in Zapier

​

Voraussetzungen

• CloudTalk API-Zugangsdaten
  • Gehen Sie zu CloudTalk Dashboard → Konto → Einstellungen → API-Schlüssel
  • Kopieren Sie sowohl die API Key ID als auch das API Key Secret
• VoiceAgent-ID
  • Die VoiceAgent-ID finden Sie im CloudTalk Dashboard > VoiceAgents
  

​

Einrichtung

1. Fügen Sie in dem Zap Ihrer Wahl einen Action-Schritt hinzu und wählen Sie Webhooks by Zapier.
2. Wählen Sie Custom Request als Aktionsereignis.
3. Wählen Sie bei Method die Option POST
4. Verwenden Sie als API-Endpunkt diese URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. Konfigurieren Sie unter Data den Body der Anfrage gemäß der API-Dokumentation
   • Erstellen Sie eine JSON-Payload im folgenden Format:
     {
     "call_number": "#{{phone_number}}",
     "voice_agent_id": "#{{voice_agent_id}}",
     "call_properties": {
     "system_prompt": {
     "variables": {
     "contact_name": "#{{name}}"
     }
     },
     "output": {
     "variables": {
     "custom_field": "value"
     }
     }
     }
     }
     
   • Ersetzen Sie die Variablen (#{{...}}) durch Daten aus vorherigen Schritten Ihres Szenarios.
   • Fügen Sie in call_number einen Verweis auf die anzurufende Telefonnummer (e.164) ein, die aus vorherigen Schritten stammt.
   • Fügen Sie in voice_agent_id die ID des VoiceAgent ein, die Sie im CloudTalk Dashboard erhalten.
   • Konfigurieren Sie bei Bedarf call_properties, wobei gilt:
     1. Die Daten in call_properties.system_prompt.variables enthalten anfragespezifische Informationen, die der VoiceAgent während des Anrufs verwenden soll (z. B. den Namen des Kontakts).
     2. Die Daten in call_properties.output.variables legen fest, welche Werte der VoiceAgent nach dem Anruf zusätzlich zu den im Gespräch erfassten Informationen an den externen Endpunkt übergeben soll.