El mapeo de campos define qué información viaja entre los dos sistemas. Nada se sincroniza por defecto; tú creas manualmente cada par de campos.
Disponible en: Plataforma > Integraciones > HubSpot > Campos
Quién puede hacerlo: Administrador
Módulo: Plataforma
Crear un mapeo
-
En Plataforma > Integraciones > HubSpot, ubica la cuenta y haz clic en Configurar
-
Abre la pestaña Campos
-
Haz clic en Agregar mapeo
-
En Campo de HubSpot, elige la propiedad de destino — usa Buscar campo… para filtrar por nombre
-
En Campo Inteligente, elige el campo correspondiente de Nuvia
-
Haz clic en Guardar mapeos
Cómo se organizan los campos en la pantalla
La lista se divide en dos lados, cada uno con su propia organización.
| Lado | Cómo está organizado |
|---|---|
| Campo de HubSpot | Agrupado por objeto: Contacto, Deal y Lead. Las propiedades de uso más común aparecen primero; el resto sigue en orden alfabético |
| Campo Inteligente (Nuvia) | Agrupado por contexto: Contacto, Conversación, Calificación y Empresa |
Para encontrar una propiedad específica en cuentas con muchos campos, usa la búsqueda Buscar campo… dentro del selector. Filtra por nombre mientras escribes.
Etiquetas que aparecen en las filas
-
Sync bidireccional (Contacto, Deal y Lead) → el mapeo vale en los dos sentidos. No existe configuración de dirección por campo (la elección de dirección existe solo en la pestaña Embudos, por etapa)
-
Solo lectura → la propiedad la calcula HubSpot y no acepta escritura por la API
Listas desplegables y opción múltiple
Cuando el campo de Nuvia es de selección o de opción múltiple, Nuvia envía a HubSpot el texto de la opción, exactamente como está registrado en el campo de Nuvia. HubSpot solo acepta ese valor si es idéntico a una de las opciones de la propiedad, incluidas mayúsculas, minúsculas, acentos y espacios.
| Opción en Nuvia | Opción en HubSpot | Resultado |
|---|---|---|
Caliente |
Caliente |
Se sincroniza |
caliente |
Caliente |
Rechazado, la diferencia de mayúscula invalida el valor |
Calificado |
Calificado con un espacio al final |
Rechazado |
Sin interés |
Sin Interés |
Rechazado |
La falla queda registrada en la pestaña Historial, con estado Error o Parcial y el mensaje: “El valor enviado no es una de las opciones aceptadas por la propiedad X en HubSpot. Revisa el vínculo de este campo en la integración.” Como el historial se guarda durante 7 días, conviene revisarlo con regularidad después de cambiar campos de selección.
Cómo evitarlo
-
Copia y pega el texto de las opciones directamente desde HubSpot al registrar las opciones del campo en Nuvia; no lo vuelvas a escribir
-
Estandariza antes de mapear: si HubSpot tiene
Caliente,Tibio,Frío, el campo de Nuvia necesita tener exactamente esos tres textos -
Después de crear el mapeo, modifica un contacto de prueba y revisa el resultado en el Historial
Opción múltiple
Los valores de opción múltiple viajan separados por punto y coma (;), que es el separador que usa HubSpot. Por eso, si cualquier opción seleccionada tiene ; en el texto, el campo completo deja de enviarse; el punto y coma rompería el valor del otro lado. El resto de los campos de ese registro sigue normalmente.
Evita usar ; en el texto de las opciones de los campos de selección de Nuvia.
En el sentido inverso
Cuando un valor de lista desplegable llega desde HubSpot, se guarda en Nuvia con el código interno de la opción, no con la etiqueta que ves en HubSpot. En el panel del Historial la etiqueta se muestra normalmente; la diferencia aparece en el valor guardado en el contacto.
Actualizar la lista de propiedades
Cuando alguien crea, renombra o elimina una propiedad en HubSpot:
-
Abre la pestaña Avanzado
-
En Actualizar campos, haz clic en Sincronizar campos
Nuvia busca las propiedades más recientes de HubSpot, pone las nuevas a disposición para mapear y elimina los mapeos de propiedades que ya no existen.