Conectar HubSpot con Elido

La integración de HubSpot reenvía los eventos de conversión de Elido a HubSpot como propiedades de contacto y actualizaciones de negocios. Cuando alguien hace clic en un enlace rastreado y completa un objetivo de conversión, Elido envía los datos de atribución (fuente UTM, campaña, ID de clic) a HubSpot — sin que tengas que escribir ningún código.

Conectar a través de OAuth#

1. Ve a Dashboard → Conversions → HubSpot → Connect HubSpot.
2. Se abre la pantalla de OAuth de HubSpot. Inicia sesión con una cuenta que tenga acceso a "CRM → Objects".
3. HubSpot muestra los alcances solicitados: crm.objects.contacts.write y crm.objects.deals.write. Estos permiten a Elido escribir en las propiedades de contacto y mover negocios a través de las etapas.
4. Haz clic en Connect app. HubSpot te redirige de vuelta a Elido.

Los tokens de actualización rotan automáticamente. Si revocas el acceso desde el lado de HubSpot (Settings → Connected Apps), Elido detiene inmediatamente el envío de eventos y muestra un error de "token revoked" en el registro de entrega.

Mapear campos#

Después de conectar, ve a Dashboard → Conversions → HubSpot → Configure:

1. Contact properties — elige en qué propiedades de contacto de HubSpot escribirá Elido. Campos disponibles de Elido: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Deal stage — selecciona el pipeline y la etapa a la que un evento de conversión mueve un negocio. Deja en blanco si no utilizas negocios de HubSpot.
3. Match contact by — correo electrónico (si capturas el correo electrónico a través de tu página de destino) o ID de contacto de HubSpot (para atribución del lado del servidor donde pasas hs_contact_id en la URL).

Lo que Elido escribe en HubSpot#

Cada conversión crea un evento de línea de tiempo de HubSpot y (si está mapeado) actualiza las propiedades del contacto. La carga útil sin procesar que Elido envía:

{
  "event": "conversion.recorded",
  "click_id": "clk_abc123",
  "value": 99.0,
  "currency": "EUR",
  "utm": {
    "source": "newsletter",
    "medium": "email",
    "campaign": "spring-2026"
  }
}

HubSpot muestra esto como un evento de línea de tiempo personalizado en el registro de contacto. La actualización de la etapa del negocio (si está configurada) se dispara en la misma solicitud.

Lo que no se sincroniza#

• Click events without a conversion — los clics brutos no crean registros de HubSpot. Solo lo hacen las conversiones.
• Historical data — la integración es solo hacia adelante desde el momento en que te conectas.
• HubSpot → Elido — la integración es solo de salida. Los cambios en los negocios de HubSpot no se retroalimentan a Elido.

Solución de problemas#

Error "Insufficient permissions" — El usuario de HubSpot que autorizó no tenía acceso de escritura a CRM. Pídele a un superadministrador de HubSpot que vuelva a autorizar desde Dashboard → Conversions → HubSpot → Reconnect.

Contact not found — events dropped — Si Elido no puede encontrar un contacto coincidente por correo electrónico o ID, el evento se registra pero no se reenvía. Revisa Dashboard → Conversions → Delivery log para ver las entradas "no matching contact".

Conversions arriving with wrong campaign attribution — Verifica que los parámetros UTM estén presentes en la URL de destino. Elido los captura desde el clic; si el enlace no tiene UTMs, los campos de HubSpot estarán vacíos.

OAuth keeps expiring — HubSpot revoca los tokens para las aplicaciones que no llaman al endpoint de actualización en más de 6 meses. La integración de Elido se actualiza en cada evento. Si no has recibido ninguna conversión en meses, vuelve a conectarte manualmente.