Integración con HubSpot

La integración nativa con HubSpot te permite mantener tu cartera comercial sincronizada en ambos sentidos sin scripts ni Zapiers intermedios. Soporta HubSpot Free, Starter, Pro y Enterprise.

1. Pre-requisitos

Antes de conectar necesitas:

• Usuario LeadsBase con rol owner o admin.
• Usuario HubSpot con permiso crm.objects.companies.write y crm.objects.contacts.write.
• Plan LeadsBase Pro o superior. En Starter solo está disponible el export manual.

2. Conectar la cuenta

En LeadsBase ve a Ajustes → Integraciones → HubSpot → Conectar. Te redirigimos al login OAuth de HubSpot. Acepta los scopes solicitados (lectura/escritura de companies, contacts, lists y owners) y vuelves a LeadsBase con la conexión activa.

Si tu HubSpot tiene 2FA obligatorio, el flujo OAuth funciona igual y no requiere generar API key manualmente.

3. Configurar el mapeo de campos

En Integraciones → HubSpot → Campos define qué campo de LeadsBase corresponde a cada propiedad de HubSpot:

• cif → hs_tax_id (o propiedad personalizada).
• razon_social → name.
• cnae → industry o propiedad personalizada.
• empleados_tramo → numberofemployees.
• facturacion_anual → annualrevenue.
• decisor_email → contact email (crea contact asociado).

Los campos sin equivalente directo se mapean a propiedades custom que creamos automáticamente al primer sync.

4. Reglas de sincronización

Configura el comportamiento bidireccional:

• LeadsBase → HubSpot: enviamos updates de tu cartera enriquecida cada hora. Solo creamos companies en HubSpot que aún no existan (match por CIF). Nunca sobreescribimos campos rellenados por humanos sin tu permiso explícito.
• HubSpot → LeadsBase: leemos los lifecycle stages y owners para mostrarlos en LeadsBase. No sincronizamos contactos sensibles (B2C) a la inversa.

5. Listas dinámicas como segmentos

Cada mapa o lista de LeadsBase se puede exportar como lista activa de HubSpot. La lista se refresca automáticamente cuando cambian los criterios en LeadsBase:

LeadsBase: mapa "Tech Madrid 50-249 empleados"
   → HubSpot: lista activa "LB_TechMadrid_5250"

Útil para campañas de email marketing dirigidas a segmentos vivos.

6. Logs y resolución de errores

En Integraciones → HubSpot → Logs ves cada acción del sync con timestamp, registro afectado y resultado. Si HubSpot devuelve error (rate limit, propiedad inexistente, etc.) lo reintenta automáticamente 3 veces con backoff exponencial.

Errores frecuentes:

• PROPERTY_DOESNT_EXIST: una propiedad mapeada se eliminó manualmente en HubSpot. Vuelve a Campos y créala.
• RATE_LIMIT_EXCEEDED: alcanzaste el límite diario de HubSpot (100k requests/día en Pro). Pausamos el sync hasta el día siguiente.
• INSUFFICIENT_SCOPES: el OAuth caducó. Vuelve a Conectar para refrescar.

7. Desconectar

Para desconectar pulsa Desconectar en la página de la integración. Los registros ya sincronizados permanecen en HubSpot (no los eliminamos al desconectar). Si quieres borrarlos hazlo manualmente en HubSpot o con un workflow.

El sync nunca toca campos que tú has editado manualmente en HubSpot. Detectamos el último editor de cada propiedad y respetamos los cambios humanos sobre los nuestros.

Si trabajas con Pipedrive, ver integración Pipedrive. Para notificaciones de eventos en Slack, ver Slack.