Para acceder al Field Mapping, ve a Integrations → HubSpot → Configure → Step 2: Field Mapping.
Important: HubSpot puede convertir automáticamente algunos tipos de campo, pero es estricto con los campos de tipo enumeration. Revisa siempre los warnings amarillos antes de guardar.
Qué significa cada icono
Icono | Estado | Qué significa |
✓ Azul | Compatible | Los tipos de campo coinciden. No hay ninguna acción necesaria. |
! Amarillo | Warning | Los tipos de campo pueden ser incompatibles. Revisa este mapping con atención antes de guardar. (HubSpot puede procesar algunos mappings automáticamente, pero no todos.) |
✕ Rojo | Error | El mapping no se puede aplicar. El export fallará para todos los registros que usen este mapping. |
Warning: No guardes una configuración con iconos rojos. Los exports fallarán para todos los registros que usen ese field mapping.
¿Qué tipo de campo de HubSpot debo usar?
Usa esta tabla como referencia al seleccionar el campo destino de HubSpot para cada campo de Enginy.
Campo de Enginy | Tipo de campo recomendado en HubSpot | Notas |
First name, Last name, Job title, Email, Phone | Single-line text | Campos de texto estándar. Totalmente compatibles. |
Number of employees, Years in role, Growth % | Number | Mapear a una propiedad numérica de HubSpot. |
Created at, Last activity at CRM | Date and time | Nunca mapear a una propiedad de texto. |
Outreach Stage, Sequence Status | Enumeration (dropdown) | El valor debe coincidir exactamente con el internal option name — ver más abajo. |
Languages, Sub-industries | Multi-select enumeration | Los valores deben separarse con |
LinkedIn URL, Domain, Website | Single-line text o URL | Ambos tipos son compatibles en HubSpot. |
Personal emails, Other phones | Multi-select o Single-line text | Usar Professional email y Mobile phone siempre que sea posible para evitar enviar arrays. |
Warning amarillo: qué hacer
HubSpot puede convertir automáticamente algunos tipos de campo. Sin embargo, los warnings amarillos requieren atención porque no todas las conversiones funcionan correctamente.
1.Campo de texto mapeado a un campo Enumeration (dropdown)
Si mapeas un campo de texto de Enginy a una propiedad enumeration (dropdown) de HubSpot, HubSpot rechazará la solicitud si el valor enviado no coincide con una de las opciones permitidas de esa propiedad. HubSpot devuelve un error VALIDATION_ERROR (HTTP 400) en este caso.
El valor debe coincidir con el internal option name del dropdown de HubSpot — no el label visible en HubSpot.
Cómo resolverlo:
Crea un AI Variable con output type One off y define las opciones con los internal option names exactos del dropdown de HubSpot.
Para campos de tipo Fixed Value o Engagement: introduce el internal name directamente en la configuración del mapping.
Para campos de Manual Export: introduce el internal name exacto en el momento del export.
Note: Los internal option names pueden ser diferentes de los labels que ves en HubSpot. Ve a HubSpot → Settings → Properties, abre la propiedad y consulta los valores internos de cada opción.
2.Campo de fecha mapeado a un campo de texto
Enginy almacena los campos de fecha (como Created at o Last activity at CRM) como valores de fecha y hora completos en formato ISO 8601. Mapea estos campos a propiedades Date o Date/Time de HubSpot para asegurarte de que se procesan correctamente.
3.Valores multi-select — formato del separador
Si mapeas un campo multi-valor a una propiedad multi-select enumeration de HubSpot, HubSpot espera que los valores estén separados por punto y coma (;), no por coma.
Ejemplo: opcion_uno;opcion_dos;opcion_tres
Cómo resolverlo: Asegúrate de que los valores que envías usan ; como separador. Usar comas hará que HubSpot almacene toda la cadena como un único valor no reconocido.
Error rojo: qué hacer
Un icono rojo significa que el mapping fallará siempre. Hay dos razones posibles:
Tipos de campo incompatibles
Los tipos de campo de ambos lados son incompatibles y HubSpot no puede convertirlos automáticamente.
Cómo resolverlo: Elimina el mapping y selecciona una propiedad de HubSpot con un tipo compatible. Usa la tabla de referencia de arriba para elegir el tipo correcto.
Propiedad read-only de HubSpot
El campo destino en HubSpot es de solo lectura y no puede ser actualizado por Enginy. Esto suele ocurrir con propiedades generadas por el sistema como IDs de registro o propiedades calculadas.
Cómo resolverlo: Elimina el mapping y elige una propiedad diferente de HubSpot, o consulta con el administrador de HubSpot para confirmar los permisos de la propiedad.
Errores frecuentes en el mapping de HubSpot
Error | Qué ocurre | Cómo corregirlo |
Mapear un campo de Company en la pestaña Contacts (o viceversa) | El export falla con un error de field mapping | Verifica que solo los campos de Contact aparecen bajo Contacts, y solo los de Company bajo Companies |
Mapear un campo de fecha de Enginy a una propiedad de texto de HubSpot | El valor de fecha no se procesa correctamente | Mapea a una propiedad Date o Date/Time de HubSpot |
Mapear un campo de texto de Enginy a una enumeration de HubSpot sin usar internal option names | HubSpot devuelve VALIDATION_ERROR y el export falla | Usa un AI Variable (One off) con los internal option names exactos |
Usar comas en lugar de punto y coma en valores multi-select | HubSpot almacena toda la cadena como un único valor no reconocido | Usa |
Mapear a una propiedad calculada o read-only de HubSpot | El export falla | Elige una propiedad que se pueda escribir |
Campaign Status Sync mal configurado | HubSpot muestra: "HubSpot conversation status sync is misconfigured. Please review your HubSpot campaign mapping" | Alinea los valores del picklist en Enginy con las opciones existentes en la propiedad de HubSpot en el Step 3: Campaign Mapping |
Guardar mappings con iconos rojos | Todos los registros que usen ese mapping fallan al exportar | Corrige o elimina cualquier mapping con icono rojo antes de guardar |
¿Necesitas más ayuda?
Si has revisado tu configuración de mapping y el export sigue fallando, contacta con nuestro equipo de soporte con:
El nombre del campo de Enginy y la propiedad de HubSpot que intentas mapear
El mensaje de error o el icono que estás viendo
Una captura de pantalla de la configuración del Field Mapping si es posible