Seguimiento de clics de Pipedrive: deals a partir de hitos de enlaces

El seguimiento de clics de Pipedrive en Elido convierte los hitos de enlaces cortos en eventos de pipeline. Cuando uno de tus enlaces supera los 100, 1.000 o 10.000 clics, un cron de 5 minutos crea un deal en el pipeline de Pipedrive que elegiste, titulado con el slug del enlace y el hito. Está previsto que las notas del deal incluyan el UTM source y un enlace directo de vuelta a Elido. Nada de Zapier en medio, nada de exportación manual, ningún recordatorio en el calendario para revisar los informes de enlaces.

Ese es el titular. Los detalles importan más, así que este artículo recorre las tres cosas que los equipos de operaciones de ventas necesitan confirmar antes de activar esto. Primero, cómo funciona realmente el flujo de conexión: dónde vive el token de API personal, qué lee el selector de pipeline y cómo se almacena el token después de pegarlo. Segundo, qué hace el cron de umbral en cada ejecución y cómo evita crear deals duplicados cuando un enlace se vuelve viral de la noche a la mañana. Tercero, qué puedes y no puedes cambiar más allá de los tres umbrales por defecto, y qué está previsto a continuación.

Pipedrive pasó a estado Live para Elido el 22 de mayo de 2026. Antes de eso estuvo dos semanas en Beta mientras resolvíamos casos límite en torno a los IDs de etapa y la rotación de tokens. El código de la integración vive en services/api-core/internal/integrations/pipedrive/ si haces self-host y quieres leer el código fuente. Cuando algo más abajo está previsto en vez de disponible, el artículo lo indica.

Conectar Pipedrive en dos minutos

Abre el catálogo de integraciones en tu workspace de Elido y haz clic en la tarjeta de Pipedrive. El modal de conexión pide una cosa primero: un token de API personal. Lo obtienes desde tu cuenta de Pipedrive abriendo el menú de perfil, eligiendo Personal preferences y luego la pestaña API. La propia guía de Pipedrive sobre cómo encontrar el token de API personal tiene la ruta exacta con capturas de pantalla, ya que su interfaz cambia cada trimestre más o menos.

Pega el token. Elido hace dos cosas en segundo plano. Valida el token llamando a GET /users/me contra la API de Pipedrive, lo que confirma que el token está activo y nos dice a qué empresa de Pipedrive pertenece. También trae la lista de pipelines activos de esa empresa, así el siguiente paso del modal muestra opciones reales, no campos de texto libre.

El modal hace entonces una pregunta más: ¿en qué pipeline deben caer los nuevos deals? El desplegable se completa con tus datos reales de Pipedrive. Si tienes tres pipelines llamados Inbound, Outbound y Partners, verás esos tres. Elige el que encaje con el trabajo, normalmente Inbound para señales impulsadas por marketing, y haz clic en Connect. Los deals caen en la primera etapa de ese pipeline; elegir una etapa de destino distinta está previsto.

Qué pasa con el token tras la conexión. Elido lo cifra antes de que toque Postgres, usando cifrado de sobre con una clave de cifrado de datos por tenant envuelta por una clave KMS del workspace. Lo que se guarda en la tabla integration_credentials es el blob envuelto. El token en texto plano solo existe en memoria durante la vida de una única llamada a la API, y nunca lo registramos, ni siquiera con verbosidad de depuración. Si rotas el token en Pipedrive, la siguiente ejecución del cron recibe un 401 y Elido marca la integración como necesitada de reautenticación, lo que se muestra como un banner en el workspace, no como un fallo silencioso. La higiene de rotación depende de ti, el fallo es ruidoso.

El selector de pipeline es un detalle pequeño pero importante. Un fallo habitual en las integraciones de CRM es crear deals en el pipeline equivocado porque la integración se construyó cuando la empresa tenía un solo pipeline y ahora tiene seis. Dejar que el usuario elija al conectar, y mostrar la lista actual en lugar de una guardada en caché de hace un mes, elimina toda esa clase de error. También puedes reconectar en cualquier momento para cambiar el destino del selector sin perder el historial de umbrales.

Qué hace realmente el cron de 5 minutos

Dentro de services/api-core hay un job llamado click_threshold_hook. Se ejecuta cada cinco minutos. En cada ejecución hace tres cosas en orden, por cada workspace que tiene Pipedrive conectado.

Primero, lista los enlaces activos del workspace y lee el contador de clics en curso de cada uno, el mismo contador que el servicio de redirección incrementa en cada clic. Los enlaces eliminados e inactivos se omiten.

Segundo, compara el nuevo total de cada enlace con los umbrales registrados. Los umbrales por defecto son 100, 1.000 y 10.000. Para cada enlace, Elido registra cada umbral que ya produjo un deal en una fila de integration_pipedrive_deals indexada por workspace, enlace y umbral. Si un enlace estaba en 80 clics en la ejecución anterior y ahora está en 240, la comparación muestra que se cruzó el umbral de 100 y que el de 1.000 aún no se tocó. Marcamos el 100 como alcanzado y encolamos una creación de deal. Si un enlace saltó de 80 a 1.200, se cruzaron tanto el 100 como el 1.000, así que encolamos dos creaciones.

Tercero, por cada deal encolado, Elido llama a la API de Deals de Pipedrive con un POST a /deals. El cuerpo fija el ID de pipeline desde el selector de conexión, nombra el deal Engagement: <slug> (<threshold> clicks) y deja el valor en cero. Está previsto escribir el UTM source, medium y campaign en una nota del deal con un enlace de vuelta a la vista de analytics de Elido, y también guardar el ID del enlace en un campo personalizado de Pipedrive.

Hay algunas cosas que este cron no hace. No reintenta dentro de una misma ejecución. Si Pipedrive devuelve un error, no se registra nada para ese umbral, así que la siguiente ejecución simplemente lo intenta de nuevo. El límite de tasa de Pipedrive es en la práctica de 100 solicitudes cada 2 segundos por token de empresa, lo que da bastante margen para los volúmenes que la mayoría de los equipos van a alcanzar. Tampoco mira más que los enlaces activos, así que los enlaces eliminados o inactivos nunca crean deals.

La prevención de duplicados descansa en esa tabla. Antes de cada creación, el cron comprueba si existe una fila (workspace_id, link_id, threshold_bucket), y la inserción posterior está protegida por una restricción única sobre las mismas tres columnas, de modo que un fallo y una nueva ejecución no producen un segundo deal para el mismo hito.

Ampliar más allá de los tres valores por defecto

Los umbrales disponibles son 100, 1.000 y 10.000. La mayoría de los equipos los mantienen porque encajan de forma natural con una narrativa de ventas. Cien clics son una señal suave que merece un vistazo. Mil es una campaña que merece una llamada. Diez mil está lo bastante caliente como para que un comercial ya debería estar actuando. Dicho esto, puede que quieras otros números, y hoy no puedes configurarlos.

La integración de Pipedrive de Elido usa los mismos tres tramos para todos los workspaces, y todavía no hay endpoint ni opción para una lista de umbrales personalizada.

Los disparadores más ricos están en la hoja de ruta, no disponibles todavía. El plan de la integración incluye un disparador de umbral limitado a una campaña con un UTM candidato a deal, y un disparador de conversión que crea un deal con el valor del pedido capturado. Las etapas de destino configurables por el usuario y campos personalizados de Pipedrive como Deal Source o Lead Channel también están previstos para la próxima versión. Hasta que lleguen, si necesitas un filtro de UTM o una agregación por carpeta, consulta la API de analytics de Elido desde tu propio job y crea el deal a través de la API de Pipedrive tú mismo.

Dónde vive el token y cómo rotarlo

Una sección breve porque sale en toda revisión de seguridad. El token de API personal se cifra en reposo con AES-256-GCM usando una clave de cifrado de datos por tenant. Esa clave está a su vez envuelta por una clave a nivel de workspace en nuestro KMS, y solo el proceso api-core puede desenvolverla. No hay ningún token en texto plano en ningún log, ninguna copia de seguridad ni ninguna traza de error. Probamos esto con una inyección de fallos que forzó un 401 de Pipedrive a mitad de una solicitud, y la ruta de error elimina el token de la respuesta antes de que llegue a Sentry.

Para rotar: genera un nuevo token de API personal en Pipedrive, revoca el anterior y luego pega el nuevo en el modal de conexión de Elido otra vez. La integración valida el nuevo token, lo sustituye en su lugar, y la siguiente ejecución del cron lo usa. Si te olvidas de actualizar Elido después de revocar el token anterior, la siguiente ejecución del cron recibe un 401 y la integración pasa a un estado Needs Reauth, visible como un banner amarillo en el dashboard del workspace. Ningún token muerto en silencio.

En self-host el KMS es intercambiable: respaldado por archivo por defecto, o puedes usar HashiCorp Vault o el KMS de tu nube. El ADR-0036 lo cubre en detalle.

Dónde encaja esto en un embudo más amplio

Los disparadores de deals de Pipedrive a partir de clics son una pieza de un patrón más grande. Los conteos de clics son un indicador adelantado, no una cifra de ingresos, así que normalmente quieres que fluyan hacia un CRM donde vive el resto del contexto de ventas. El deal es el traspaso: marketing ya hizo su trabajo, ventas lo recoge. A partir de ahí, tus flujos normales de Pipedrive se hacen cargo: asignar el deal a un comercial, puntuarlo, moverlo por etapas, cerrarlo.

Si también estás reenviando conversiones a plataformas publicitarias, los mismos datos de clics alimentan ambos flujos. La función de seguimiento de conversiones se encarga del lado publicitario, la integración de Pipedrive del lado del CRM, y los dos nunca compiten por el mismo evento. Vemos esta combinación con más frecuencia en la página de solución para marketers, donde toda la pila es adquisición pagada hacia enlaces de marca hacia un embudo de CRM.

Para los analistas que quieren mantener sus números honestos, dos artículos anteriores cubren las preocupaciones previas en la cadena. Analítica de enlaces cortos: qué medir cubre qué métricas de clics realmente correlacionan con los ingresos, y Seguimiento de UTM de principio a fin cubre la higiene de UTM que hace que las notas del deal sean útiles en vez de ruido. Ambos combinan bien con esta integración, ya que el deal que crea Pipedrive es tan útil como los datos de UTM que lleva.

Un último detalle sobre planes. La integración de Pipedrive está disponible en todos los niveles de pago de Elido, y la prueba de 14 días la incluye para que puedas validar tu lista de umbrales antes de suscribirte. Los workspaces gratuitos pueden crear la conexión para probar, pero el cron no se dispara para enlaces gratuitos. La página de precios tiene el desglose por nivel.

Lista de configuración

Imprime esto, hazlo una vez.

1. En Pipedrive: menú de perfil, Personal preferences, pestaña API, copia el token.
2. En Elido: Integrations, tarjeta de Pipedrive, Connect.
3. Pega el token. Espera la validación.
4. Elige el pipeline. Por defecto Inbound; los deals caen en su primera etapa.
5. Haz clic en Connect.
6. Espera cinco minutos. Envía algunos clics de prueba. Observa cómo llega el primer deal.

Eso es todo. Si haces self-host, el cron se ejecuta dentro del proceso api-core en lugar de como un job separado, y necesita la conexión a Redis y la clave maestra de secretos configuradas; sin cualquiera de las dos, se salta en silencio. En Elido Cloud el cron está gestionado por nosotros.