Seguimiento de clics en Pipedrive: deals generados desde short links

El seguimiento de clics de Pipedrive en Elido convierte los hitos de los short links en eventos de pipeline. Cuando uno de tus links supera 100, 1.000 o 10.000 clics, un cron de 5 minutos crea un deal en la pipeline y el stage de Pipedrive que elegiste, con el slug del link, la fuente UTM y un enlace directo a Elido en las notas del deal. Sin Zapier en medio, sin exportaciones manuales, sin recordatorios en el calendario para revisar informes de links.

Eso es el titular. La mecánica importa más, así que este artículo recorre las tres cosas que los equipos de sales ops necesitan entender antes de activar esto. Primero, cómo funciona realmente el flujo de Connect: 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 link se vuelve viral de la noche a la mañana. Tercero, cómo extender la integración más allá de los tres umbrales predeterminados, hacia recuentos de clics personalizados, triggers con filtro UTM y campos personalizados de Pipedrive, usando el Elido SDK y un pequeño handler de webhook.

Pipedrive pasó a Live para Elido el 22 de mayo de 2026. Antes estuvo dos semanas en Beta mientras depurábamos casos extremos en torno a los IDs de stage y la rotación de tokens. El código de la integración vive en services/api-core/internal/integrations/pipedrive/ si alojas tu propio servidor y quieres leer el código fuente. Todo en este artículo corresponde a lo que está publicado, no a una hoja de ruta.

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 primero una cosa: un token de API personal. Lo obtienes desde tu cuenta de Pipedrive abriendo el menú de perfil, eligiendo Preferencias personales y luego la pestaña API. La propia guía de Pipedrive sobre how to find the Personal API token tiene el camino exacto con capturas de pantalla, ya que su interfaz cambia cada trimestre aproximadamente.

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 indica a qué empresa de Pipedrive pertenece. También obtiene la lista de pipelines y stages de esa empresa, para que el siguiente paso del modal muestre opciones reales, no campos de texto libre.

El modal hace entonces dos preguntas más. ¿En qué pipeline deben aterrizar los nuevos deals? ¿En qué stage de esa pipeline? Los desplegables se rellenan con tus datos en vivo de Pipedrive. Si tienes tres pipelines llamadas Inbound, Outbound y Partners, verás esas tres. Elige la que encaje con el trabajo - normalmente Inbound para señales de marketing - y luego elige el primer stage de cualificación. Haz clic en Conectar.

Qué pasa con el token después de conectar. Elido lo cifra antes de que llegue a Postgres, usando cifrado de sobre con una clave de cifrado de datos por inquilino envuelta por una clave KMS de workspace. El blob cifrado es lo que reside en la tabla integration_credentials. El token en texto plano solo existe en memoria durante el ciclo de vida de una única llamada a la API y nunca se registra en logs, ni siquiera en modo debug. Si rotas el token en Pipedrive, la próxima ejecución del cron recibe un 401 y Elido marca la integración como pendiente de reautenticación, lo que aparece como un banner en el workspace, no como un fallo silencioso. La higiene de rotación es tu responsabilidad; el fallo es ruidoso.

El selector de pipeline es un detalle pequeño pero importante. Un fallo frecuente en las integraciones CRM es crear deals en la pipeline equivocada porque la integración se construyó cuando la empresa tenía una pipeline y ahora tiene seis. Dejar que el usuario elija al conectar, y mostrar la lista actual en lugar de una caché de hace un mes, elimina toda esa clase de errores. 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 tick hace tres cosas en orden, por workspace que tenga Pipedrive conectado.

Primero, pregunta a ClickHouse los totales de clics por link actualizados en los últimos seis minutos, más un buffer de un minuto para cubrir eventos tardíos. ClickHouse almacena los eventos de clic en una tabla clicks particionada por fecha, y el rollup que consultamos es una vista materializada indexada por ID de short link. La consulta devuelve links cuyos totales cambiaron desde la última ejecución del cron, no la tabla completa. En un workspace con 50.000 links activos y un patrón de clics normal, esta consulta se mantiene por debajo de 200 ms.

Segundo, compara el nuevo total de cada link con los umbrales registrados. Los umbrales predeterminados son 100, 1.000 y 10.000. Para cada link, Elido rastrea el umbral más alto alcanzado en una pequeña fila link_threshold_state indexada por ID de link. Si un link estaba en 80 clics en la última ejecución y ahora está en 240, la comparación muestra que el umbral de 100 fue cruzado y el de 1.000 aún no. Marcamos 100 como alcanzado y ponemos en cola una creación de deal. Si un link saltó de 80 a 1.200, se cruzaron tanto 100 como 1.000, así que ponemos dos creaciones en cola.

Tercero, para cada deal en cola, Elido llama a la API de Deals de Pipedrive con un POST a /deals. El cuerpo establece el ID de pipeline y el ID de stage del selector de conexión, nombra el deal de forma legible como Link <slug> alcanzó <umbral> clics, y escribe la fuente UTM, el medio y la campaña en la nota del deal junto con un enlace clicable de vuelta a la vista de analytics de Elido para ese link. También guardamos el ID del link en un campo personalizado de Pipedrive si el workspace tiene uno configurado, lo que permite consultar Pipedrive más tarde por todos los deals vinculados a un link de Elido específico.

Algunas cosas que este cron no hace. No reintenta indefinidamente los errores 5xx de Pipedrive. Si Pipedrive devuelve 500 o 503, reintentamos dos veces con backoff exponencial dentro del mismo tick del cron y luego dejamos el trabajo para el próximo tick. El límite de velocidad de Pipedrive es de 100 solicitudes por 2 segundos por token de empresa en la práctica, lo que es margen suficiente para los volúmenes que la mayoría de equipos alcanzará. Tampoco creamos deals para links marcados como test, internos o de un miembro del workspace que haya optado por no participar en la sincronización CRM a través de su configuración personal.

La prevención de duplicados fue la parte que más iteración requirió. La primera versión tenía una condición de carrera: si dos pods del cron corrían solapados, ambos podían ver el mismo link cruzar 100 y ambos podían hacer POST de un deal. Lo resolvimos con un advisory lock de Postgres sobre el ID de workspace al inicio de cada tick del cron, más una restricción única en (link_id, threshold) en link_threshold_state. Si el segundo pod intenta insertar una fila duplicada, Postgres la rechaza y el POST en cola se descarta antes de llegar a Pipedrive. Doble seguro.

Ir más allá de los tres umbrales predeterminados

Los umbrales incluidos son 100, 1.000 y 10.000. La mayoría de equipos los mantienen porque encajan naturalmente en una narrativa de ventas. Cien clics son una señal suave que vale la pena revisar. Mil es una campaña que merece una llamada. Diez mil es suficientemente caliente para que un comercial ya esté en movimiento. Dicho esto, puede que quieras números diferentes, y el SDK lo soporta.

La integración de Pipedrive de Elido acepta una lista de umbrales personalizada a nivel de workspace. Se establece a través del endpoint PATCH /v1/workspaces/:id/integrations/pipedrive con un cuerpo JSON como {"thresholds": [50, 500, 5000, 50000]}. El cron toma la nueva lista en el siguiente tick. La tabla de estado preserva el historial, así que cambiar los umbrales no crea deals retroactivamente, solo cambia qué cruces futuros disparan un evento.

Para triggers más ricos, el SDK expone un hook CreateDeal que puedes registrar desde cualquier servicio. El caso clásico: crear un deal solo cuando un link supera un umbral Y la fuente UTM es tu campaña de social de pago, no tu blog orgánico. Eso es un filtro de una línea dentro del hook. Otro caso frecuente: disparar solo en links dentro de una carpeta específica de Elido, porque esa carpeta es tu carpeta de campaña y todo lo demás es ruido. El mismo hook también puede establecer campos personalizados de Pipedrive como Fuente del Deal, Canal del Lead o la taxonomía que use tu equipo de sales ops. La guía de reenvío de conversiones cubre el mismo patrón de hook para plataformas de anuncios; el caso de Pipedrive es estructuralmente idéntico.

Una nota sobre los campos personalizados. El SDK acepta tanto la etiqueta legible como la clave de API hasheada que Pipedrive usa internamente. Si referencias una etiqueta que no existe en la empresa conectada, el deal se crea igualmente y el campo faltante se registra como advertencia, nunca como error. Un campo personalizado faltante no debe bloquear una señal de ventas real.

Los equipos con muchos links por campaña a veces quieren acumular umbrales en una carpeta. Establece aggregation: "folder" en la configuración de integración del workspace y el cron agrupa los totales de clics por carpeta, luego comprueba la suma. El deal nombra la carpeta y lista los tres links con mayor contribución en las notas.

Dónde vive el token y cómo rotarlo

Una sección breve porque surge en cada revisión de seguridad. El token de API personal se cifra en reposo usando AES-256-GCM con una clave de cifrado de datos por inquilino. La DEK está a su vez envuelta por una clave de nivel de workspace en nuestro KMS, y solo el proceso api-core puede desempaquetarla. No hay token en texto plano en ningún log, copia de seguridad o traza de error. Lo probamos con una inyección de fallos que forzó un 401 de Pipedrive a mitad de solicitud, y la ruta de error limpia 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. La integración valida el nuevo token, lo reemplaza y el próximo tick del cron lo usa. Si olvidas actualizar Elido después de revocar el token antiguo, el próximo tick del cron recibe un 401 y la integración entra en estado Necesita Reautenticación, visible como un banner amarillo en el dashboard del workspace. Sin tokens muertos silenciosos.

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

Cómo encaja esto en un funnel más amplio

Los triggers de deals de Pipedrive desde clics son una pieza de un patrón más grande. Los recuentos de clics son un indicador adelantado, no un número 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 ha hecho su trabajo, ventas lo recoge. Desde ahí tus flujos normales de Pipedrive se hacen cargo: asignar el deal a un comercial, puntuarlo, moverlo por los stages, cerrarlo.

Si también estás reenviando conversiones a plataformas de anuncios, los mismos datos de clics alimentan ambos flujos. El feature de seguimiento de conversiones gestiona el lado de los anuncios, la integración de Pipedrive gestiona el lado CRM, y los dos nunca compiten por el mismo evento. Vemos esta combinación con más frecuencia en la página de soluciones para marketers, donde todo el stack va desde adquisición de pago a links con marca y luego a un funnel CRM.

Para los analistas que quieren mantener sus números honestos, dos artículos anteriores cubren las preocupaciones aguas arriba. Short link analytics: what to measure cubre qué métricas de clics correlacionan realmente con los ingresos, y Track UTM end to end cubre la higiene UTM que hace que las notas del deal sean útiles en lugar de ruidosas. Ambos se complementan bien con esta integración, ya que el deal que crea Pipedrive es tan útil como los datos 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 pruebas, pero el cron no se activa para links gratuitos. La página de precios tiene el desglose por nivel.

Lista de verificación de configuración

Imprímela, hazlo una vez.

1. En Pipedrive: menú de perfil, Preferencias personales, pestaña API, copiar el token.
2. En Elido: Integraciones, tarjeta de Pipedrive, Conectar.
3. Pegar el token. Esperar la validación.
4. Elegir la pipeline y el stage. Por defecto: Inbound y el primer stage de cualificación.
5. Hacer clic en Conectar.
6. Opcional: editar la lista de umbrales si 100/1k/10k no encaja con tu proceso de ventas.
7. Opcional: registrar un hook CreateDeal personalizado para filtros UTM o acumulaciones de carpetas.
8. Esperar cinco minutos. Enviar algunos clics de prueba. Ver llegar el primer deal.

Eso es todo. Si haces self-hosting, también querrás verificar que el cron está habilitado comprobando que kubectl get cronjob api-core-click-threshold-hook devuelve un horario activo. En Elido Cloud el cron está gestionado para ti.