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

> Automatiza las llamadas de VoiceAgent desde los Triggers y Automations de Zendesk

<Note>
  Puedes activar automáticamente una llamada de VoiceAgent de CloudTalk desde los Triggers o Automations de Zendesk. Zendesk admite de forma nativa la autenticación básica en la configuración de sus Webhooks, por lo que no necesitas ningún middleware. En esta guía te explicamos cómo configurar el webhook, conectarlo a un activador y comprobar que la llamada se ha iniciado.
</Note>

**Nivel de usuario**: Admin

***

<h2 id="before-you-start">
  Antes de empezar
</h2>

Necesitarás:

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

* La clave de API y el secreto de API de CloudTalk (**Configuración de la empresa > Integraciones > API**)

* Plan Zendesk Support Professional o superior

* Registros de contacto/solicitante con número de teléfono

<h2 id="h_b1f5f41ac5">
  Configurar la integración
</h2>

<h3 id="h_a74c65c2a1">
  Crear el webhook
</h3>

1. En el Admin Center de Zendesk, ve a **Apps and integrations > Webhooks**.

2. Haz clic en **Create webhook**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/b1a87fcbfc33-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3b3b2435d5b92b81e7ff3e70e6d73eac" alt="" width="3600" height="2064" data-path="images/help-center/articles/15934846/b1a87fcbfc33-image.png" />
   </Frame>

3. Selecciona **Trigger or automation** y haz clic en **Next**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/d66feedd2495-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=506cf3c3e35dd681833fb33a90c56c46" alt="" width="2970" height="1896" data-path="images/help-center/articles/15934846/d66feedd2495-image.png" />
   </Frame>

4. Configura el webhook:

   * **Name:** CloudTalk VoiceAgent

   * **Endpoint URL:** `https://api.cloudtalk.io/v1/voice-agent/calls`

   * **Request method:** POST

   * **Request format:** JSON

   * **Authentication:** Basic authentication

     * **Username:** tu clave de API de CloudTalk

     * **Password:** tu secreto de API de CloudTalk

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/6295a2943f0e-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=78c8949f05e2337d22167fae3481702c" alt="" width="1586" height="1528" data-path="images/help-center/articles/15934846/6295a2943f0e-image.png" />
   </Frame>

5. Haz clic en **Create webhook > Finish Setup**.

<Note>
  Zendesk codifica las credenciales en Base64 automáticamente cuando se selecciona Basic authentication.
</Note>

<h3 id="h_81ccd62750">
  Crear el activador
</h3>

1. En el Admin Center, ve a **Objects and rules > Business rules > Triggers** (o **Automations**).

2. Haz clic en **Create trigger**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/e30863086760-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=45848cc42f215461c9dbbff9d8c3c689" alt="" width="3628" height="1532" data-path="images/help-center/articles/15934846/e30863086760-image.png" />
   </Frame>

3. Introduce un **Trigger name** (p. ej., Ticket Solved).

4. Elige una **Trigger category**: crea una categoría nueva o selecciona cualquiera de las existentes que encaje.

5. Define tus **Conditions** (p. ej., Ticket > Status > Is > Solved).

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15934846/036d3ef902d4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=15d81021252741ab2093e78d05d3fba1" alt="" width="1538" height="1242" data-path="images/help-center/articles/15934846/036d3ef902d4-image.png" />
   </Frame>

6. En **Actions**, haz clic en **Add action** y selecciona **Notify active webhook**.

7. Selecciona el webhook que creaste en el paso 1. Aparecerá un cuadro de texto para el cuerpo JSON.

8. Introduce tu payload JSON en el cuadro de texto. Usa el marcador de posición de Zendesk `#{{ticket.requester.phone}}` para asignar el número de teléfono del solicitante a `call_number`:

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/bd395bb986f2-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=abcee019a5e4d70d2fa724ad55563348" alt="" width="1574" height="1770" data-path="images/help-center/articles/15934846/bd395bb986f2-image.png" />
   </Frame>

```json theme={"system"}
{
  "call_number": "#{{ticket.requester.phone}}",
  "voice_agent_id": "YOUR_VOICE_AGENT_ID"
}
```

<Note>
  `call_number` y `voice_agent_id` son los únicos campos obligatorios. Los `call_properties` adicionales, como las variables del system prompt y las variables de salida, son opcionales y dependen de la configuración de tu VoiceAgent. [Consulta qué incluir](/es/articles/11401649-voiceagents-for-outbound-calls).
</Note>

9\. Abajo a la derecha, pon el activador en **Active** y haz clic en **Create**.

<h3 id="h_b45d7e4a09">
  Probar y verificar
</h3>

1. Actualiza un ticket de prueba para que cumpla las condiciones del activador.

2. Ve a **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** para confirmar la entrega.

3. En CloudTalk, comprueba que la llamada del VoiceAgent se ha iniciado.

**¡Todo listo!**

A partir de ahora, Zendesk activará automáticamente una llamada de VoiceAgent de CloudTalk cada vez que un ticket cumpla las condiciones que hayas elegido.

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

Si la llamada no se ha iniciado, ve a **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** para ver por qué falló la entrega.

Los motivos más habituales son:

* **Autorización**: las credenciales de la API de CloudTalk del webhook son incorrectas

* **Formato del teléfono**: el número no está en formato E.164 (`+1234567890`)

* **ID de VoiceAgent incorrecto**: se ha enviado un `voice_agent_id` erróneo

* **El webhook no se ha activado**: el activador no está activo o no se cumplieron 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 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.