HubSpot es un CRM completo con hubs de marketing, ventas y servicio. Sigue los pasos a continuación para conectar HubSpot a Enginy y configurar la integración.
Para configurar tu integración de HubSpot:
Ve a Integrations y abre la pestaña All (o la pestaña Disabled).
Localiza la tarjeta de HubSpot y actívala usando el toggle switch.
Haz clic en el botón Configure de la tarjeta de HubSpot.
Se abre una ventana flotante de configuración con cuatro pasos secuenciales.
Importante: Solo puedes tener una integración de CRM activa a la vez. Si ya tienes otro CRM activo, desactívalo primero.
Paso 1: Sync Configuration
Este paso define cómo Enginy relaciona contactos y empresas con los registros de HubSpot para evitar duplicados y garantizar la integridad de los datos. Una sincronización significa que Enginy compara sus registros con los de HubSpot usando los identificadores que configures aquí.
Integration User
Muestra la dirección de correo electrónico del usuario de la integración API.
Contact Identifier
Elige cómo Enginy determina si un contacto ya existe en tu HubSpot.
Opción | Lógica de coincidencia |
First name + Last name + Company name | Un contacto coincide cuando los tres campos son iguales en Enginy y en HubSpot. |
LinkedIn profile URL OR First name + Last name + Company name | Un contacto coincide si la URL del perfil de LinkedIn es la misma o si coinciden los tres campos de nombre/empresa. |
Custom Mapping | Abre un pop-up donde defines condiciones personalizadas con lógica AND/OR (por ejemplo, coincidencia por First Name AND Last Name, OR por Professional Email). |
Company Identifier
Elige cómo Enginy determina si una empresa ya existe en tu HubSpot.
Opción | Lógica de coincidencia |
Domain | Coincide por el dominio de la empresa (p. ej., |
Domain or Company Name | Coincide si el dominio o el nombre de la empresa son iguales. |
Custom Mapping | Abre un pop-up donde defines condiciones personalizadas (por ejemplo, coincidencia por Domain OR Company LinkedIn URL). |
General
En la sección General encontrarás dos toggles que controlan cómo se gestionan las asociaciones durante la exportación:
When exporting contacts, associate them with companies in HubSpot: Si está activado, Enginy vinculará automáticamente los contactos exportados con sus empresas correspondientes en HubSpot.
When exporting companies, associate them with contacts in HubSpot: Si está activado, Enginy vinculará automáticamente las empresas exportadas con sus contactos relacionados en HubSpot.
Step 2: Field Mapping
Este paso configura qué campos de Enginy se mapean a qué campos de HubSpot al exportar datos. La configuración se divide en dos pestañas — Contacts y Companies — y el proceso de mapeo funciona igual en ambas.
Field Types
Tipo de campo | Descripción |
Enginy Fields | Campos estándar de tus listas de contactos o empresas (p. ej., Phone Number, Job Title). Haz clic en Add field para añadir un mapeo: selecciona primero el campo de Enginy y luego el campo correspondiente de HubSpot. |
Fixed Value Fields | Campos que siempre se exportan con el mismo valor estático. Por ejemplo, crea un campo llamado "Source" con valor fijo "Enginy" para que cada registro exportado quede etiquetado con su origen. |
Manual Export Fields | Campos cuyo valor defines en el momento de exportar. Haz clic en Add field y selecciona el campo de HubSpot que se pedirá rellenar al exportar. Puedes añadir tantos como quieras. |
Engagement Fields | Campos que se rellenan cuando se crea una Activity en HubSpot (por ejemplo, un email enviado, un mensaje de LinkedIn o un registro de tarea). Selecciona el campo de HubSpot y define el valor a exportar. Solo se puede configurar uno. |
Advertencia: No mapees un campo de empresa en la pestaña Contacts (ni un campo de contacto en la pestaña Companies). Esto puede provocar errores de exportación. Si necesitas mapear el mismo campo en ambas pestañas, asegúrate de que el mapeo sea idéntico en las dos.
En cada desplegable de mapeo de campos de HubSpot verás pequeños iconos de estado que indican si el mapeo está soportado, no soportado, o soportado con limitaciones / solución alternativa.
Icono | Significado |
Check azul | El mapeo es correcto y no presenta problemas potenciales. |
Exclamación amarilla | Los tipos de campo en Enginy y HubSpot pueden ser incompatibles (p. ej., un campo de texto de Enginy mapeado a un campo de enumeración de HubSpot). |
X roja | El mapeo no puede aplicarse porque los tipos no coinciden, o porque el campo de HubSpot es de solo lectura y no puede actualizarse. |
Nota: Algunos iconos de advertencia amarillos aparecen cuando el campo de HubSpot seleccionado es un campo de enumeración (desplegable). En ese caso, el campo de texto de Enginy puede exportarse correctamente siempre que el valor enviado coincida con una de las opciones del desplegable (usando los nombres internos, no las etiquetas).
Solución alternativa: Crea una AI Variable con tipo de salida = One off y define las opciones de etiqueta para que coincidan exactamente con los valores del desplegable de HubSpot, usando los nombres internos (no las etiquetas).
Si es un Fixed value field o un Engagement field, introduce el nombre interno exacto en el valor mapeado dentro de la configuración de Field mapping de la integración.
Si es un Manual export field, introduce el nombre interno exacto en el momento de la exportación.
Mapping Options
Estos son los tipos de mapeo disponibles entre Enginy y los campos de HubSpot:
Opción | Comportamiento |
Bi-directional sync | Los cambios se sincronizan automáticamente en ambas direcciones. |
HubSpot overwrites Enginy | Los cambios en HubSpot sobrescriben automáticamente los campos correspondientes en Enginy. |
Enginy overwrites HubSpot | Los cambios en Enginy sobrescriben automáticamente los campos correspondientes en HubSpot. |
Sync if value is empty | Los datos solo se sincronizan automáticamente cuando el campo de destino está vacío, tanto en Enginy como en HubSpot, evitando sobrescribir valores existentes. |
Sync deactivated | Sin sincronización automática. Necesitarás exportar manualmente o ejecutar una sincronización para aplicar los cambios. |
Association Type
La configuración de Association Type controla la relación entre un contacto y una empresa dentro de HubSpot.
Opción | Comportamiento |
Add as additional association | Añade la asociación sin modificar las existentes. |
Add association as Primary | Establece la nueva asociación como la relación principal. |
Associate as Primary and remove previous associations | Establece la nueva asociación como principal y elimina todas las asociaciones anteriores. |
Advertencia: La opción "Associate as Primary and remove previous associations" no es recomendable a menos que estés seguro de que quieres eliminar todas las asociaciones anteriores del registro. Su uso puede provocar pérdida de datos si existen relaciones históricas.
Al exportar manualmente un contacto o empresa, puedes elegir el Association Type en el modal de exportación. La configuración de la integración define el tipo de asociación predeterminado, pero puedes cambiarlo en cada exportación manual.
También puedes: sobrescribir valores existentes para cualquier mapeo de campo (en la pestaña Contacts o Companies), sobrescribir el propietario del CRM, establecer opcionalmente los Manual export field values y activar Export associated companies (o Export associated contacts al exportar manualmente una empresa).
Step 3: Campaign Mapping (Optional)
Este paso te permite sincronizar propiedades específicas de campaña con HubSpot. No son campos estándar de listas; son propiedades vinculadas a la actividad de campaña.
Sequence
Propiedades relacionadas con la secuencia de campaña:
Propiedad | Qué contiene | Ejemplo de valor |
Campaign Sequence Details | Los pasos incluidos en la campaña. |
|
Campaign Engagement Status | El estado actual de cada lead en la campaña. |
|
Sequence Status | El estado general de la secuencia de campaña para el lead. |
|
Campaign Reply Analysis | Indica por mensaje si el lead respondió a cada mensaje automatizado. |
|
Email
Propiedades relacionadas con los mensajes de los pasos de email de la campaña:
Propiedad | Qué contiene | Ejemplo de valor |
Campaign Opens | Número total de veces que un lead ha abierto uno o más emails de la campaña. |
|
Campaign Clicks | Número total de veces que un lead ha hecho clic en un enlace de los emails de la campaña. |
|
Campaign Open Analysis | Indica por mensaje si el contacto abrió ese email específico. |
|
Campaign Click Analysis | Indica por mensaje si el contacto hizo clic en un enlace de ese email específico. |
|
General
Propiedades sobre los aspectos generales de las campañas:
Propiedad | Qué contiene | Ejemplo de valor |
Campaign | Todos los nombres de campaña a los que se ha añadido el contacto. |
|
Senders | Todos los nombres de remitente que han contactado al contacto. |
|
Activities | Todas las actividades que han ocurrido con el contacto. |
|
Conversation Tags
Propiedades relacionadas con los Conversation Tags:
Propiedad | Qué contiene | Ejemplo de valor |
Conversation Tags | Todos los conversation tags aplicados al contacto (separados por coma). |
|
Conversation Tags Categories | Categorías de los conversation tags: POSITIVE, NEUTRAL, NEGATIVE (separados por coma). |
|
Step 4: User Mapping
Este paso final define las asociaciones entre los usuarios/identidades de Enginy y los usuarios de HubSpot, para que las exportaciones y los registros de actividad se atribuyan a las personas correctas.
Identities Mapping
Una Identity en Enginy es el perfil que ejecuta una campaña (por ejemplo, un perfil de LinkedIn o un remitente de email). Identities Mapping vincula cada identidad de Enginy con un usuario de HubSpot.
Cuando una campaña —que siempre está vinculada a una identidad— realiza una sincronización o exportación, el registro de actividad de HubSpot muestra al usuario de HubSpot asociado como el que ejecutó la acción.
Users Mapping
Users Mapping vincula una cuenta de usuario de Enginy con un usuario de HubSpot. Esto establece el propietario predeterminado para cualquier registro exportado por ese usuario, incluso para las exportaciones automáticas mediante mapeos de campo, no solo las manuales.
Si los usuarios de HubSpot tienen diferentes niveles de permisos, esta asociación respeta esos límites. Un registro exportado por un usuario de Enginy es propiedad del usuario de HubSpot mapeado y está gobernado por los permisos de ese usuario en HubSpot.
Default CRM owner
Este mapeo establece un propietario predeterminado en HubSpot (propietario de contacto o empresa) para las exportaciones realizadas por un usuario de Enginy que no está mapeado en User Mapping.
Guardar la configuración
Una vez completados los cuatro pasos, haz clic en Update para guardar la configuración de tu integración de HubSpot.