> ## 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 Zendesk

> Automatize chamadas do VoiceAgent a partir de Triggers e Automations do Zendesk

<Note>
  Pode acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir dos Triggers ou Automations do Zendesk. O Zendesk suporta nativamente a autenticação básica na configuração dos Webhooks, pelo que não é necessário qualquer middleware. Este guia mostra-lhe como configurar o webhook, associá-lo a um trigger e confirmar que a chamada foi iniciada.
</Note>

**Nível de utilizador**: Admin

***

<h2 id="before-you-start">
  Antes de começar
</h2>

Vai precisar de:

* Um VoiceAgent da CloudTalk já criado (anote o ID do VoiceAgent)

* Chave da API e Secret da CloudTalk (**Definições da empresa > Integrações > API**)

* Plano Zendesk Support Professional ou superior

* Registos de contacto/requester com um número de telefone

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

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

1. No Zendesk Admin Center, aceda a **Apps and integrations > Webhooks**.

2. Clique em **Create webhook**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/b1a87fcbfc33-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3b3b2435d5b92b81e7ff3e70e6d73eac" alt="" width="3600" height="2064" data-path="images/help-center/articles/15934846/b1a87fcbfc33-image.png" />
   </Frame>

3. Selecione **Trigger or automation** e clique em **Next**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/d66feedd2495-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=506cf3c3e35dd681833fb33a90c56c46" alt="" width="2970" height="1896" data-path="images/help-center/articles/15934846/d66feedd2495-image.png" />
   </Frame>

4. Configure o webhook:

   * **Name:** CloudTalk VoiceAgent

   * **Endpoint URL:** `https://api.cloudtalk.io/v1/voice-agent/calls`

   * **Request method:** POST

   * **Request format:** JSON

   * **Authentication:** Basic authentication

     * **Username:** a sua Chave da API da CloudTalk

     * **Password:** o seu Secret da API da CloudTalk

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/6295a2943f0e-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=78c8949f05e2337d22167fae3481702c" alt="" width="1586" height="1528" data-path="images/help-center/articles/15934846/6295a2943f0e-image.png" />
   </Frame>

5. Clique em **Create webhook > Finish Setup**.

<Note>
  O Zendesk trata automaticamente da codificação Base64 das credenciais quando a autenticação básica está selecionada.
</Note>

<h3 id="h_81ccd62750">
  Criar o Trigger
</h3>

1. No Admin Center, aceda a **Objects and rules > Business rules > Triggers** (ou **Automations**).

2. Clique em **Create trigger**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/e30863086760-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=45848cc42f215461c9dbbff9d8c3c689" alt="" width="3628" height="1532" data-path="images/help-center/articles/15934846/e30863086760-image.png" />
   </Frame>

3. Introduza um **Trigger name** (por exemplo, Ticket Solved).

4. Escolha uma **Trigger category**: crie uma categoria nova ou selecione uma já existente que se adeque.

5. Defina as suas **Conditions** (por exemplo, Ticket > Status > Is > Solved).

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15934846/036d3ef902d4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=15d81021252741ab2093e78d05d3fba1" alt="" width="1538" height="1242" data-path="images/help-center/articles/15934846/036d3ef902d4-image.png" />
   </Frame>

6. Em **Actions**, clique em **Add action** e selecione **Notify active webhook**.

7. Selecione o webhook que criou no passo 1. Será apresentada uma caixa de texto para o corpo JSON.

8. Introduza o seu payload JSON na caixa de texto. Utilize o marcador de posição do Zendesk `#{{ticket.requester.phone}}` para mapear o número de telefone do requester para `call_number`:

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/bd395bb986f2-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=abcee019a5e4d70d2fa724ad55563348" alt="" width="1574" height="1770" data-path="images/help-center/articles/15934846/bd395bb986f2-image.png" />
   </Frame>

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

<Note>
  `call_number` e `voice_agent_id` são os únicos campos obrigatórios. Outras `call_properties`, como variáveis do system prompt e variáveis de saída, são opcionais e dependem da configuração do seu VoiceAgent. [Saiba o que incluir](/pt/articles/11401649-voiceagents-for-outbound-calls).
</Note>

9\. No canto inferior direito, defina o trigger como **Active** e clique em **Create**.

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

1. Atualize um ticket de teste para que cumpra as condições do trigger.

2. Aceda a **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** para confirmar a entrega.

3. Na CloudTalk, confirme que a chamada do VoiceAgent foi iniciada.

**Está tudo pronto!**

O Zendesk passa agora a acionar automaticamente uma chamada do VoiceAgent da CloudTalk sempre que um ticket cumprir as condições que definiu.

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

Se a chamada não tiver sido iniciada, aceda a **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** para ver por que motivo a entrega falhou.

Os motivos mais comuns são:

* **Autorização**: credenciais da API da CloudTalk incorretas no webhook

* **Formato do telefone**: o número não está no formato E.164 (`+1234567890`)

* **ID do VoiceAgent incorreto**: foi enviado o `voice_agent_id` errado

* **Webhook não acionado**: o trigger não está ativo ou as suas condições não 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 Freshdesk](/pt/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.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.