Skip to main content
Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Freshdesk utilizando Regras de Automação. A ação Trigger Webhook dá-lhe controlo total sobre o método HTTP, o URL, os cabeçalhos e o corpo do pedido, para que as chamadas possam ser iniciadas diretamente a partir de eventos de tickets.
Nível de utilizador: Administrador

​
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 chaves da API da CloudTalk)
  • Um plano Pro do Freshdesk ou superior
  • Um número de telefone disponível nos registos de contacto

​
Gerar o cabeçalho Authorization

A CloudTalk utiliza autenticação Basic para os 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
Nota: O Freshdesk também aceita uma combinação simples de nome de utilizador e palavra-passe na configuração do webhook, pelo que o cabeçalho codificado em Base64 é opcional. Ambas as abordagens funcionam.

​
Configurar a integração

​
Criar a Regra de Automação

1. No Freshdesk, aceda a Admin > Automation > Ticket Creation (ou On Ticket Update, consoante o momento em que pretende acionar as chamadas)
2. Clique em Start from scratch 3. Defina as suas condições, por exemplo:
  • Ticket is created
  • Contact phone is present
  • Tag contains voiceagent
4. Em Actions, clique em Add action > Trigger Webhook 5. Configure o webhook:
6. Em Custom Headers, adicione:
  • Authorization > Basic XXXXXXXXX
  • Content-Type > application/json
7. Em Content (Advanced), cole o seguinte corpo:
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
8. Clique em Preview and save e, em seguida, ative a regra.

​
Testar e verificar

  1. Crie ou atualize um ticket que corresponda às suas condições de acionamento
  2. Aceda a Admin > Automation e consulte o registo de execução da regra
  3. Confirme na CloudTalk que a chamada do VoiceAgent foi iniciada
Está tudo pronto! 🚀 A sua regra de automação do Freshdesk passa agora a acionar uma chamada do VoiceAgent da CloudTalk sempre que um ticket cumprir as condições que definiu.
💡 Limites da API a ter em contaPara evitar falhas ou limitações, certifique-se de que a sua automação no Freshdesk gere a distribuição das chamadas de forma cuidadosa. 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 Apoio. Estamos aqui para si.