> ## 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 Freshworks CRM

> Automatize chamadas de saída do VoiceAgent diretamente a partir do Freshworks CRM

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

**Nível de utilizador**: Admin

***

<h2 id="h_79a9f66077">
  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 Secret) disponíveis em **Definições da empresa > Integrações > API** ([Como aceder e gerar as suas Chaves da API da CloudTalk](/pt/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Um **plano Growth** ou superior no Freshworks CRM

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

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

A CloudTalk utiliza Basic Authentication nos 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 **API Secret** como Password

3. Copie o valor gerado. Tem este aspeto: `Basic XXXXXXXXX`

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

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

<h3 id="h_f1af3c1b59">
  Criar a automação do fluxo de trabalho
</h3>

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)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/4ed42b39df69-screenshot-2b2026-06-05-2bat-2b10-39-24.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=07b9b15294311943027b45315d1cfa2c" alt="" width="2938" height="1440" data-path="images/help-center/articles/15477534/4ed42b39df69-screenshot-2b2026-06-05-2bat-2b10-39-24.png" />
</Frame>

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)

<h3 id="h_f7ef74ca45">
  Adicionar a ação Webhook
</h3>

1\. Em **Actions**, clique em **Add Action > Webhook**

2\. Configure o webhook:

| Campo | Valor |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Authentication | Username / Password (Client ID / Client Secret) |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/8bcb703b957f-screenshot-2026-06-05-at-10-45-56.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=0aaef50a525a233f51bb969c28ba02a1" alt="" width="1616" height="1440" data-path="images/help-center/articles/15477534/8bcb703b957f-screenshot-2026-06-05-at-10-45-56.png" />
</Frame>

3\. Em **Request body (Advanced)**, cole o seguinte:

```json theme={"system"}
{   "call_number": "#{{contact.mobile_number}}",   "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>

4\. Clique em **Save** e depois em **Enable** para ativar o fluxo de trabalho.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/078179a91220-screenshot-2026-06-05-at-10-48-57.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bc5537be8d1094240414815a05b478c3" alt="" width="2938" height="1436" data-path="images/help-center/articles/15477534/078179a91220-screenshot-2026-06-05-at-10-48-57.png" />
</Frame>

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

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.

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

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

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

| Erro | O que verificar |
| - | - |
| **401 Unauthorized** | Volte a gerar e a introduzir o cabeçalho Authorization ou as credenciais |
| **400 Bad Request** | Certifique-se de que o número de telefone está no formato E.164 (`+1234567890`) e de que o `voice_agent_id` está correto |
| **O fluxo de trabalho não é executado** | Confirme que todas as condições são cumpridas, que o evento de acionamento se aplica e que o fluxo de trabalho está ativado |

***

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


## Related topics

- [Acionar uma chamada do VoiceAgent a partir do Zoho CRM](/pt/articles/15516182-triggering-a-voiceagent-call-from-zoho-crm.md)
- [Acionar uma chamada do VoiceAgent a partir do Zapier](/pt/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)
- [Acionar uma chamada do VoiceAgent a partir do Freshdesk](/pt/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)


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