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

# Cómo activar una llamada de VoiceAgent desde Freshdesk

> Automatiza las llamadas de VoiceAgent directamente desde Freshdesk

<Note>
  En esta guía aprenderás a activar automáticamente una llamada de un VoiceAgent de CloudTalk desde Freshdesk mediante reglas de automatización. La acción **Trigger Webhook** te da control total sobre el método HTTP, la URL, las cabeceras y el cuerpo, de modo que las llamadas se pueden iniciar directamente desde los eventos de los tickets.
</Note>

**Nivel de usuario**: Administrador

***

<h2 id="h_c4f65f76b0">
  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 Secret) 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))

* Un **plan Pro** de Freshdesk o superior

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

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

CloudTalk utiliza 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 **Secret de API** como Password

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

<Warning>
  **Nota:** Freshdesk también acepta una combinación normal de usuario y contraseña en la configuración del webhook, así que la cabecera codificada en Base64 es opcional. Las dos opciones funcionan.
</Warning>

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

<h3 id="h_e02ace1232">
  Crea la regla de automatización
</h3>

1\. En Freshdesk, ve a **Admin > Automation > Ticket Creation** (o **On Ticket Update**, según cuándo quieras que se activen las llamadas)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=5a7cc485d58bd1d956110794946f4af7" alt="" width="2936" height="1322" data-path="images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png" />
</Frame>

2\. Haz clic en **Start from scratch**

3\. Define tus **conditions**, por ejemplo:

* *Ticket is created*

* *Contact phone is present*

* *Tag contains* `voiceagent`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f883a536c594b5986ed2490dbcdb112" alt="" width="2926" height="1310" data-path="images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png" />
</Frame>

4\. En **Actions**, haz clic en **Add action > Trigger Webhook**

5\. Configura el webhook:

| **Campo** | **Valor** |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88d12880285be17c78721cb9768b7c11" alt="" width="2926" height="1332" data-path="images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png" />
</Frame>

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

* `Authorization` > `Basic XXXXXXXXX`

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

7\. En **Content (Advanced)**, pega el siguiente cuerpo:

```json theme={"system"}
{
  "call_number": "#{{ticket.contact.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/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=623092ba130f596b5667a223dc720089" alt="" width="2922" height="1316" data-path="images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png" />
</Frame>

8\. Haz clic en **Preview and save** y después activa la regla.

<h3 id="h_9e07057933">
  Prueba y comprueba
</h3>

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

2. Ve a **Admin > Automation** y revisa el registro de ejecución de la regla

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

**¡Todo listo!** 🚀 Tu regla de automatización de Freshdesk activará ahora una llamada de un VoiceAgent de CloudTalk cada vez que un ticket 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 automatización de Freshdesk gestiona con cuidado la distribución de las llamadas. Usa retrasos 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 también al endpoint del VoiceAgent.*
</Info>

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

| Error | Qué comprobar |
| - | - |
| **401 Unauthorized** | Vuelve a generar e introducir la cabecera Authorization |
| **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` es correcto |
| **La regla no se activa** | Confirma que se cumplen todas las condiciones y que la regla está activada |

***

¿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

- [Cómo activar una llamada de VoiceAgent desde Make](/es/articles/11830974-triggering-a-voiceagent-call-from-make.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.