> ## 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 Zapier
> Acione chamadas do VoiceAgent da CloudTalk através do Zapier com um passo de Webhook. Automatize chamadas, transmita dados e personalize — sem precisar de…
Este guia mostra-lhe como acionar uma chamada do **CloudTalk VoiceAgent** através do **Zapier** e da aplicação **Webhooks by Zapier**. Assim, pode iniciar chamadas de voz automatizadas com base em eventos em tempo real nas suas ferramentas — sem escrever qualquer código.
**Nível de utilizador:**
* Admin
***
VoiceAgents da CloudTalk no Zapier
O Zapier liga as suas ferramentas favoritas e automatiza tarefas entre elas. O Zapier ajuda-o a ligar as suas ferramentas e a automatizar tarefas entre elas. Quando o liga ao **CloudTalk VoiceAgent**, pode acionar chamadas de voz com base em dados em direto de ferramentas como CRMs, formulários ou sistemas de helpdesk. Isto permite-lhe confirmar marcações, fazer o seguimento de leads ou enviar lembretes de voz com os dados que já recolhe. Traz a automatização de voz diretamente para os seus fluxos de trabalho existentes.
Para acionar uma **chamada do VoiceAgent a partir do Zapier**, utilize a [aplicação Webhooks](https://zapier.com/apps/webhook/integrations) para enviar um pedido de API ao [endpoint do CloudTalk VoiceAgent](/developers#tag/VoiceAgent) como um dos passos do seu Zap.
Pré-requisitos
Antes de configurar o Webhook Custom Request no Zapier, certifique-se de que tem:
* *Credenciais da API da CloudTalk*
* Aceda a **CloudTalk Dashboard → Conta → Definições → Chaves da API**
* Copie o **ID da Chave da API** e o **Segredo da Chave da API**
* *ID do VoiceAgent*
* O ID do VoiceAgent pode ser obtido na Cloudtalk em **Dashboard > VoiceAgents**
Instruções de configuração
Siga estes passos para configurar o acionamento de uma chamada do VoiceAgent a partir do Zapier:
1. No Zap que escolher, adicione um passo **Action** e escolha **Webhooks by Zapier.**
2. Escolha **Custom Request** como evento de ação.
3. Em **Method**, selecione POST
4. Para o API Endpoint, utilize este **URL**:\
[`https://api.cloudtalk.io/v1/voice-agent/calls`](https://api.cloudtalk.io/v1/voice-agent/calls)
5. Em Data, configure o corpo do pedido de acordo com a [documentação da API](/developers#tag/VoiceAgent)
* Crie um payload JSON com o seguinte formato:
```json theme={"system"}
{
"call_number": "#{{phone_number}}",
"voice_agent_id": "#{{voice_agent_id}}",
"call_properties": {
"system_prompt": {
"variables": {
"contact_name": "#{{name}}"
}
},
"output": {
"variables": {
"custom_field": "value"
}
}
}
}
```
* Substitua as variáveis (`#{{...}}`) por dados de passos anteriores do seu cenário.
* Em `call_number`, insira uma referência ao número de telefone (e.164) a contactar, extraída dos passos anteriores.
* Em `voice_agent_id`, insira o ID do VoiceAgent obtido no CloudTalk Dashboard.
* Se necessário, configure `call_properties`, em que:
1. Os dados em `call_properties.system_prompt.variables` incluem informação específica do pedido que o VoiceAgent deve utilizar durante a chamada (por exemplo, o nome do contacto).
2. Os dados em `call_properties.output.variables` definem os valores que o VoiceAgent deve enviar ao endpoint externo depois da chamada, além da informação extraída durante a conversa.
📘 **Quer aprofundar o tema?** Saiba como as variáveis do System prompt e as variáveis de Output moldam o comportamento do seu VoiceAgent [neste artigo dedicado](/pt/articles/11401649-voiceagents-for-outbound-calls#h_91064c3683)!
6\. No campo **Headers**, adicione o cabeçalho `"Content-Type": "application/json"`
8\. Configure a **Basic Authentication** utilizando o seu **ID da Chave da API** como nome de utilizador e o **Segredo da Chave da API** como palavra-passe, ambos obtidos no CloudTalk Dashboard.
9\. Clique em **Continue** e, se quiser verificar a configuração, utilize **Test Step** para enviar uma chamada de teste.
⚠️ **Atenção:** testar o passo irá acionar uma chamada real do VoiceAgent. Certifique-se de que o `call_number` utilizado durante o teste é um número que pretende contactar nesta fase.
**Tudo pronto!** 🚀 A sua configuração está concluída e pronta para começar a acionar chamadas do VoiceAgent com toda a facilidade. Que comece a automatização!
**💡 Limites da API a ter em conta**
*Para evitar falhas ou limitações, certifique-se de que o seu cenário no Make gere com cuidado a distribuição das chamadas. Utilize atrasos, filas ou lógica de agendamento sempre que for necessário, uma vez que o limite de taxa padrão da API (60 pedidos por minuto) se aplica ao endpoint do VoiceAgent.*
***
*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.