Skip to main content
Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Zoho CRM utilizando Workflow Rules.
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 (Chave da API e Segredo) disponíveis em Definições da empresa > Integrações > API (Como aceder e gerar as suas Chaves da API da CloudTalk)
  • Zoho CRM com plano Professional ou superior
  • Um campo de telefone disponível nos registos Contact ou Lead

​
Gerar o cabeçalho Authorization

A CloudTalk utiliza autenticação Basic nos pedidos à API.
  1. Abra https://www.debugbear.com/basic-auth-header-generator
  2. Introduza a sua Chave da API da CloudTalk como Username e o seu Segredo da API como Password
  3. Copie o valor gerado. Tem este aspeto: Basic XXXXXXXXX

​
Configurar a integração

​
Criar o Webhook

1. No Zoho CRM, clique no ícone de engrenagem no canto superior direito e aceda a Automation > Actions > Webhooks
2. Clique em Configure Webhook
3. Preencha os detalhes do webhook:
4. Em Custom Headers, adicione:
  • Authorization → Basic XXXXXXXXX (o valor que gerou)
  • Content-Type → application/json
5. Em Body, defina Type como Raw e Format como JSON e, em seguida, cole:
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 incluir
6. Clique em Save

​
Criar a Workflow Rule

1. Clique no ícone de engrenagem no canto superior direito e aceda a Automation > Workflow Rules
2. Clique em Create Rule
Nota: Os webhooks estão disponíveis a partir da edição Professional do Zoho CRM.
3. Configure a regra:
  • Selecione o módulo (por exemplo, Contacts ou Leads) e atribua um nome à regra
  • Defina o acionador (por exemplo, um registo é criado, um campo é modificado)
  • Adicione condições para filtrar registos (por exemplo, o campo de telefone não está vazio)
  • Em Instant Actions, adicione: Webhook > CloudTalk VoiceAgent
4. Clique em Save e, em seguida, em Activate para ativar a regra

​
Testar e verificar

  1. Crie ou atualize um Contact que cumpra as condições do seu acionador
  2. Aceda a ícone de engrenagem > Automation > Workflow Rules, selecione a sua regra e clique em View Usage para verificar a execução
  3. Confirme na CloudTalk que a chamada do VoiceAgent foi iniciada
Está tudo pronto! 🚀 O seu fluxo de trabalho do Zoho CRM 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, certifique-se de que o seu fluxo de trabalho distribui as chamadas com cuidado. Utilize atrasos ou lógica de agendamento sempre que 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 tiver sido efetuada, aceda a View Usage e clique em Failures. Localize o seu registo e consulte a coluna Reason For Failures.
Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso portal de Suporte. Estamos aqui para si.