# Pipedrive

Conecta Pipedrive para que el agente reconozca a quien llama por su teléfono, cree personas y tratos, y registre cada llamada como nota

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Pipedrive se conecta con tu token de API personal. Una vez vinculado, el agente saluda por su nombre a los clientes conocidos teniendo a mano su último trato, crea una persona y un trato cuando alguien deja una solicitud, y escribe el resultado de cada llamada en la ficha del cliente.

## Qué puede hacer el agente [#what-the-assistant-can-do]

* **Reconocer a quien llama**: al inicio de una llamada busca el número de teléfono en Pipedrive y obtiene el nombre, email y organización de la persona, y su último trato (título, etapa, valor).
* **Crear un trato**: encuentra a la persona por teléfono o crea una nueva, y luego crea un trato en el pipeline y la etapa que elijas. La solicitud, la dirección de entrega, los productos y el anuncio que trajo al cliente van al trato como nota.
* **Registrar llamadas**: tras cada llamada añade una nota a la persona y a su trato: dirección, duración, resultado, resumen, el enlace a la grabación y, si quieres, la transcripción completa.

## Antes de empezar [#before-you-start]

* **Usuario de Pipedrive** cuyos permisos cubran los tratos que el agente debe ver y crear: el token actúa como este usuario.
* **Espacio de trabajo de HAPP** con al menos un agente.
* **Pipedrive activado para tu espacio de trabajo**: la integración se activa por empresa. Pide al soporte de HAPP que la active.

## Obtener el token de API [#get-the-api-token]

1. En Pipedrive haz clic en tu avatar y abre **Personal preferences > API**.
2. Copia **Tu token de API personal**.

## Conectar [#connect]

1. En HAPP abre **Integraciones** y busca Pipedrive en **Añadir un CRM**.
2. Haz clic en **Conectar**, pega el token y confirma.
3. Pipedrive aparece en **Mis integraciones** con el nombre de tu empresa.

## Configuración [#settings]

Abre el icono de engranaje de la tarjeta en la pestaña **Integraciones** del agente.

* **Buscar**: reconocer a quien llama por su teléfono.
* **Crear**: tratos. Elige el **pipeline**, la **etapa** y el **responsable**; sin ellos, el trato va a tu pipeline predeterminado. Sin responsable, los tratos pertenecen al usuario del token.
* **Notas de llamada**: una nota tras cada llamada. **Transcripción completa** añade el texto de la conversación.

## Límites [#limits]

* Pipedrive guarda los números de teléfono tal como se escribieron; el agente compara los últimos 9 dígitos, así que `050 111 22 33` y `+380501112233` son el mismo cliente.
* Un número que no está en Pipedrive no recibe nota de llamada: no hay registro al que adjuntarla.
* El token es personal: si ese usuario se desactiva, la integración deja de funcionar.

## Solución de problemas [#troubleshooting]

| Problema                                                                 | Causa                                          | Solución                                                               |
| ------------------------------------------------------------------------ | ---------------------------------------------- | ---------------------------------------------------------------------- |
| "Pipedrive rejected the API token"                                       | El token se regeneró o el usuario se desactivó | Copia el token actual y vuelve a hacer clic en **Conectar**.           |
| "The Pipedrive user behind this token has no permission for this action" | El usuario no puede ver ni crear estos tratos  | Usa el token de un usuario con los permisos de visibilidad necesarios. |
| "Pipedrive rate limit reached"                                           | Demasiadas peticiones a la vez                 | No hay que hacer nada: la siguiente petición pasa.                     |

## Desconectar [#disconnect]

Desconecta la tarjeta en HAPP. Para revocar el acceso por completo, regenera el token de API en **Personal preferences > API**. Las personas, tratos y notas que ya están en Pipedrive se mantienen.

## Siguiente [#next]

* [CRM](/docs/integrations/crm): todas las integraciones de CRM
* [Herramientas](/docs/agents/tools): lo que el agente llama durante las conversaciones