> ## 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 Zoho CRM

> Automatiza las llamadas salientes de VoiceAgent directamente desde Zoho CRM

<Note>
  En esta guía aprenderás a activar automáticamente una llamada de VoiceAgent de CloudTalk desde Zoho CRM mediante las Workflow Rules.
</Note>

**Nivel de usuario**: Admin

***

<h2 id="h_before_you_start">
  Antes de empezar
</h2>

Necesitarás:

* Un VoiceAgent de CloudTalk ya creado (anota el ID del VoiceAgent)

* Las credenciales de la API de CloudTalk (Clave de API y Secreto), que encontrarás en **Configuración de la empresa > Integraciones > API** ([Cómo acceder a tus claves de API de CloudTalk y generarlas](/es/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* El **plan Professional** de Zoho CRM o superior

* Un campo de teléfono disponible en los registros de Contacts o Leads

<h2 id="h_generate_auth">
  Genera el encabezado Authorization
</h2>

CloudTalk utiliza la autenticación básica para las solicitudes a la API.

1. Abre [https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)

2. Introduce tu **Clave de API de CloudTalk** como Username y tu **Secreto de API** como Password

3. Copia el valor generado. Tiene este aspecto: `Basic XXXXXXXXX`

<h2 id="h_setup">
  Configura la integración
</h2>

<h3 id="h_create_webhook">
  Crea el Webhook
</h3>

1\. En Zoho CRM, haz clic en el **icono de engranaje** de la esquina superior derecha y ve a **Automation > Actions > Webhooks**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/98feae8fe1a4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c66f0979edeb7832e8f6616f11539e01" alt="" width="2840" height="1160" data-path="images/help-center/articles/15516182/98feae8fe1a4-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/73f55ba967b7-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88bd7e10c27198c0b30f581ff28cba2e" alt="" width="2384" height="544" data-path="images/help-center/articles/15516182/73f55ba967b7-image.png" />
</Frame>

2\. Haz clic en **Configure Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/c29a495b2b90-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1fc63b01d658701a43e6dfce477807bf" alt="" width="2384" height="530" data-path="images/help-center/articles/15516182/c29a495b2b90-image.png" />
</Frame>

3\. Completa los datos del webhook:

| **Campo** | **Valor** |
| - | - |
| Name | CloudTalk VoiceAgent |
| URL to Notify | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Method | POST |
| Authorization Type | General |
| Module | Contacts o Leads |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/4a5c1aef7583-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a28db82730d3f7679e9ffb17a0c66e40" alt="" width="1385" height="949" data-path="images/help-center/articles/15516182/4a5c1aef7583-image.png" />
</Frame>

4\. En **Custom Headers**, añade:

* `Authorization` → `Basic XXXXXXXXX` (tu valor generado)

* `Content-Type` → `application/json`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5242d55f0b27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=553381a3ed9fd980e2c3a4d21af4a47b" alt="" width="1644" height="514" data-path="images/help-center/articles/15516182/5242d55f0b27-image.png" />
</Frame>

5\. En **Body**, configura **Type** como Raw y **Format** como JSON y, a continuación, pega:

```json theme={"system"}
{  "call_number": "${Contacts.Phone}",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

<Warning>
  `call_number` y `voice_agent_id` son los únicos campos obligatorios. También puedes enviar `call_properties` opcionales, como variables del prompt del sistema y variables de salida, según la configuración de tu VoiceAgent. [Descubre qué incluir](/es/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5dae1c82d009-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=eeb1d0596d12ab9a036373e3e3ca726f" alt="" width="2298" height="474" data-path="images/help-center/articles/15516182/5dae1c82d009-image.png" />
</Frame>

6\. Haz clic en **Save**

<h3 id="h_create_rule">
  Crea la Workflow Rule
</h3>

1\. Haz clic en el **icono de engranaje** de la esquina superior derecha y ve a **Automation > Workflow Rules**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/801053f501d3-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bcca196dfb6b5f1365ed0d7a3ded13f5" alt="" width="2856" height="1114" data-path="images/help-center/articles/15516182/801053f501d3-image.png" />
</Frame>

2\. Haz clic en **Create Rule**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5ef19e32b2ee-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c3e2c947e6af57bfcdc914cca28bf0de" alt="" width="2850" height="874" data-path="images/help-center/articles/15516182/5ef19e32b2ee-image.png" />
</Frame>

<Warning>
  **Nota:** Los webhooks están disponibles a partir de la edición Professional de Zoho CRM.
</Warning>

3\. Configura la regla:

* Selecciona el **módulo** (p. ej., Contacts o Leads) y ponle un nombre a la regla

* Define el **activador** (p. ej., se crea un registro, se modifica un campo)

* Añade **condiciones** para filtrar los registros (p. ej., el campo de teléfono no está vacío)

* En **Instant Actions**, añade: **Webhook > CloudTalk VoiceAgent**

4\. Haz clic en **Save** y luego en **Activate** para activar la regla

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/51a5a32cd713-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c7d4b1550da7b824c867024705ed11b0" alt="" width="2016" height="1258" data-path="images/help-center/articles/15516182/51a5a32cd713-image.png" />
</Frame>

<h3 id="h_test_verify">
  Prueba y verifica
</h3>

1. Crea o actualiza un Contact que cumpla las condiciones de tu activador

2. Ve a **icono de engranaje > Automation > Workflow Rules**, selecciona tu regla y haz clic en **View Usage** para comprobar la ejecución

3. Comprueba en CloudTalk que la llamada del VoiceAgent se ha iniciado

**¡Todo listo!** 🚀 A partir de ahora, tu flujo de trabajo de Zoho CRM activará una llamada de VoiceAgent de CloudTalk cada vez que un registro cumpla las condiciones que hayas elegido.

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

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

<h2 id="h_troubleshooting">
  Resolución de problemas
</h2>

Si no se ha realizado la llamada del VoiceAgent, ve a **View Usage** y haz clic en **Failures**. Busca tu registro y consulta la columna **Reason For Failures**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/f6fcd150ee27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=186290eea2a7b0d1b57b663a9c28e4dd" alt="" width="2828" height="1232" data-path="images/help-center/articles/15516182/f6fcd150ee27-image.png" />
</Frame>

| **Error** | **Qué comprobar** |
| - | - |
| **Autorización** | Las credenciales de la API de CloudTalk del webhook son incorrectas: vuelve a generarlas e introdúcelas de nuevo |
| **Formato del teléfono** | Asegúrate de que el número esté en formato E.164 (`+1234567890`) |
| **ID del VoiceAgent incorrecto** | Comprueba que el `voice_agent_id` del cuerpo del webhook sea correcto |
| **El webhook no se activa** | Comprueba que la Workflow Rule esté activa y que se hayan cumplido sus condiciones |

***

¿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 Zoho Desk](/es/articles/15442851-triggering-a-voiceagent-call-from-zoho-desk.md)
- [Activar una llamada de VoiceAgent desde Freshworks CRM](/es/articles/15477534-triggering-a-voiceagent-call-from-freshworks-crm.md)
- [Activar una llamada de VoiceAgent desde Zapier](/es/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)


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