Skip to main content
Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Freshservice através do Workflow Automator.
Nível de utilizador: Administrador
Nota: Utilize o Web Request Node e não o nó Trigger Webhook. O Web Request Node aguarda a resposta da API e suporta a análise de respostas JSON, o que lhe permite detetar erros. O nó Trigger Webhook funciona em modo «enviar e esquecer» e não confirma o êxito.

​
Antes de começar

Vai precisar de:
  • Um VoiceAgent da CloudTalk já criado (tome nota do 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)
  • Um plano Pro do Freshservice ou superior
  • Um número de telefone disponível nos registos de Requester

​
Localize as suas credenciais da CloudTalk

O Web Request Node tem um formulário de Basic Auth integrado, pelo que não é necessária qualquer codificação prévia.
  1. Na CloudTalk, aceda a Definições da empresa > Integrações > API
  2. Tome nota do seu ID da Chave da API — este será o Username
  3. Tome nota do seu Segredo da API — este será a Password

​
Configurar a integração

​
Criar o workflow

1. No Freshservice, aceda a Admin > Workflow Automator 2. Clique em Create > Workflow 3. Defina o Event trigger, por exemplo:
  • Ticket raised
  • Ticket updated (o estado muda para Pending)
  • Requester replies
4. Adicione condições para filtrar quais os tickets que acionam a chamada (por exemplo, o telefone do Requester está preenchido, uma categoria específica)

​
Adicionar o Web Request Node

1. Clique em + para adicionar um bloco de ação 2. Selecione Web Request Node 3. Configure o nó: 4. Em Request body, 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
5. Ligue o nó ao trigger e clique em Activate

​
Testar e verificar

  1. Crie ou atualize um ticket que cumpra as condições do seu trigger
  2. Abra o Workflow Automator e consulte o histórico de execuções
  3. Confirme na CloudTalk que a chamada do VoiceAgent foi iniciada
Está tudo pronto! 🚀 O seu workflow do Freshservice passa agora a acionar uma chamada do VoiceAgent da CloudTalk sempre que um ticket cumprir as condições escolhidas.
💡 Limites da API a ter em contaPara evitar falhas ou limitações, certifique-se de que o seu workflow gere a distribuição das chamadas com cuidado. Utilize atrasos ou lógica de agendamento sempre que necessário, uma vez que o limite padrão de pedidos da 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 si.