Een VoiceAgent-oproep starten vanuit Zapier

• Admin

​

CloudTalk VoiceAgents in Zapier

​

Vereisten

• CloudTalk API-inloggegevens
  • Ga naar CloudTalk Dashboard → Account → Instellingen → API-sleutels
  • Kopieer zowel de API Key ID als de API Key Secret
• VoiceAgent-ID
  • De VoiceAgent-ID kunt u ophalen via het CloudTalk Dashboard > VoiceAgents
  

​

Instructies voor het instellen

1. Voeg in de Zap van uw keuze een stap Actie toe en kies Webhooks by Zapier.
2. Kies Custom Request als actiegebeurtenis.
3. Selecteer bij Methode POST
4. Gebruik voor het API-eindpunt deze URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. Configureer in Data de body van het verzoek volgens de API-documentatie
   • Maak een JSON-payload met de volgende opmaak:
     {
     "call_number": "#{{phone_number}}",
     "voice_agent_id": "#{{voice_agent_id}}",
     "call_properties": {
     "system_prompt": {
     "variables": {
     "contact_name": "#{{name}}"
     }
     },
     "output": {
     "variables": {
     "custom_field": "value"
     }
     }
     }
     }
     
   • Vervang de variabelen (#{{...}}) door gegevens uit eerdere stappen in uw scenario.
   • Voeg in call_number een verwijzing toe naar het telefoonnummer (e.164) dat gebeld moet worden, opgehaald uit eerdere stappen.
   • Voeg in voice_agent_id de ID van de VoiceAgent in die u in het CloudTalk Dashboard hebt opgehaald.
   • Configureer indien nodig call_properties, waarbij:
     1. De gegevens in call_properties.system_prompt.variables verzoekspecifieke informatie bevatten die de VoiceAgent tijdens het gesprek moet gebruiken (bijvoorbeeld de naam van het contact).
     2. De gegevens in call_properties.output.variables bepalen welke waarden de VoiceAgent na het gesprek aan het externe eindpunt moet doorgeven, naast de informatie die tijdens het gesprek is verzameld.