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

> Automatiza las llamadas salientes de VoiceAgent directamente desde Pipedrive

<Note>
  En esta guía aprenderás a activar automáticamente una llamada de VoiceAgent de CloudTalk desde Pipedrive mediante la función Automations.
</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)

* [Credenciales de la API de CloudTalk](/es/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (API Key ID y API Key Secret)

* Plan **Advanced o superior** de Pipedrive (las Automations con acciones de webhook requieren Advanced+)

* Un número de teléfono disponible en los registros de Person o Deal

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

<h3 id="h_step1">
  Crear el webhook de Automation
</h3>

<Warning>
  **Nota:** solo los usuarios con permisos de administrador global pueden crear webhooks. Los webhooks normales que ya existen no se pueden reutilizar para las Automations, así que tienes que crear un Automation webhook específico.
</Warning>

1\. En Pipedrive, haz clic en tu **icono de perfil** y selecciona **Tools and Apps**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/f77734ddee37-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=65a9148ee4495fd80f7df964fc8a1ee3" alt="" width="400" data-path="images/help-center/articles/15516233/f77734ddee37-image.png" />
</Frame>

2\. Haz clic en **+ Webhook** y selecciona **Automation webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/de07daf9d028-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6b00478bb7e454e661af55d75e14c5cd" alt="" width="2769" height="1500" data-path="images/help-center/articles/15516233/de07daf9d028-image.png" />
</Frame>

3\. Configura el webhook:

* **Name:** `CloudTalk VoiceAgent`

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

* **Authentication, Username:** tu API Key ID de CloudTalk

* **Authentication, Password:** tu API Key Secret de CloudTalk

<Warning>
  **¿Por qué la URL termina con `?`?** Pipedrive exige que las URL de los Automation webhooks terminen en `/`, `&`, `?` o `=`. El `?` es el único que acepta la API de CloudTalk. Abre una cadena de consulta vacía que CloudTalk ignora, por lo que la llamada sigue llegando al endpoint correcto. Los demás caracteres se interpretan como parte de la ruta de la URL, lo que rompe la solicitud.
</Warning>

4\. Haz clic en **Save**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c4e587c5bf00-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f104177314f9b1b6c5306bf545352e2" alt="" width="2270" height="1030" data-path="images/help-center/articles/15516233/c4e587c5bf00-image.png" />
</Frame>

<h3 id="h_step2">
  Crear la automatización
</h3>

1\. Ve a **Tools and Apps > Automations**

2\. Haz clic en **+ Automation**

3\. Selecciona un **activador**, por ejemplo:

* *Deal stage changed*

* *Person created or updated*

* *Activity completed*

4\. Añade las **condiciones** que necesites (por ejemplo, que solo se ejecute para una etapa concreta del pipeline)

5\. Haz clic en **+ Add action** y selecciona **Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c37747817114-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=550eb243ab60d8ef6297f3064d4c0312" alt="" width="1928" height="1290" data-path="images/help-center/articles/15516233/c37747817114-image.png" />
</Frame>

<h3 id="h_step3">
  Configurar la acción Webhook
</h3>

1\. En el campo **Webhook**, selecciona `CloudTalk VoiceAgent` (el webhook que creaste en el paso 1)

2\. Establece **Method** en `POST`

3\. En la sección **Body**, cambia a **Raw** e introduce:

```json theme={"system"}
{  "call_number": "",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

Para `call_number`, usa el botón selector de campos y elige **Person > Phones**. Introduce tu ID de VoiceAgent como valor de `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 system prompt y variables de salida, según la configuración de tu VoiceAgent. [Descubre qué puedes incluir](/es/articles/11401649-voiceagents-for-outbound-calls)

  Asegúrate de que el número de teléfono esté guardado en **formato E.164** (`+1234567890`); de lo contrario, CloudTalk rechazará la solicitud.
</Warning>

<Warning>
  **Contactos con varios números de teléfono:** el campo Phones de Person en Pipedrive puede contener varios números. Cuando un contacto tiene más de uno, el campo envía todos a CloudTalk en lugar de un único número, lo que invalida la solicitud y hace que la llamada falle. **Solución alternativa:** crea un campo personalizado de teléfono específico con un solo valor (**Settings > Data fields > Person**), guarda en él solo el número al que se debe llamar en formato E.164 y asigna ese campo a `call_number`.
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/0c71cf9fcd8d-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=93c6028b4bdd3d9b29eb40fc62e07ef9" alt="" width="400" data-path="images/help-center/articles/15516233/0c71cf9fcd8d-image.png" />
</Frame>

<h3 id="h_step4">
  Activar y probar
</h3>

1. Guarda y **activa** la automatización

2. Activa manualmente la condición con un registro de prueba (por ejemplo, mueve un deal a la etapa de destino)

3. Ve a **Automations > History** y comprueba que la acción se ejecutó con el estado **SUCCESS**

4. Verifica en CloudTalk que se inició la llamada del VoiceAgent

**¡Ya está todo listo!** 🚀 A partir de ahora, tu automatización de Pipedrive 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 debes tener en cuenta**

  *Para evitar fallos o limitaciones, asegúrate de que tu automatización distribuya las llamadas con cuidado. Usa retrasos o lógica de programación cuando haga falta, 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">
  Solución de problemas
</h2>

Si la llamada del VoiceAgent no se inició:

1. Ve a **Automations > History**

2. Selecciona el filtro **Failed**

3. Abre la ejecución fallida para ver qué paso falló

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/b8eaaf2d1470-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=3f4076863ebb895c14f29b28d4953528" alt="" width="2410" height="626" data-path="images/help-center/articles/15516233/b8eaaf2d1470-image.png" />
</Frame>

| **Error** | **Qué comprobar** |
| - | - |
| **Autenticación** | El API Key ID o el API Key Secret de CloudTalk del webhook son incorrectos. Vuelve a generarlos e introdúcelos de nuevo. |
| **Número de teléfono** | El número no está en formato E.164 o el contacto tiene varios números de teléfono (consulta la nota del paso 3 más arriba) |
| **ID de VoiceAgent incorrecto** | Comprueba que el `voice_agent_id` del cuerpo del webhook sea correcto |

***

¿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 Freshservice](/es/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
- [Activar una llamada de VoiceAgent desde Zendesk](/es/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)


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