La mayoría de los CRM se conforman con una sola clave de API. Pipedrive quiere dos cosas: un token de API personal que pertenece a un usuario y no a la empresa, y el dominio de empresa en el que responde tu cuenta, porque cada cuenta de Pipedrive tiene su propia dirección de API. Con ambos en su sitio, los contactos capturados llegan como Personas de Pipedrive. Calcula unos 90 segundos.
Qué pide Pipedrive y por qué
- Un token de API personal. Pipedrive emite un token por usuario, no por aplicación. Está limitado a tu usuario de Pipedrive, así que las Personas que crea te pertenecen y heredan exactamente tus permisos. Si eres administrador, eso es todo.
- El dominio de tu empresa. Pipedrive enruta el tráfico de la API por el subdominio propio de tu cuenta: las solicitudes van a
tuempresa.pipedrive.com, no a un host de API compartido. Anexus necesita esa dirección para saber a dónde enviarlas, y por eso esta integración tiene un segundo campo donde la mayoría de los CRM solo tiene uno. - Cualquier plan de Pipedrive sirve, prueba gratuita incluida. La autenticación por token es independiente de tu método de inicio de sesión, así que una cuenta que entra con Google o con inicio de sesión único SAML funciona igual.
Paso 1 — Copia tu token de API personal
En Pipedrive, haz clic en tu avatar de perfil (arriba a la derecha) → Preferencias personales.
Cambia a la pestaña API.
Copia el valor de Tu token de API personal. Es una cadena de 40 caracteres con letras y dígitos.
Esto no es un flujo de "crear una aplicación". No hay cliente OAuth que registrar, ni permisos que marcar, ni URL de retorno. Si has acabado en el Developer Hub de Pipedrive creando una aplicación pública, te has pasado una puerta: vuelve a Preferencias personales.
Paso 2 — Lee el dominio de empresa en tu barra de direcciones
La URL con la que inicias sesión en Pipedrive se ve así: https://tuempresa.pipedrive.com. Anexus quiere solo el host: tuempresa.pipedrive.com — sin https://, sin ruta y sin barra final.
Un administrador de Pipedrive puede renombrar ese subdominio más adelante en Configuración de la empresa. La dirección de la API sigue ese cambio, así que si tu equipo alguna vez cambia la URL de Pipedrive, vuelve y actualiza este campo.
Paso 3 — Pega ambos en Anexus
En Anexus, ve a Ajustes → Integraciones CRM → Pipedrive → Conectar.
Completa:
- Dominio de empresa:
tuempresa.pipedrive.com - Token de API personal: la cadena de 40 caracteres
Haz clic en Guardar y conectar.
Dónde aterrizan los contactos: la lista Personas, no la bandeja de leads
Pipedrive mantiene dos zonas separadas que a primera vista se parecen: la bandeja de entrada de leads, una lista de espera para leads sin calificar, y Contactos → Personas, la libreta de direcciones con las fichas de Persona. Los contactos nuevos de Anexus van a Contactos → Personas. Ordena esa vista por Fecha de adición descendente, o filtra por "Agregados recientemente", y tus capturas más nuevas quedarán arriba.
Mapeo de campos: del formulario de captura a la Persona de Pipedrive
Cada contacto capturado se convierte en una Persona de Pipedrive. Esto es qué va a dónde, y la particularidad de Pipedrive detrás de cada fila.
| Capturado por Anexus | Llega a Pipedrive como | Conviene saber |
|---|---|---|
| Nombre + apellido | Persona → Nombre | Una Persona de Pipedrive guarda un único campo Nombre combinado, no columnas separadas de nombre y apellido. |
| Correo electrónico | Persona → Correo, marcado como principal con la etiqueta "trabajo" | Una Persona puede contener varias direcciones de correo; cada una lleva una etiqueta (trabajo / casa / otro) y solo una se marca como principal. |
| Teléfono (si se proporciona) | Persona → Teléfono | El mismo modelo de valores múltiples que el correo: números con etiqueta y uno principal. Pipedrive no reformatea los números, así que marcarás exactamente lo que escribió el visitante. |
| Empresa (si se proporciona) | Persona → Organización | La Organización es un objeto de primer nivel en Pipedrive, no texto libre: el campo Organización de una Persona apunta a una ficha de Organización, y por eso los nombres de empresa se pueden buscar en Contactos → Organizaciones. |
| Cargo (si se proporciona) | Persona → cargo, si tu cuenta tiene ese campo | Los campos integrados de Persona en Pipedrive son Nombre, Organización, Correo, Teléfono y Etiqueta: el cargo no está entre ellos. La mayoría de los equipos agrega uno en Configuración de la empresa → Campos de datos → Persona. Si falta un cargo que esperabas en una Persona sincronizada, comprueba primero ahí que el campo exista. |
| Mensaje (si el visitante escribió uno) | Se envía junto con el contacto | Anexus envía el texto del mensaje junto con el resto de los datos capturados. No es uno de los campos integrados de Persona en Pipedrive, así que no esperes una columna para él en la vista de tabla de Personas. |
| Origen de la captura (toque NFC, escaneo QR, Apple Wallet, enlace compartido) | Una nota que indica el origen | Anexus registra cómo te llegó el contacto — un toque, un escaneo, un pase de Apple Wallet o un enlace compartido — para que después sepas de dónde salió una Persona. |
Los contactos sin una dirección de correo válida se omiten en lugar de enviarse, y las notas privadas que escribes en el Mini CRM de Anexus se quedan en Anexus.
Personas, Tratos y tu tablero de pipeline
Pipedrive está construido alrededor de los Tratos. Un Trato ocupa una Etapa de un Pipeline, y el tablero de pipeline es lo que la mayoría de los usuarios de Pipedrive mira todo el día. Las Personas y las Organizaciones son la libreta de direcciones detrás de ese tablero.
Una Persona por sí sola no aparece en ningún tablero de pipeline: en Pipedrive nada se muestra en el tablero hasta que se le adjunta un Trato. Así que decide de antemano quién abre el Trato para una captura nueva, y en qué Pipeline y Etapa entra.
La misma lógica aplica a las Actividades de Pipedrive. Toda la metodología de Pipedrive se basa en que cada Trato abierto lleve una próxima Actividad programada — una llamada, una reunión, un correo — y eso es lo que dispara sus recordatorios. Una Persona recién creada no lleva ninguna Actividad, así que Pipedrive nunca te la recordará. Si un contacto capturado importa, ponle una Actividad el mismo día en que lo conociste.
Duplicados y por qué Pipedrive los permite
Primero buscamos Personas existentes por correo electrónico, así que si el mismo visitante envía tu formulario dos veces se actualiza la Persona existente en lugar de crear una segunda.
Pipedrive, en cambio, no exige que los correos de las Personas sean únicos. Tu lista de Personas puede contener tres Personas con la misma dirección sin protestar, y Pipedrive solo las expone mediante su herramienta manual Combinar duplicados. Si tu lista ya está desordenada, haz esa limpieza antes de conectar: el correo es la clave con la que se hace la coincidencia, así que una lista limpia da resultados limpios.
Recuperar los contactos capturados antes de conectar
Haz clic en Sincronizar contactos anteriores en la tarjeta de Pipedrive para enviar todo lo capturado antes de la conexión, en lotes de 50 Personas.
Pipedrive mide el uso de la API por empresa, y cada integración que tengas — Zapier, Make, scripts propios, esta — consume del mismo presupuesto. Si un traspaso masivo coincide con otra herramienta haciendo trabajo por lotes, será Pipedrive quien frene el conjunto.
Solución de problemas de Pipedrive
"Pipedrive rechazó el token (verifica también el dominio de la empresa)"
Como hay dos campos, este mensaje tiene dos causas posibles:
- Error tipográfico en el token. Vuelve a copiarlo desde Preferencias personales → API. Un espacio final arrastrado al copiar es el culpable clásico.
- Formato de dominio incorrecto. Debe ser el host a secas
tuempresa.pipedrive.com— nohttps://tuempresa.pipedrive.com, ni un enlace profundo copiado desde un Trato, niapp.pipedrive.com. - Se renombró el subdominio. Si un administrador cambió la URL de la empresa en Configuración de la empresa, el token sigue siendo válido pero la dirección ya no resuelve. Inicia sesión, mira la barra de direcciones y pega el host nuevo.
Funcionaba ayer y hoy dejó de funcionar
La pantalla de API de Pipedrive tiene un botón Regenerar, y regenerar invalida al instante el token anterior. Quien lo haya pulsado — tú, o un administrador ordenando la seguridad — rompe de golpe todas las herramientas que usan ese token, porque Pipedrive da un token por usuario y no uno por integración. Lo mismo ocurre si ese usuario de Pipedrive se desactiva o pierde su asiento: el token muere con el usuario. Pulsa Probar en la tarjeta de Anexus para confirmarlo y luego pega un token nuevo.
El token se autentica pero no se crea nada
Un token personal lleva exactamente los permisos de su dueño y nada más. Si tu administrador de Pipedrive puso a tu usuario en un conjunto de permisos restringido, la conexión puede validarse sin problemas y aun así ser rechazada al escribir. Pide a un administrador que afloje tu conjunto de permisos, o conéctate con el token de un usuario autorizado a crear Personas y Organizaciones.
Tú ves las Personas nuevas, tus colegas no
Las Personas creadas con tu token pertenecen a tu usuario de Pipedrive. En cuentas que usan grupos de visibilidad, los compañeros fuera de tu grupo no las encontrarán en sus filtros: las fichas existen, simplemente no son visibles para esa persona. Cambia la visibilidad de la ficha, o reasigna el propietario, dentro de Pipedrive.
Desconectar y revocar el token de verdad
Haz clic en Desconectar en Anexus y dejamos de enviar a Pipedrive de inmediato. Las Personas ya creadas se quedan donde están.
Para revocar el acceso del lado de Pipedrive tienes que regenerar el token en Preferencias personales → API → Regenerar. Léelo como una advertencia, no como un paso: dado que Pipedrive emite un token por usuario, regenerarlo corta en ese mismo instante todas las demás integraciones conectadas en tu nombre. Si Zapier, Make o un script propio usa ese token, planifica volver a pegar el valor nuevo en todas partes antes de pulsarlo.