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

> Acione chamadas do VoiceAgent da CloudTalk através do Make com pedidos HTTP. Automatize chamadas, envie dados e personalize — sem programação.

<Note>
  Este guia mostra como acionar uma chamada do VoiceAgent utilizando a plataforma de automação Make e a API da CloudTalk. Com apenas alguns passos de configuração, poderá automatizar chamadas de saída conduzidas pelo seu VoiceAgent, enviando dados personalizados e recolhendo resultados — tudo sem escrever uma única linha de código.
</Note>

**Nível de utilizador:**

* Admin

***

<h2 id="h_d3ca4d1e46">
  VoiceAgents da CloudTalk no Make
</h2>

Ao combinar a força do **[Make](https://www.make.com/en)** com o **VoiceAgent da CloudTalk**, pode criar fluxos de trabalho de chamadas inteligentes e automatizados que são acionados em tempo real. Seja para enviar lembretes, qualificar leads ou recolher feedback, esta configuração ajuda-o a escalar o contacto, reduzir o trabalho manual e proporcionar experiências de voz consistentes. Das vendas ao apoio ao cliente, esta integração dá à sua equipa uma forma poderosa de interagir com os clientes por voz, com rapidez e simplicidade.

Para acionar uma chamada do VoiceAgent (VA), terá de utilizar um **pedido HTTP** no seu cenário do Make para enviar o pedido para a [API VoiceAgent da CloudTalk](/developers#tag/VoiceAgent).

<h3 id="h_2c55e418ca">
  Pré-requisitos
</h3>

Antes de configurar o pedido HTTP no [Make](https://www.make.com/en), certifique-se de que tem:

* *Credenciais da API da CloudTalk*

  * Aceda a **Dashboard da CloudTalk → Conta → Definições → Chaves da API**

  * Copie o **API Key ID** e o **API Key Secret**

* *ID do VoiceAgent*

  * O ID do VoiceAgent pode ser obtido no **Dashboard > VoiceAgents** da CloudTalk

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11830974/66af489dee4a-vaid.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=38a16301163ff904a1dccea2b7fdec6a" alt="" width="1622" height="477" data-path="images/help-center/articles/11830974/66af489dee4a-vaid.png" />
    </Frame>

<h3 id="h_3a5634382e">
  Instruções de configuração
</h3>

Para configurar o pedido HTTP no seu cenário do Make:

1. No seu cenário do Make, adicione um módulo e selecione a aplicação **[HTTP Request](https://www.make.com/en/integrations/http)** .

2. Selecione a ação **Make a basic auth request**.

3. Configure a autenticação

   * Clique em **Adicionar** para criar novas credenciais.

   * Utilize o seu **API Key ID** como Username.

   * Utilize o seu **API Key Secret** como Password.

   * Atribua um nome à ligação e clique em **Criar**.

4. Para o endpoint da API, utilize este **URL**:\
   [`https://api.cloudtalk.io/v1/voice-agent/calls`](https://api.cloudtalk.io/v1/voice-agent/calls)

5. Em **Método**, selecione POST

6. Configure o formato do pedido

   * Body type: `Raw`

   * Content type: `application/json`

7. Construa o **Request content** seguindo 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ído de passos anteriores.

   * Em `voice_agent_id`, insira o ID do VoiceAgent obtido no Dashboard da CloudTalk.

   * 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 para o endpoint externo após a chamada, além da informação extraída durante a conversa.

     <Frame>
       <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11830974/3d1dd6612ad4-image.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=9ff16ef31c26e6b1999f8ea261a5fd65" alt="" width="981" height="436" data-path="images/help-center/articles/11830974/3d1dd6612ad4-image.png" />
     </Frame>

<Warning>
  📘 **Quer saber mais?** Descubra 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)!
</Warning>

8\. Verifique novamente a configuração e **guarde o módulo**

**Tudo pronto!** 🚀 A sua configuração está concluída e pronta para começar a acionar chamadas do VoiceAgent com facilidade. Que comece a automatização!

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

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

***

*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 Zapier](/pt/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)
- [Acionar uma chamada do VoiceAgent a partir do Microsoft Dynamics 365](/pt/articles/15479706-triggering-a-voiceagent-call-from-microsoft-dynamics-365.md)
- [Acionar uma chamada do VoiceAgent a partir do Freshdesk](/pt/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)


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