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

> Automatiza las llamadas salientes de VoiceAgent directamente desde Freshworks CRM

<Note>
  En esta guía aprenderás a activar automáticamente una llamada de VoiceAgent de CloudTalk desde Freshworks CRM (Freshsales) mediante las Automatizaciones de flujo de trabajo.
</Note>

**Nivel de usuario**: Admin

***

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

Necesitarás:

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

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

* Un plan **Growth** de Freshworks CRM o superior

* Un número de teléfono disponible en los registros de contacto

<h2 id="h_2a14fd940d">
  Genera la cabecera Authorization
</h2>

CloudTalk utiliza autenticación básica para las solicitudes de 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 **Secret de API** como Password

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

<Warning>
  **Nota:** Freshworks CRM también acepta una combinación de usuario y contraseña directamente en la configuración del webhook, por lo que la cabecera codificada en Base64 es opcional. Cualquiera de las dos opciones funciona.
</Warning>

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

<h3 id="h_f1af3c1b59">
  Crea la automatización de flujo de trabajo
</h3>

1\. En Freshworks CRM, ve a **Admin Settings > Teams & Territories > Workflows**

2\. Haz clic en **Create your own workflow**

3\. Elige el módulo: **Contacts** (o Accounts / Deals)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/4ed42b39df69-screenshot-2b2026-06-05-2bat-2b10-39-24.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=07b9b15294311943027b45315d1cfa2c" alt="" width="2938" height="1440" data-path="images/help-center/articles/15477534/4ed42b39df69-screenshot-2b2026-06-05-2bat-2b10-39-24.png" />
</Frame>

4\. Define el **evento activador**, por ejemplo:

* *Contact is created*

* *Field is updated* (p. ej., el estado cambia a "Interested")

5\. Añade **condiciones** para filtrar qué registros activan la llamada (p. ej., que haya un número de móvil)

<h3 id="h_f7ef74ca45">
  Añade la acción de webhook
</h3>

1\. En **Actions**, haz clic en **Add Action > Webhook**

2\. Configura el webhook:

| Campo | Valor |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Authentication | Username / Password (Client ID / Client Secret) |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/8bcb703b957f-screenshot-2026-06-05-at-10-45-56.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=0aaef50a525a233f51bb969c28ba02a1" alt="" width="1616" height="1440" data-path="images/help-center/articles/15477534/8bcb703b957f-screenshot-2026-06-05-at-10-45-56.png" />
</Frame>

3\. En **Request body (Advanced)**, pega lo siguiente:

```json theme={"system"}
{   "call_number": "#{{contact.mobile_number}}",   "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>

4\. Haz clic en **Save** y después en **Enable** para el flujo de trabajo.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15477534/078179a91220-screenshot-2026-06-05-at-10-48-57.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bc5537be8d1094240414815a05b478c3" alt="" width="2938" height="1436" data-path="images/help-center/articles/15477534/078179a91220-screenshot-2026-06-05-at-10-48-57.png" />
</Frame>

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

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

2. Ve a **Admin Settings > Automations > Workflow logs** y comprueba el estado de la ejecución

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

**¡Todo listo!** 🚀 Tu flujo de trabajo de Freshworks CRM activará ahora una llamada de VoiceAgent de CloudTalk cada vez que un contacto cumpla las condiciones que hayas elegido.

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

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

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

| Error | Qué comprobar |
| - | - |
| **401 Unauthorized** | Vuelve a generar e introducir la cabecera Authorization o las credenciales |
| **400 Bad Request** | Asegúrate de que el número de teléfono esté en formato E.164 (`+1234567890`) y de que `voice_agent_id` sea correcto |
| **El flujo de trabajo no se ejecuta** | Confirma que se cumplen todas las condiciones, que el evento activador es aplicable y que el flujo de trabajo está habilitado |

***

¿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


## Related topics

- [Activar una llamada de VoiceAgent desde Zoho CRM](/es/articles/15516182-triggering-a-voiceagent-call-from-zoho-crm.md)
- [Activar una llamada de VoiceAgent desde Zapier](/es/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)
- [Activar una llamada de VoiceAgent desde Salesforce](/es/articles/16064425-triggering-a-voiceagent-call-from-salesforce.md)


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