Triggering a VoiceAgent Call from Make

• Admin

​

CloudTalk VoiceAgents in Make

​

Prerequisites

• CloudTalk API Credentials
  • Go to CloudTalk Dashboard → Settings → API Keys
  • Copy both the API Key ID and API Key Secret
• VoiceAgent ID
  • VoiceAgent ID can be retrieved from Cloudtalk Dashboard > AI Voice Agents
    

​

Setup Instructions

1. In your Make scenario, add a module and select the HTTP Request app.
2. Select Make a basic auth request action.
3. Configure authentication
   • Click Add to create new credentials.
   • Use your API Key ID as the Username.
   • Use your API Key Secret as the Password.
   • Give the connection a name and click Create.
4. For API Endpoint use this URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. For Method select POST
6. Configure the request format
   • Body type: Raw
   • Content type: application/json
7. Build the Request content following API documentation
   • Create a JSON payload using the following format:
     {
       "call_number": "#{{phone_number}}",
       "voice_agent_id": "#{{voice_agent_id}}",
       "call_properties": {
         "system_prompt": {
           "variables": {
             "contact_name": "#{{name}}"
           }
         },
         "output": {
           "variables": {
             "custom_field": "value"
           }
         }
       }
     }
     
   • Replace the variables (#{{...}}) with data from earlier steps in your scenario.
   • In call_number, insert a reference to the phone number (e.164) to be called, extracted from previous steps.
   • In voice_agent_id, insert the ID of the VoiceAgent obtained from the CloudTalk Dashboard.
   • If necessary, configure call_properties, where:
     1. Data in call_properties.system_prompt.variables includes request-specific information the VoiceAgent should use during the call (e.g. the contact’s name).
     2. Data in call_properties.output.variables defines the values VoiceAgent should pass to the external endpoint after the call, in addition to information extracted during the conversation.
     

8. Double-check the configuration and save the module