Skip to main content
Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Freshworks CRM (Freshsales) através das automações de fluxo de trabalho.
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 Secret) disponíveis em Definições da empresa > Integrações > API (Como aceder e gerar as suas Chaves da API da CloudTalk)
  • Um plano Growth ou superior no Freshworks CRM
  • Um número de telefone disponível nos registos de Contact

​
Gerar o cabeçalho Authorization

A CloudTalk utiliza Basic Authentication 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 API Secret como Password
  3. Copie o valor gerado. Tem este aspeto: Basic XXXXXXXXX
Nota: o Freshworks CRM também aceita uma combinação simples de username/password diretamente na configuração do webhook, pelo que o cabeçalho codificado em Base64 é opcional. Qualquer uma das abordagens funciona.

​
Configurar a integração

​
Criar a automação do fluxo de trabalho

1. No Freshworks CRM, aceda a Admin Settings > Teams & Territories > Workflows 2. Clique em Create your own workflow 3. Escolha o módulo: Contacts (ou Accounts / Deals)
4. Defina o evento de acionamento, por exemplo:
  • Contact is created
  • Field is updated (p. ex., o estado muda para “Interested”)
5. Adicione condições para filtrar que registos acionam a chamada (p. ex., existe um número de telemóvel)

​
Adicionar a ação Webhook

1. Em Actions, clique em Add Action > Webhook 2. Configure o webhook:
3. Em Request body (Advanced), cole o seguinte:
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
4. Clique em Save e depois em Enable para ativar o fluxo de trabalho.

​
Testar e verificar

  1. Crie ou atualize um Contact que cumpra as suas condições de acionamento
  2. Aceda a Admin Settings > Automations > Workflow logs e verifique o estado da execução
  3. Confirme na CloudTalk que a chamada do VoiceAgent foi iniciada
Está tudo pronto! 🚀 O seu fluxo de trabalho no Freshworks CRM passa agora a acionar uma chamada do VoiceAgent da CloudTalk sempre que um contacto cumprir as condições escolhidas.
💡 Limites da API a ter em contaPara evitar falhas ou limitações de tráfego, certifique-se de que o seu fluxo de trabalho no Freshworks CRM 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

Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso Portal de Suporte. Estamos aqui para