Skip to content

Airbyte · Hubspot (CRM comercial)

Replica el CRM de Hubspot a solvento-data-prod.hubspot.* mediante un conector SaaS de Airbyte (API de Hubspot), cada ~30 min.

En reemplazo por Lightfield (2026-10)

El CRM pasó a Lightfield: lo nuevo vive en Airbyte · Lightfield → solvento-adv-analytics-prod.lightfield.* (dbt-etls), con la tabla de equivalencias HubSpot → Lightfield. hubspot.* sigue sincronizando mientras la cuenta esté activa y queda como historia previa al corte: solo 2.917 de los 13.109 deals se migraron.

¿Llegaste hasta acá desde…?

Usa esta tabla para entrar en sentido inverso (lo que ves → de dónde sale):

Si ves… Eso sale de… La lógica está en…
Embudo / funnel de ventas en analytics comercial solvento-data-prod.hubspot.deals (RAW) dbt-analytics → models/staging/hubspot/stg_hubspot__funnel_deals.sql
Deals, contactos o empresas del CRM solvento-data-prod.hubspot.{deals,contact,company} (RAW) dbt-analytics → models/staging/hubspot/
Una tabla hubspot.* cruda / sin tipar solvento-data-prod.hubspot.* (RAW) Ingesta vía Airbyte (sin lógica de negocio); ver "Paso a paso"

Resumen

Campo Valor
Origen API de Hubspot (CRM)
Patrón Airbyte (conector SaaS) — sin lógica de negocio en la ingesta
Destino solvento-data-prod.hubspot.*
Frecuencia Sync cada ~30 min
Criticidad 🟢 Baja — CRM / analytics comercial
Dueño Gero (Airbyte) · transformaciones: Diego (dbt-analytics)
Repos (servicio gestionado — sin repo; configurado en consola de Airbyte)

Diagrama de linaje

graph LR
    SRC[["📨 Hubspot<br/>API CRM"]]

    subgraph ing["1 · Ingesta (sin lógica de negocio)"]
        AB["Airbyte<br/>conector SaaS Hubspot"]
        RAW[("solvento-data-prod<br/>hubspot.* · RAW")]
    end

    subgraph logica["2 · Lógica de negocio · dbt-analytics"]
        M1["stg_hubspot__deals.sql"]
        M2["stg_hubspot__funnel_deals.sql<br/><i>embudo por etapa</i>"]
        M3["stg_hubspot__contacts / company"]
    end

    CONS["📈 Analytics comercial<br/>Metabase / embudo"]

    SRC -->|"API · ~30 min"| AB --> RAW
    RAW --> M1 --> M2 --> CONS
    RAW --> M3 --> CONS

    classDef src fill:#fde68a,stroke:#b45309,color:#000;
    classDef store fill:#bfdbfe,stroke:#1e40af,color:#000;
    classDef logic fill:#dcfce7,stroke:#15803d,color:#000;
    class SRC src;
    class RAW store;
    class M1,M2,M3 logic;

Paso a paso

1 · Ingesta (mueve datos, no aplica lógica de negocio)

  1. Hubspot expone el CRM vía su API.
  2. Airbyte corre un conector SaaS de Hubspot configurado en la consola de Airbyte (no hay repo de código). Cada ~30 min lanza un sync que extrae deals, contactos, empresas, owners, etc.
  3. Airbyte escribe los datos crudos en solvento-data-prod.hubspot.*. La ingesta solo replica; no aplica reglas de negocio.

Nota: estas fuentes migraron de la pipeline Matia a Airbyte el 2026-02-02; con el cambio cambiaron nombres de tablas, columnas de metadata y nombres de columnas.

2 · Lógica de negocio (dbt — aquí están las reglas) → repo dbt-analytics

  1. stg_hubspot__deals.sql — limpia y tipa los deals (tabla muy ancha).
  2. stg_hubspot__funnel_deals.sql — arma el embudo (funnel) por etapa del pipeline comercial.
  3. stg_hubspot__contacts.sql / stg_hubspot__company.sql — staging de contactos y empresas.

3 · Consumo

  • Analytics comercial (Metabase / modelos de embudo de ventas) lee de los modelos de models/staging/hubspot.

Tablas que alimenta

Tabla Contenido Job que la carga
hubspot.deals Deals del CRM (una fila por deal, ~1,100 columnas) Airbyte (conector SaaS Hubspot)
hubspot.contact Contactos del CRM Airbyte (conector SaaS Hubspot)
hubspot.company Empresas / cuentas del CRM Airbyte (conector SaaS Hubspot)
hubspot.deal_company Relación deal ↔ empresa Airbyte (conector SaaS Hubspot)
hubspot.owners Owners (responsables comerciales) Airbyte (conector SaaS Hubspot)

Consumo aguas abajo

  • Analytics comercial / equipo de ventas vía dbt-analytics (models/staging/hubspot) y Metabase.

Si falla 🛠️

Impacto: 🟢 bajo. Afecta analytics comercial (embudo, deals). No bloquea operación ni producto.

Síntoma Dónde mirar Acción
hubspot.* no se actualiza UI de Airbyte — estado y hora del último sync de la conexión Hubspot Revisar logs del sync; reintentar el sync manualmente
El sync falla con error de auth Credenciales del conector Hubspot en la consola de Airbyte Verificar/renovar token/credenciales del conector
El sync falla por conectividad Logs de Airbyte (API Hubspot) Verificar conectividad/disponibilidad de la API de Hubspot; reintentar
Números "raros" en el embudo Lógica en dbt-analytics (stg_hubspot__funnel_deals.sql) Revisar la transformación en el repo, no la ingesta

Escalación: Airbyte → Gero · lógica SQL / Metabase → Diego · resto → Martin.

Enlaces

  • 📊 Estado en vivo: dashboard "Data Processes" (Cloud Monitoring)
  • ⚙️ Configuración de la ingesta: consola de Airbyte → conexión Hubspot (servicio gestionado, sin repo)
  • 🧮 Lógica: dbt-analytics — modelos en models/staging/hubspot/

Última actualización: 2026-10-05 (en reemplazo por Lightfield) · Si cambia el flujo o un modelo dbt, actualizar esta ficha en el mismo MR.