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

# Activar una llamada de VoiceAgent desde Zapier

> Activa llamadas de VoiceAgent de CloudTalk a través de Zapier con un paso de Webhook. Automatiza llamadas, transfiere datos y personaliza, sin necesidad de…

<Note>
  En esta guía te explicamos cómo activar una llamada de **CloudTalk VoiceAgent** con **Zapier** y la app **Webhooks by Zapier**. Así puedes lanzar llamadas de voz automatizadas a partir de eventos en tiempo real de tus herramientas, sin escribir nada de código.
</Note>

**Nivel de usuario:**

* Admin

***

<h2 id="h_bc6a9f4970">
  VoiceAgents de CloudTalk en Zapier
</h2>

Zapier conecta tus herramientas favoritas y automatiza tareas entre ellas. By Zapier te ayuda a conectar tus herramientas y a automatizar tareas entre ellas. Cuando lo conectas con **CloudTalk VoiceAgent**, puedes activar llamadas de voz a partir de datos en tiempo real de herramientas como CRM, formularios o sistemas de helpdesk. Así puedes confirmar citas, hacer seguimiento de leads o enviar recordatorios de voz con los datos que ya recopilas. Lleva la automatización de voz directamente a tus flujos de trabajo actuales.

Para activar una **llamada de VoiceAgent desde Zapier**, usa la [app Webhooks](https://zapier.com/apps/webhook/integrations) para enviar una solicitud de API al [endpoint de CloudTalk VoiceAgent](/developers#tag/VoiceAgent) como uno de los pasos de tu Zap.

<h3 id="h_a9cc30eafb">
  Requisitos previos
</h3>

Antes de configurar la Custom Request de webhook en Zapier, asegúrate de tener:

* *Credenciales de API de CloudTalk*

  * Ve a **CloudTalk Dashboard → Cuenta → Configuración → Claves de API**

  * Copia tanto el **API Key ID** como el **API Key Secret**

* *ID del VoiceAgent*

  * El ID del VoiceAgent se puede obtener en CloudTalk **Dashboard > VoiceAgents**

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

<h3 id="h_b36bf33918">
  Instrucciones de configuración
</h3>

Sigue estos pasos para configurar la activación de una llamada de VoiceAgent desde Zapier:

1. En el Zap que prefieras, añade un paso de **Acción** y elige **Webhooks by Zapier.**

2. Elige **Custom Request** como evento de acción.

3. En **Método**, selecciona POST

4. Para el endpoint de la API, usa esta **URL**:\
   [`https://api.cloudtalk.io/v1/voice-agent/calls`](https://api.cloudtalk.io/v1/voice-agent/calls)

5. En Data, configura el cuerpo de la solicitud según la [documentación de la API](/developers#tag/VoiceAgent)

   * Crea un payload JSON con el siguiente 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"
     }
     }
     }
     }
     ```

   * Sustituye las variables (`#{{...}}`) por datos de pasos anteriores de tu escenario.

   * En `call_number`, inserta una referencia al número de teléfono (e.164) al que se va a llamar, extraída de pasos anteriores.

   * En `voice_agent_id`, inserta el ID del VoiceAgent que has obtenido en el CloudTalk Dashboard.

   * Si es necesario, configura `call_properties`, donde:

     1. Los datos de `call_properties.system_prompt.variables` incluyen información específica de la solicitud que el VoiceAgent debe usar durante la llamada (por ejemplo, el nombre del contacto).

     2. Los datos de `call_properties.output.variables` definen los valores que el VoiceAgent debe enviar al endpoint externo después de la llamada, además de la información extraída durante la conversación.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/bdcbf8b7ba06-image.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=1ac248ff9179fe93b91e2045d354e3b6" alt="" width="867" height="254" data-path="images/help-center/articles/11831224/bdcbf8b7ba06-image.png" />
   </Frame>

<Warning>
  📘 **¿Quieres profundizar?** ¡Descubre cómo las variables del System prompt y las variables de Output definen el comportamiento de tu VoiceAgent en [este artículo específico](/es/articles/11401649-voiceagents-for-outbound-calls#h_91064c3683)!
</Warning>

6\. En el campo **Encabezados**, añade el encabezado `"Content-Type": "application/json"`

8\. Configura la **Basic Authentication** usando tu **API Key ID** como nombre de usuario y el **API Key Secret** como contraseña; los dos se obtienen en el CloudTalk Dashboard.

9\. Haz clic en **Continuar** y, si quieres comprobar la configuración, usa **Test Step** para enviar una llamada de prueba.

<Note>
  ⚠️ **Atención:** probar el paso activará una llamada real del VoiceAgent. Asegúrate de que el `call_number` que uses durante la prueba sea un número al que quieras llamar en este momento.
</Note>

**¡Todo está listo!** 🚀 La configuración está completa y preparada para empezar a activar llamadas de VoiceAgent sin complicaciones. ¡Que empiece la automatización!

<Info>
  **💡 Límites de la API que debes tener en cuenta**

  *Para evitar fallos o limitaciones, asegúrate de que tu escenario de Make gestione la distribución de llamadas con cuidado. Usa retardos, colas o lógica de programación cuando sea necesario, ya que al endpoint de VoiceAgent se le aplica el límite de frecuencia estándar de la API (60 solicitudes por minuto).*
</Info>

***

*¿Necesitas ayuda o tienes alguna pregunta?* Escríbenos a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aquí para ayudarte.


## Related topics

- [Activar una llamada de VoiceAgent desde Salesforce](/es/articles/16064425-triggering-a-voiceagent-call-from-salesforce.md)
- [Activar una llamada de VoiceAgent desde Pipedrive](/es/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)
- [Activar una llamada de VoiceAgent desde Freshservice](/es/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)


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