¿Qué información se migra?
La integración permite sincronizar las siguientes entidades:
Contactos
Empresas
Productos
Deals / Oportunidades
Quotes / Presupuestos
Llamadas (asociadas a contactos o empresas)
Emails (se registran como notas)
Notas
Reuniones (se registran como check-ins)
Toda la información se copia desde HubSpot hacia Clientify.
No se envían datos desde Clientify a HubSpot.
Sentido de la sincronización
La sincronización es unidireccional:
HubSpot → Clientify
Clientify actúa como sistema destino de la migración.
Migración de contactos
Durante la migración:
Se utilizan los identificadores internos de HubSpot (
hs_object_id) para vincular los registros con Clientify.Se migran datos personales, de contacto, dirección y estado.
Se crean automáticamente campos personalizados para reflejar información propia de HubSpot, como:
Estado del lead
Etapa del ciclo de vida
Se añaden etiquetas de origen y la etiqueta “migracion hubspot” para identificar contactos migrados.
Si un contacto ya existe en Clientify, se compara la fecha de modificación y se actualiza únicamente si HubSpot tiene la información más reciente.
Migración de empresas
Las empresas se migran antes que los contactos cuando existe relación entre ellas, manteniendo la asociación correcta.
Se sincronizan:
Datos fiscales y de identificación
Dirección y datos de contacto
Estado y tipo de empresa
Migración de productos
Los productos se migran siempre que cumplan este requisito:
Deben tener un SKU configurado en HubSpot
Durante la migración:
El SKU se utiliza como campo clave de vinculación.
Los precios se sincronizan redondeados a 2 decimales.
Se importa la imagen del producto si está disponible.
Migración de deals / oportunidades
Las oportunidades se migran manteniendo:
Contactos asociados
Empresas asociadas
Productos vinculados al deal
Las oportunidades se crean en un pipeline específico llamado “hubspot”, con las siguientes etapas:
Abierto
Caducado
Ganado
Perdido
El estado del deal se calcula automáticamente en función de la información de HubSpot (probabilidad y fecha de cierre).
Migración de presupuestos (quotes)
Los presupuestos se migran como presupuestos en Clientify, incluyendo:
Contacto y empresa asociados
Fechas de creación y expiración
Líneas del presupuesto
Si una línea tiene SKU y el producto existe en Clientify, se sincroniza como producto.
En caso contrario, se crea como item independiente.
Llamadas, emails, notas y reuniones
Durante la migración también se sincroniza la actividad asociada:
Llamadas
Se migran llamadas entrantes y salientes.
Se incluyen fecha, resultado, comentarios y grabación si existe.
Emails
Se migran como notas en Clientify.
Se elimina automáticamente el texto “Powered by HubSpot” del cuerpo del email.
Notas
Se copian como notas asociadas al contacto correspondiente.
Reuniones
Se migran como check-ins.
Se incluye fecha, descripción y resultado de la reunión.
Modo de migración
La integración puede ejecutarse en dos modos:
Full: migra todos los registros disponibles.
Modified: migra únicamente los registros modificados en las últimas 24 horas.
Esto permite realizar una migración inicial completa y posteriores sincronizaciones incrementales.
Resolución de duplicados y conflictos
Para evitar duplicados:
Se valida el ID de integración.
En contactos, también se valida el email.
Si un registro existe en ambas plataformas:
Se compara la fecha de modificación.
Se conserva el registro más reciente.
Clientify nunca sobrescribe datos en HubSpot.
Configuración necesaria
Requisitos
Cuenta activa de HubSpot
Aplicación OAuth2 configurada en HubSpot
Refresh Token válido
API Key de Clientify
Permisos de lectura sobre las entidades a migrar
Configuración en HubSpot
Crear una aplicación privada.
Conceder permisos de lectura a contactos, empresas, productos, deals, quotes, llamadas, emails, notas y reuniones.
Obtener el refresh token OAuth2.
Configuración en Clientify
Acceder a Integraciones
Seleccionar HubSpot
Introducir:
Refresh Token de HubSpot
API Key de Clientify
Owner ID por defecto
Guardar la configuración
Los campos personalizados necesarios se crean automáticamente si no existen.
Consideraciones importantes
La migración respeta los límites de la API de HubSpot y puede incluir pausas.
Las asociaciones se migran manteniendo el orden correcto (empresas → contactos → actividad).
Si un producto de un deal no puede sincronizarse, el deal no se crea.
Existe un modo trial que limita el volumen de registros sincronizados.
Se pueden aplicar filtros por fecha para migraciones parciales.
