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

> Automatize as chamadas de saída do VoiceAgent diretamente a partir do Pipedrive

<Note>
  Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Pipedrive, através da funcionalidade Automations.
</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](/pt/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (ID da Chave da API e Segredo da Chave da API)

* Pipedrive **plano Advanced ou superior** (as Automations com ações de webhook exigem Advanced+)

* Um número de telefone disponível nos registos Person ou Deal

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

<h3 id="h_step1">
  Criar o Automation webhook
</h3>

<Warning>
  **Nota:** apenas os utilizadores com perfil de administrador global podem criar webhooks. Os webhooks normais já existentes não podem ser reutilizados nas Automations, por isso tem de criar especificamente um Automation webhook.
</Warning>

1\. No Pipedrive, clique no seu **ícone de perfil** e selecione **Tools and Apps**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/f77734ddee37-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=65a9148ee4495fd80f7df964fc8a1ee3" alt="" width="400" data-path="images/help-center/articles/15516233/f77734ddee37-image.png" />
</Frame>

2\. Clique em **+ Webhook** e selecione **Automation webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/de07daf9d028-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6b00478bb7e454e661af55d75e14c5cd" alt="" width="2769" height="1500" data-path="images/help-center/articles/15516233/de07daf9d028-image.png" />
</Frame>

3\. Configure o webhook:

* **Name:** `CloudTalk VoiceAgent`

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

* **Authentication, Username:** o ID da Chave da API da CloudTalk

* **Authentication, Password:** o Segredo da Chave da API da CloudTalk

<Warning>
  **Porque é que o URL termina com `?`?** O Pipedrive exige que os URL dos Automation webhooks terminem com `/`, `&`, `?` ou `=`. O `?` é o único que a API da CloudTalk aceita. Abre uma query string vazia que a CloudTalk ignora, pelo que o pedido continua a chegar ao endpoint correto. Os restantes caracteres são interpretados como parte do caminho do URL, o que quebra o pedido.
</Warning>

4\. Clique em **Save**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c4e587c5bf00-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f104177314f9b1b6c5306bf545352e2" alt="" width="2270" height="1030" data-path="images/help-center/articles/15516233/c4e587c5bf00-image.png" />
</Frame>

<h3 id="h_step2">
  Criar a automação
</h3>

1\. Aceda a **Tools and Apps > Automations**

2\. Clique em **+ Automation**

3\. Selecione um **acionador**, por exemplo:

* *Deal stage changed*

* *Person created or updated*

* *Activity completed*

4\. Adicione as **condições** necessárias (por exemplo, executar apenas numa fase específica do pipeline)

5\. Clique em **+ Add action** e selecione **Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c37747817114-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=550eb243ab60d8ef6297f3064d4c0312" alt="" width="1928" height="1290" data-path="images/help-center/articles/15516233/c37747817114-image.png" />
</Frame>

<h3 id="h_step3">
  Configurar a ação Webhook
</h3>

1\. No campo **Webhook**, selecione `CloudTalk VoiceAgent` (o webhook que criou no Passo 1)

2\. Defina **Method** como `POST`

3\. Na secção **Body**, mude para **Raw** e introduza:

```json theme={"system"}
{  "call_number": "",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

Para `call_number`, utilize o botão de seleção de campos para escolher **Person > Phones**. Introduza o ID do seu VoiceAgent como valor de `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)

  Certifique-se de que o número de telefone está guardado no **formato E.164** (`+1234567890`); caso contrário, a CloudTalk rejeita o pedido.
</Warning>

<Warning>
  **Contactos com vários números de telefone:** o campo Person Phones do Pipedrive pode conter vários números. Quando um contacto tem mais do que um, o campo envia todos eles para a CloudTalk em vez de um único número, o que torna o pedido inválido e faz a chamada falhar. **Solução alternativa:** crie um campo personalizado de telefone dedicado, de valor único (**Settings > Data fields > Person**), guarde nele apenas o número a marcar em formato E.164 e mapeie esse campo para `call_number`.
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/0c71cf9fcd8d-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=93c6028b4bdd3d9b29eb40fc62e07ef9" alt="" width="400" data-path="images/help-center/articles/15516233/0c71cf9fcd8d-image.png" />
</Frame>

<h3 id="h_step4">
  Ativar e testar
</h3>

1. Guarde e **ative** a automação

2. Acione manualmente a condição com um registo de teste (por exemplo, mova um deal para a fase pretendida)

3. Aceda a **Automations > History** e confirme que a ação foi executada com o estado **SUCCESS**

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

**Está tudo pronto!** 🚀 A sua automação do Pipedrive 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 de tráfego, certifique-se de que a sua automação distribui as chamadas com cuidado. Utilize atrasos ou lógica de agendamento sempre que for 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 foi iniciada:

1. Aceda a **Automations > History**

2. Selecione o filtro **Failed**

3. Abra a execução falhada para ver qual foi o passo que falhou

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/b8eaaf2d1470-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=3f4076863ebb895c14f29b28d4953528" alt="" width="2410" height="626" data-path="images/help-center/articles/15516233/b8eaaf2d1470-image.png" />
</Frame>

| **Erro** | **O que verificar** |
| - | - |
| **Autenticação** | ID ou Segredo da Chave da API da CloudTalk incorretos no webhook. Gere-os novamente e volte a introduzi-los. |
| **Número de telefone** | O número não está no formato E.164 ou o contacto tem vários números de telefone (consulte a nota do Passo 3 acima) |
| **ID do VoiceAgent incorreto** | Verifique se o `voice_agent_id` no corpo do webhook está correto |

***

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 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)


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