Skip to main content
Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Pipedrive, através da funcionalidade Automations.
Nível de utilizador: Admin

​
Antes de começar

Vai precisar de:
  • Um VoiceAgent da CloudTalk já criado (anote o ID do VoiceAgent)
  • Credenciais da API da CloudTalk (ID da Chave da API e Segredo da Chave da API)
  • Pipedrive plano Advanced ou superior (as Automations com ações de webhook exigem Advanced+)
  • Um número de telefone disponível nos registos Person ou Deal

​
Configurar a integração

​
Criar o Automation webhook

Nota: apenas os utilizadores com perfil de administrador global podem criar webhooks. Os webhooks normais já existentes não podem ser reutilizados nas Automations, por isso tem de criar especificamente um Automation webhook.
1. No Pipedrive, clique no seu ícone de perfil e selecione Tools and Apps
2. Clique em + Webhook e selecione Automation webhook
3. Configure o webhook:
  • Name: CloudTalk VoiceAgent
  • Endpoint URL: https://api.cloudtalk.io/v1/voice-agent/calls?
  • Authentication, Username: o ID da Chave da API da CloudTalk
  • Authentication, Password: o Segredo da Chave da API da CloudTalk
Porque é que o URL termina com ?? O Pipedrive exige que os URL dos Automation webhooks terminem com /, &, ? ou =. O ? é o único que a API da CloudTalk aceita. Abre uma query string vazia que a CloudTalk ignora, pelo que o pedido continua a chegar ao endpoint correto. Os restantes caracteres são interpretados como parte do caminho do URL, o que quebra o pedido.
4. Clique em Save

​
Criar a automação

1. Aceda a Tools and Apps > Automations 2. Clique em + Automation 3. Selecione um acionador, por exemplo:
  • Deal stage changed
  • Person created or updated
  • Activity completed
4. Adicione as condições necessárias (por exemplo, executar apenas numa fase específica do pipeline) 5. Clique em + Add action e selecione Webhook

​
Configurar a ação Webhook

1. No campo Webhook, selecione CloudTalk VoiceAgent (o webhook que criou no Passo 1) 2. Defina Method como POST 3. Na secção Body, mude para Raw e introduza:
Para call_number, utilize o botão de seleção de campos para escolher Person > Phones. Introduza o ID do seu VoiceAgent como valor de voice_agent_id.
call_number e voice_agent_id são os únicos campos obrigatórios. Também pode enviar call_properties opcionais, como variáveis do system prompt e variáveis de saída, consoante a configuração do seu VoiceAgent. Saiba o que incluirCertifique-se de que o número de telefone está guardado no formato E.164 (+1234567890); caso contrário, a CloudTalk rejeita o pedido.
Contactos com vários números de telefone: o campo Person Phones do Pipedrive pode conter vários números. Quando um contacto tem mais do que um, o campo envia todos eles para a CloudTalk em vez de um único número, o que torna o pedido inválido e faz a chamada falhar. Solução alternativa: crie um campo personalizado de telefone dedicado, de valor único (Settings > Data fields > Person), guarde nele apenas o número a marcar em formato E.164 e mapeie esse campo para call_number.

​
Ativar e testar

  1. Guarde e ative a automação
  2. Acione manualmente a condição com um registo de teste (por exemplo, mova um deal para a fase pretendida)
  3. Aceda a Automations > History e confirme que a ação foi executada com o estado SUCCESS
  4. Confirme na CloudTalk que a chamada do VoiceAgent foi iniciada
Está tudo pronto! 🚀 A sua automação do Pipedrive passa a acionar uma chamada do VoiceAgent da CloudTalk sempre que um registo cumprir as condições que definiu.
💡 Limites da API a ter em contaPara evitar falhas ou limitações de tráfego, certifique-se de que a sua automação distribui as chamadas com cuidado. Utilize atrasos ou lógica de agendamento sempre que for necessário, uma vez que o limite padrão de pedidos à API (60 pedidos por minuto) se aplica ao endpoint do VoiceAgent.

​
Resolução de problemas

Se a chamada do VoiceAgent não foi iniciada:
  1. Aceda a Automations > History
  2. Selecione o filtro Failed
  3. Abra a execução falhada para ver qual foi o passo que falhou
Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso Portal de Suporte. Estamos aqui para si.