Een VoiceAgent-oproep activeren vanuit Make

• Admin

​

CloudTalk VoiceAgents in Make

​

Vereisten

• CloudTalk API-inloggegevens
  • Ga naar CloudTalk Dashboard → Account → Instellingen → API-sleutels
  • Kopieer zowel de API-sleutel-ID als het API-sleutel-secret
• VoiceAgent-ID
  • De VoiceAgent-ID haalt u op in het CloudTalk Dashboard > VoiceAgents
    

​

Zo stelt u het in

1. Voeg in uw Make-scenario een module toe en selecteer de HTTP Request app.
2. Selecteer de Make a basic auth request actie.
3. Configureer de authenticatie
   • Klik op Toevoegen om nieuwe inloggegevens aan te maken.
   • Gebruik uw API-sleutel-ID als gebruikersnaam.
   • Gebruik uw API-sleutel-secret als wachtwoord.
   • Geef de verbinding een naam en klik op Aanmaken.
4. Gebruik voor het API-eindpunt deze URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. Selecteer bij Methode POST
6. Configureer het formaat van het verzoek
   • Body type: Raw
   • Content type: application/json
7. Stel de Request content samen volgens de API-documentatie
   • Maak een JSON-payload met de volgende indeling:
     {
       "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 in 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 de oproep moet gebruiken (bijvoorbeeld de naam van het contact).
     2. De gegevens in call_properties.output.variables bepalen welke waarden de VoiceAgent na de oproep aan het externe eindpunt moet doorgeven, naast de informatie die tijdens het gesprek is verzameld.