VoiceAgent-Anruf über Make auslösen

• Admin

​

CloudTalk VoiceAgents in Make

​

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
    

​

Einrichtungsschritte

1. Fügen Sie in Ihrem Make-Szenario ein Modul hinzu und wählen Sie die App HTTP Request aus.
2. Wählen Sie die Aktion Make a basic auth request aus.
3. Konfigurieren Sie die Authentifizierung
   • Klicken Sie auf Hinzufügen, um neue Zugangsdaten zu erstellen.
   • Verwenden Sie Ihre API Key ID als Benutzernamen.
   • Verwenden Sie Ihr API Key Secret als Passwort.
   • Geben Sie der Verbindung einen Namen und klicken Sie auf Erstellen.
4. Verwenden Sie als API-Endpunkt diese URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. Wählen Sie als Methode POST aus
6. Konfigurieren Sie das Format der Anfrage
   • Body type: Raw
   • Content type: application/json
7. Erstellen Sie den Request content 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 haben.
   • 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 ermittelten Informationen – an den externen Endpunkt übergeben soll.