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

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

<Note>
  Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Zoho CRM utilizando Workflow Rules.
</Note>

**Nível de utilizador**: Admin

***

<h2 id="h_before_you_start">
  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 suas Chaves da API da CloudTalk](/pt/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Zoho CRM com **plano Professional** ou superior

* Um campo de telefone disponível nos registos Contact ou Lead

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

A CloudTalk utiliza autenticação Basic 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 **Segredo da API** como Password

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

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

<h3 id="h_create_webhook">
  Criar o Webhook
</h3>

1\. No Zoho CRM, clique no **ícone de engrenagem** no canto superior direito e aceda a **Automation > Actions > Webhooks**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/98feae8fe1a4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c66f0979edeb7832e8f6616f11539e01" alt="" width="2840" height="1160" data-path="images/help-center/articles/15516182/98feae8fe1a4-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/73f55ba967b7-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88bd7e10c27198c0b30f581ff28cba2e" alt="" width="2384" height="544" data-path="images/help-center/articles/15516182/73f55ba967b7-image.png" />
</Frame>

2\. Clique em **Configure Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/c29a495b2b90-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1fc63b01d658701a43e6dfce477807bf" alt="" width="2384" height="530" data-path="images/help-center/articles/15516182/c29a495b2b90-image.png" />
</Frame>

3\. Preencha os detalhes do webhook:

| **Campo** | **Valor** |
| - | - |
| Name | CloudTalk VoiceAgent |
| URL to Notify | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Method | POST |
| Authorization Type | General |
| Module | Contacts ou Leads |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/4a5c1aef7583-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a28db82730d3f7679e9ffb17a0c66e40" alt="" width="1385" height="949" data-path="images/help-center/articles/15516182/4a5c1aef7583-image.png" />
</Frame>

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

* `Authorization` → `Basic XXXXXXXXX` (o valor que gerou)

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

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5242d55f0b27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=553381a3ed9fd980e2c3a4d21af4a47b" alt="" width="1644" height="514" data-path="images/help-center/articles/15516182/5242d55f0b27-image.png" />
</Frame>

5\. Em **Body**, defina **Type** como Raw e **Format** como JSON e, em seguida, cole:

```json theme={"system"}
{  "call_number": "${Contacts.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/15516182/5dae1c82d009-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=eeb1d0596d12ab9a036373e3e3ca726f" alt="" width="2298" height="474" data-path="images/help-center/articles/15516182/5dae1c82d009-image.png" />
</Frame>

6\. Clique em **Save**

<h3 id="h_create_rule">
  Criar a Workflow Rule
</h3>

1\. Clique no **ícone de engrenagem** no canto superior direito e aceda a **Automation > Workflow Rules**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/801053f501d3-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bcca196dfb6b5f1365ed0d7a3ded13f5" alt="" width="2856" height="1114" data-path="images/help-center/articles/15516182/801053f501d3-image.png" />
</Frame>

2\. Clique em **Create Rule**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5ef19e32b2ee-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c3e2c947e6af57bfcdc914cca28bf0de" alt="" width="2850" height="874" data-path="images/help-center/articles/15516182/5ef19e32b2ee-image.png" />
</Frame>

<Warning>
  **Nota:** Os webhooks estão disponíveis a partir da edição Professional do Zoho CRM.
</Warning>

3\. Configure a regra:

* Selecione o **módulo** (por exemplo, Contacts ou Leads) e atribua um nome à regra

* Defina o **acionador** (por exemplo, um registo é criado, um campo é modificado)

* Adicione **condições** para filtrar registos (por exemplo, o campo de telefone não está vazio)

* Em **Instant Actions**, adicione: **Webhook > CloudTalk VoiceAgent**

4\. Clique em **Save** e, em seguida, em **Activate** para ativar a regra

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/51a5a32cd713-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c7d4b1550da7b824c867024705ed11b0" alt="" width="2016" height="1258" data-path="images/help-center/articles/15516182/51a5a32cd713-image.png" />
</Frame>

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

1. Crie ou atualize um Contact que cumpra as condições do seu acionador

2. Aceda a **ícone de engrenagem > Automation > Workflow Rules**, selecione a sua regra e clique em **View Usage** para verificar a execução

3. Confirme na CloudTalk que a chamada do VoiceAgent foi iniciada

**Está tudo pronto!** 🚀 O seu fluxo de trabalho do Zoho CRM passa a acionar uma chamada do VoiceAgent da CloudTalk sempre que um registo cumprir as condições que definiu.

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

  *Para evitar falhas ou limitações, certifique-se de que o seu fluxo de trabalho 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_troubleshooting">
  Resolução de problemas
</h2>

Se a chamada do VoiceAgent não tiver sido efetuada, aceda a **View Usage** e clique em **Failures**. Localize o seu registo e consulte a coluna **Reason For Failures**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/f6fcd150ee27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=186290eea2a7b0d1b57b663a9c28e4dd" alt="" width="2828" height="1232" data-path="images/help-center/articles/15516182/f6fcd150ee27-image.png" />
</Frame>

| **Erro** | **O que verificar** |
| - | - |
| **Autorização** | Credenciais da API da CloudTalk incorretas no webhook — gere-as novamente e volte a introduzi-las |
| **Formato do número de telefone** | Certifique-se de que o número está no formato E.164 (`+1234567890`) |
| **ID de VoiceAgent incorreto** | Verifique se o `voice_agent_id` no corpo do webhook está correto |
| **Webhook não acionado** | Verifique se a workflow rule está ativa e se as respetivas condições foram cumpridas |

***

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 si.


## Related topics

- [Acionar uma chamada do VoiceAgent a partir do Zoho Desk](/pt/articles/15442851-triggering-a-voiceagent-call-from-zoho-desk.md)
- [Acionar uma chamada do VoiceAgent a partir do Freshworks CRM](/pt/articles/15477534-triggering-a-voiceagent-call-from-freshworks-crm.md)
- [Acionar uma chamada do VoiceAgent a partir do Zapier](/pt/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)


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