Pipedrive | ElevenLabs Documentation

Con las herramientas de webhook 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 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.

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.