Acionar uma chamada do VoiceAgent a partir do Make

• Admin

​

VoiceAgents da CloudTalk no Make

​

Pré-requisitos

• Credenciais da API da CloudTalk
  • Aceda a Dashboard da CloudTalk → Conta → Definições → Chaves da API
  • Copie o API Key ID e o API Key Secret
• ID do VoiceAgent
  • O ID do VoiceAgent pode ser obtido no Dashboard > VoiceAgents da CloudTalk
    

​

Instruções de configuração

1. No seu cenário do Make, adicione um módulo e selecione a aplicação HTTP Request .
2. Selecione a ação Make a basic auth request.
3. Configure a autenticação
   • Clique em Adicionar para criar novas credenciais.
   • Utilize o seu API Key ID como Username.
   • Utilize o seu API Key Secret como Password.
   • Atribua um nome à ligação e clique em Criar.
4. Para o endpoint da API, utilize este URL:
   https://api.cloudtalk.io/v1/voice-agent/calls
5. Em Método, selecione POST
6. Configure o formato do pedido
   • Body type: Raw
   • Content type: application/json
7. Construa o Request content seguindo a documentação da API
   • Crie um payload JSON com o seguinte formato:
     {
       "call_number": "#{{phone_number}}",
       "voice_agent_id": "#{{voice_agent_id}}",
       "call_properties": {
         "system_prompt": {
           "variables": {
             "contact_name": "#{{name}}"
           }
         },
         "output": {
           "variables": {
             "custom_field": "value"
           }
         }
       }
     }
     
   • Substitua as variáveis (#{{...}}) por dados de passos anteriores do seu cenário.
   • Em call_number, insira uma referência ao número de telefone (e.164) a contactar, extraído de passos anteriores.
   • Em voice_agent_id, insira o ID do VoiceAgent obtido no Dashboard da CloudTalk.
   • Se necessário, configure call_properties, em que:
     1. Os dados em call_properties.system_prompt.variables incluem informação específica do pedido que o VoiceAgent deve utilizar durante a chamada (por exemplo, o nome do contacto).
     2. Os dados em call_properties.output.variables definem os valores que o VoiceAgent deve enviar para o endpoint externo após a chamada, além da informação extraída durante a conversa.