> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Pipedrive

Con las [herramientas de webhook](/docs/es/reception-ai/integrations/webhooks) que aparecen a continuación, tu recepcionista puede identificar a quienes llaman y ya están en Pipedrive, abrir una oportunidad nueva y programar una llamada de seguimiento para tu equipo.

## Antes de empezar

En Pipedrive, abre **Personal preferences** → **API** y copia tu token de API. Todas las herramientas siguientes lo envían en la cabecera de solicitud `x-api-token`. Las herramientas actúan como tú, así que usa el token de un usuario que pueda ver el embudo adecuado.

## Crea las herramientas

Para cada herramienta, ve a **Integraciones**, selecciona **Añadir integración**, elige **Herramienta de webhook** y configura **Asignar a agentes** como **Recepcionista**.

### Buscar a quien llama

| Campo                      | Valor                                                                                                                                                             |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre**                 | `find_pipedrive_person`                                                                                                                                           |
| **Descripción**            | "Busca a quien llama en nuestro CRM por número de teléfono o nombre. Úsala al inicio de una llamada sobre una venta, un presupuesto o una oportunidad existente." |
| **Método**                 | GET                                                                                                                                                               |
| **URL**                    | `https://api.pipedrive.com/api/v2/persons/search`                                                                                                                 |
| **Cabeceras de solicitud** | `x-api-token`: tu token de API                                                                                                                                    |
| **Parámetros de consulta** | `term` (cadena, obligatorio): "El número de teléfono o nombre completo de quien llama, con al menos 2 caracteres."                                                |

### Abrir una oportunidad

| Campo                      | Valor                                                                                                                                                                                                                                                                          |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nombre**                 | `create_pipedrive_deal`                                                                                                                                                                                                                                                        |
| **Descripción**            | "Abre una oportunidad cuando alguien llama para pedir un presupuesto o comprar. Incluye el nombre de quien llama en el título."                                                                                                                                                |
| **Método**                 | POST                                                                                                                                                                                                                                                                           |
| **URL**                    | `https://api.pipedrive.com/api/v2/deals`                                                                                                                                                                                                                                       |
| **Cabeceras de solicitud** | `x-api-token`: tu token de API                                                                                                                                                                                                                                                 |
| **Parámetros del cuerpo**  | `title` (cadena, obligatorio): "Título breve con el nombre de quien llama y lo que quiere."  `person_id` (número): "El id de `find_pipedrive_person`. Omítelo si no se encontró a quien llama."  `value` (número): "El valor de la oportunidad, si quien llama indicó alguno." |

### Programar un seguimiento

| Campo                      | Valor                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre**                 | `create_pipedrive_followup`                                                                                                                                                                                                                                                                                                                                                                                          |
| **Descripción**            | "Programa una llamada del equipo siempre que prometas a quien llama un seguimiento."                                                                                                                                                                                                                                                                                                                                 |
| **Método**                 | POST                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **URL**                    | `https://api.pipedrive.com/api/v2/activities`                                                                                                                                                                                                                                                                                                                                                                        |
| **Cabeceras de solicitud** | `x-api-token`: tu token de API                                                                                                                                                                                                                                                                                                                                                                                       |
| **Parámetros del cuerpo**  | `subject` (cadena, obligatorio): "Por ejemplo: Llamar de nuevo a Jane Doe sobre un presupuesto de cocina."  `type` (cadena, obligatorio): "Siempre el valor exacto `call`."  `due_date` (cadena, obligatorio): "La fecha de seguimiento como AAAA-MM-DD."  `note` (cadena, obligatorio): "El nombre, número de teléfono y necesidad de quien llama."  `deal_id` (número): "El id de la oportunidad, si abriste una." |

Selecciona **Activar** en cada herramienta y después [prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) con una llamada para pedir un presupuesto.

## Limitaciones

Las herramientas de webhook envían valores planos y Pipedrive almacena los números de teléfono de una persona como una lista anidada. Por eso, estas herramientas no pueden crear un contacto nuevo con un número de teléfono. En su lugar, la nota del seguimiento conserva el número de quien llama. Para crear contactos, usa la acción **Create Person** de Pipedrive mediante [Zapier](/docs/es/reception-ai/integrations/zapier).

## Solución de problemas

| Problema                                 | Qué comprobar                                                                                                                           |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| 401 de Pipedrive                         | La cabecera debe llamarse `x-api-token` y contener un token vigente.                                                                    |
| No se encuentra a quienes ya han llamado | Pipedrive compara los números de teléfono tal como están almacenados. Guarda los números en un solo formato o busca también por nombre. |
| El seguimiento no tiene tipo             | `call` debe ser un tipo de actividad en tu cuenta de Pipedrive. Comprueba **Company settings** → **Activities**.                        |