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

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

<Note>
  Neste guia, vai aprender a acionar automaticamente uma chamada do VoiceAgent da CloudTalk a partir do Freshservice através do Workflow Automator.
</Note>

**Nível de utilizador**: Administrador

***

<Warning>
  **Nota:** Utilize o **Web Request Node** e não o nó Trigger Webhook. O Web Request Node aguarda a resposta da API e suporta a análise de respostas JSON, o que lhe permite detetar erros. O nó Trigger Webhook funciona em modo «enviar e esquecer» e não confirma o êxito.
</Warning>

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

Vai precisar de:

* Um VoiceAgent da CloudTalk já criado (tome nota do 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))

* Um **plano Pro** do Freshservice ou superior

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

<h2 id="h_credentials">
  Localize as suas credenciais da CloudTalk
</h2>

O Web Request Node tem um formulário de Basic Auth integrado, pelo que não é necessária qualquer codificação prévia.

1. Na CloudTalk, aceda a **Definições da empresa > Integrações > API**

2. Tome nota do seu **ID da Chave da API** — este será o Username

3. Tome nota do seu **Segredo da API** — este será a Password

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

<h3 id="h_create_workflow">
  Criar o workflow
</h3>

1\. No Freshservice, aceda a **Admin > Workflow Automator**

2\. Clique em **Create > Workflow**

3\. Defina o **Event trigger**, por exemplo:

* *Ticket raised*

* *Ticket updated* (o estado muda para Pending)

* *Requester replies*

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/cfe5ebee1bfc-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=256f95008b25fbab2b0b2bbe4c572d8c" alt="" width="583" height="361" data-path="images/help-center/articles/15502021/cfe5ebee1bfc-image.png" />
</Frame>

4\. Adicione **condições** para filtrar quais os tickets que acionam a chamada (por exemplo, o telefone do Requester está preenchido, uma categoria específica)

<h3 id="h_web_request">
  Adicionar o Web Request Node
</h3>

1\. Clique em **`+`** para adicionar um bloco de ação

2\. Selecione **Web Request Node**

3\. Configure o nó:

| **Campo** | **Valor** |
| - | - |
| Request type | POST |
| Endpoint | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Credentials | Inline Credential |
| Authentication | Basic Auth |
| Username | O ID da sua Chave da API da CloudTalk |
| Password | O seu Segredo da API da CloudTalk |
| Headers | `Content-Type`: `application/json` |

4\. Em **Request body**, cole o seguinte:

```json theme={"system"}
{  "call_number": "#{{ticket.requester.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/15502021/bd0f895867f5-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=ab3441168ef857eb20660f388de7dc13" alt="" width="581" height="685" data-path="images/help-center/articles/15502021/bd0f895867f5-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/f00064942f5b-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6d8c792ec9cf6d9a0fa081cb3da4045a" alt="" width="561" height="608" data-path="images/help-center/articles/15502021/f00064942f5b-image.png" />
</Frame>

5\. Ligue o nó ao trigger e clique em **Activate**

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

1. Crie ou atualize um ticket que cumpra as condições do seu trigger

2. Abra o **Workflow Automator** e consulte o histórico de execuções

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

**Está tudo pronto!** 🚀 O seu workflow do Freshservice passa agora a acionar uma chamada do VoiceAgent da CloudTalk sempre que um ticket cumprir as condições escolhidas.

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

  *Para evitar falhas ou limitações, certifique-se de que o seu workflow gere a distribuição das chamadas com cuidado. Utilize atrasos ou lógica de agendamento sempre que necessário, uma vez que o limite padrão de pedidos da API (60 pedidos por minuto) se aplica ao endpoint do VoiceAgent.*
</Info>

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

| **Erro** | **O que verificar** |
| - | - |
| **401 Unauthorized** | Volte a gerar e a introduzir as suas credenciais da API nos campos de Basic Auth |
| **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 workflow não é acionado** | Verifique se as condições do evento correspondem ao seu ticket de teste e se o workflow 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 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 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.