> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Acionar uma chamada do VoiceAgent a partir do Freshdesk

> Automatize chamadas do VoiceAgent diretamente a partir do Freshdesk

<Note>
  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.
</Note>

**Nível de utilizador**: Administrador

***

<h2 id="h_c4f65f76b0">
  Antes de começar
</h2>

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](/pt/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Um **plano Pro** do Freshdesk ou superior

* Um número de telefone disponível nos registos de contacto

<h2 id="h_e32b3b4cc1">
  Gerar o cabeçalho Authorization
</h2>

A CloudTalk utiliza autenticação Basic para os pedidos à API.

1. Abra [https://www.debugbear.com/basic-auth-header-generator](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`

<Warning>
  **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.
</Warning>

<h2 id="h_da76a54a08">
  Configurar a integração
</h2>

<h3 id="h_e02ace1232">
  Criar a Regra de Automação
</h3>

1\. No Freshdesk, aceda a **Admin > Automation > Ticket Creation** (ou **On Ticket Update**, consoante o momento em que pretende acionar as chamadas)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=5a7cc485d58bd1d956110794946f4af7" alt="" width="2936" height="1322" data-path="images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png" />
</Frame>

2\. Clique em **Start from scratch**

3\. Defina as suas **condições**, por exemplo:

* *Ticket is created*

* *Contact phone is present*

* *Tag contains* `voiceagent`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f883a536c594b5986ed2490dbcdb112" alt="" width="2926" height="1310" data-path="images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png" />
</Frame>

4\. Em **Actions**, clique em **Add action > Trigger Webhook**

5\. Configure o webhook:

| **Campo** | **Valor** |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88d12880285be17c78721cb9768b7c11" alt="" width="2926" height="1332" data-path="images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png" />
</Frame>

6\. Em **Custom Headers**, adicione:

* `Authorization` > `Basic XXXXXXXXX`

* `Content-Type` > `application/json`

7\. Em **Content (Advanced)**, cole o seguinte corpo:

```json theme={"system"}
{
  "call_number": "#{{ticket.contact.phone}}",
  "voice_agent_id": "YOUR_VOICE_AGENT_ID"
}
```

<Warning>
  `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](/pt/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=623092ba130f596b5667a223dc720089" alt="" width="2922" height="1316" data-path="images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png" />
</Frame>

8\. Clique em **Preview and save** e, em seguida, ative a regra.

<h3 id="h_9e07057933">
  Testar e verificar
</h3>

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.

<Info>
  💡 **Limites da API a ter em conta**

  *Para 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.*
</Info>

<h2 id="h_c94f683814">
  Resolução de problemas
</h2>

| Erro | O que verificar |
| - | - |
| **401 Unauthorized** | Volte a gerar e a introduzir o cabeçalho Authorization |
| **400 Bad Request** | Confirme que o número de telefone está no formato E.164 (`+1234567890`) e que o `voice_agent_id` está correto |
| **A regra não é acionada** | Confirme que todas as condições são cumpridas e que a regra está ativada |

***

Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso [Portal de Apoio](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). Estamos aqui para si.


## Related topics

- [Acionar uma chamada do VoiceAgent a partir do Zendesk](/pt/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)
- [Acionar uma chamada do VoiceAgent a partir do Freshservice](/pt/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
- [Acionar uma chamada do VoiceAgent a partir do Pipedrive](/pt/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.