Pipedrive
Conecte Pipedrive con su propia aplicación OAuth para que un agente pueda añadir notas y leer la actividad de una persona durante una llamada.
Qué conseguirá
Un agente podrá añadir notas en Pipedrive y leer la actividad de una persona.
Descripción general y casos de uso
- Añadir una nota sobre la llamada a una persona, un negocio o un lead.
- Revisar las actividades pasadas de una persona antes de responder.
Limitación. Pipedrive no tiene un objeto de tickets, así que los tickets no están disponibles. Crear un lead a partir de una llamada no se ofrece como herramienta de agente en Pipedrive, porque un lead de Pipedrive debe colgar de una persona o de una organización que quien llama no puede facilitar.
Requisitos previos
- Una cuenta de Pipedrive y una aplicación de desarrollador de Pipedrive (OAuth) en su Developer Hub.
Configuración de la cuenta externa (en Pipedrive)
Pipedrive controla estas pantallas. La guía de Pipedrive: Core API concepts.
- Cree una aplicación OAuth en el área de desarrolladores de Pipedrive.
- Fije su callback URL en la URL de redireccionamiento que muestra el cuadro Connect de Phynxa.
- Conceda los ámbitos (scopes) de abajo y copie el Client ID y el Client secret.
Conéctelo en Phynxa
- Integrations, Connect en Pipedrive.
- Pegue el Client ID y el Client secret.
- Continúe hasta Pipedrive y apruebe. La tarjeta muestra Connected.
Permisos y ajustes
Ámbitos solicitados: deals:full, contacts:full, activities:full, leads:full. Phynxa usa la API v2 de Pipedrive. La dirección de la API contiene el dominio propio de su empresa, que Pipedrive devuelve con el token.
Úselo en una llamada
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Add note | Añade una nota a una persona, un negocio, un lead o una organización (indíquele el id). | En segundo plano |
| Fetch customer history | Enumera las actividades de una persona. Necesita un person id. | Espera |
| Update contact | Cambia el nombre, el correo, el teléfono o la empresa de un contacto; solo se cambia lo que indique. Necesita el id del contacto de una consulta de historial. | En segundo plano |
| Create task | Crea una tarea de seguimiento para su equipo (subject, y opcionales body y due_date como 2026-11-02), vinculada a un contacto si indica su id. | En segundo plano |
Pruébelo
Test connection en la tarjeta. Después pida a un agente en Chat que añada una nota y revise la persona en Pipedrive.
Resultado esperado
La nota aparece en el registro de Pipedrive y la tarjeta cuenta un éxito.
Solución de problemas
- Error de redireccionamiento o de cliente. La callback URL debe coincidir exactamente.
- «A person_id is needed.» El historial necesita un id que el agente suele no tener.
- 403. A la aplicación le falta un ámbito; añádalo y use Reconnect.
Seguridad y credenciales
El client secret se almacena cifrado. Remove elimina la conexión; desinstale la aplicación en Pipedrive para revocarla.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.