1. [Ayuda](https://nuvia.ai/es/docs) 2. [Integraciones](https://nuvia.ai/es/docs/colecoes/19378002-integraciones) 3. [HubSpot](https://nuvia.ai/es/docs/colecoes/19431232-hubspot) # Cómo mapear campos entre Nuvia y HubSpot Cómo crear mapeos de campos, organizar la lista en bases grandes y evitar la falla silenciosa de las listas desplegables y de opción múltiple. Disponible en Plataforma > Integraciones > HubSpot > Campos Quién puede hacerlo Administrador Módulo: Plataforma Actualizado el 9 de septiembre de 2026 [HubSpot](https://nuvia.ai/es/docs/colecoes/19431232-hubspot) 1. [Cómo configurar la integración con HubSpot](https://nuvia.ai/es/docs/artigos/14501908-como-configurar-la-integracion-con-hubspot) 2. [Cómo sincronizar contactos y deals entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/14590403-como-sincronizar-contactos-deals-nuvia-hubspot) 3. [Qué sincroniza Nuvia con HubSpot y cuándo](https://nuvia.ai/es/docs/artigos/16473526-que-sincroniza-nuvia-con-hubspot-y-cuando) 4. [Cómo mapear campos entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/16474177-como-mapear-campos-entre-nuvia-y-hubspot) 5. [Solución de problemas de la integración con HubSpot](https://nuvia.ai/es/docs/artigos/16474434-solucion-de-problemas-integracion-con-hubspot) 6. [Cómo enviar plantillas de WhatsApp de Nuvia directo desde un workflow de HubSpot](https://nuvia.ai/es/docs/artigos/15879535-enviar-plantillas-whatsapp-nuvia-desde-workflow-hubspot) 7. [Cómo inscribir leads/contactos en campañas de Nuvia directamente desde un workflow de HubSpot](https://nuvia.ai/es/docs/artigos/15879734-inscribir-contactos-campanas-nuvia-desde-workflow-hubspot) En esta página 1. Crear un mapeo 2. Cómo se organizan los campos en la pantalla 3. Etiquetas que aparecen en las filas 4. Listas desplegables y opción múltiple 5. Actualizar la lista de propiedades 6. Preguntas frecuentes **En esta página6 secciones** 1. Crear un mapeo 2. Cómo se organizan los campos en la pantalla 3. Etiquetas que aparecen en las filas 4. Listas desplegables y opción múltiple 5. Actualizar la lista de propiedades 6. Preguntas frecuentes 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 1. En **Plataforma > Integraciones > HubSpot**, ubica la cuenta y haz clic en **Configurar** 2. Abre la pestaña **Campos** 3. Haz clic en **Agregar mapeo** 4. En **Campo de HubSpot**, elige la propiedad de destino — usa **Buscar campo…** para filtrar por nombre 5. En **Campo Inteligente**, elige el campo correspondiente de Nuvia 6. Haz clic en **Guardar mapeos** Nota las propiedades personalizadas de HubSpot son totalmente compatibles. Cualquier propiedad de **Contacto**, **Deal** o **Lead** se puede mapear. Las propiedades de **empresa** no entran en el mapeo, porque Nuvia no escribe empresas en HubSpot. ## Cómo se organizan los campos en la pantalla La lista se divide en dos lados, cada uno con su propia organización. LadoCó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. Nota no hay límite de cantidad de mapeos; puedes mantener decenas de filas sin impacto en la sincronización. Por ahora no es posible crear tus propios grupos o subcampos para organizar la lista: los grupos son fijos (por objeto del lado de HubSpot, por contexto del lado de Nuvia). En bases grandes, la búsqueda es el camino más rápido. ## 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 Importante es posible guardar un mapeo para una propiedad de **solo lectura**, pero el envío fallará siempre. El error aparece en el **Historial** con el mensaje de que la propiedad no acepta escritura. Elimina ese mapeo en lugar de dejarlo activo. ## 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 NuviaOpción en HubSpotResultado 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** Crítico cuando se rechaza un valor de selección, HubSpot **rechaza el registro completo** y no solo ese campo. Todos los demás campos de ese contacto (o de ese deal, o de ese lead) en ese envío no se guardan. 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: 1. Abre la pestaña **Avanzado** 2. 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**. Consejo ejecuta **Sincronizar campos** siempre que el equipo de HubSpot cambie la estructura de propiedades. Es la forma más rápida de eliminar mapeos huérfanos, que fallan en silencio en cada envío. ## Preguntas frecuentes ## Preguntas frecuentes **Los campos dejaron de llegar a HubSpot y no apareció ningún error. ¿Qué pasó?** En la mayoría de los casos es un campo de selección con un valor fuera del estándar. HubSpot rechaza el registro completo cuando una opción no coincide exactamente con las opciones de la propiedad, incluso por una diferencia de mayúscula o de acento. Abre la pestaña **Historial**, filtra por **Error** y revisa el mensaje del evento. **Tengo más de 40 campos mapeados. ¿Puedo agruparlos en subcategorías?** Por ahora no. Los grupos son fijos: por objeto (Contacto, Deal, Lead) del lado de HubSpot y por contexto (Contacto, Conversación, Calificación, Empresa) del lado de Nuvia. No hay límite de cantidad de mapeos, y la búsqueda **Buscar campo…** dentro del selector es el camino más rápido para ubicar una propiedad específica. **¿Puedo mapear un campo solo para recibir datos, sin enviarlos?** No. No existe configuración de dirección por campo; el mapeo vale en los dos sentidos. La excepción son las propiedades que HubSpot marca como **Solo lectura**, que solo se pueden leer. La elección de dirección existe solo en el mapeo de etapas, en la pestaña **Embudos**. **Creé una propiedad nueva en HubSpot y no aparece en la lista.** Ve a **Avanzado > Actualizar campos** y haz clic en **Sincronizar campos**. Nuvia vuelve a cargar la lista de propiedades de HubSpot en el momento. **¿Qué pasa si elimino en HubSpot una propiedad que estaba mapeada?** Los envíos a esa propiedad empiezan a fallar. Al ejecutar **Sincronizar campos**, Nuvia elimina automáticamente el mapeo huérfano. [AnteriorQué sincroniza Nuvia con HubSpot y cuándo](https://nuvia.ai/es/docs/artigos/16473526-que-sincroniza-nuvia-con-hubspot-y-cuando) [SiguienteSolución de problemas de la integración con HubSpot](https://nuvia.ai/es/docs/artigos/16474434-solucion-de-problemas-integracion-con-hubspot) ¿Te ayudó este artículo? ## Artículos relacionados - [Cómo configurar la integración con HubSpot](https://nuvia.ai/es/docs/artigos/14501908-como-configurar-la-integracion-con-hubspot) - [Cómo sincronizar contactos y deals entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/14590403-como-sincronizar-contactos-deals-nuvia-hubspot) - [Cómo crear y editar Embudos Inteligentes por el MCP (Agent Builder)](https://nuvia.ai/es/docs/artigos/16074655-crear-editar-embudos-inteligentes-mcp-agent-builder) [HubSpot](https://nuvia.ai/es/docs/colecoes/19431232-hubspot) 1. [Cómo configurar la integración con HubSpot](https://nuvia.ai/es/docs/artigos/14501908-como-configurar-la-integracion-con-hubspot) 2. [Cómo sincronizar contactos y deals entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/14590403-como-sincronizar-contactos-deals-nuvia-hubspot) 3. [Qué sincroniza Nuvia con HubSpot y cuándo](https://nuvia.ai/es/docs/artigos/16473526-que-sincroniza-nuvia-con-hubspot-y-cuando) 4. [Cómo mapear campos entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/16474177-como-mapear-campos-entre-nuvia-y-hubspot) 5. [Solución de problemas de la integración con HubSpot](https://nuvia.ai/es/docs/artigos/16474434-solucion-de-problemas-integracion-con-hubspot) 6. [Cómo enviar plantillas de WhatsApp de Nuvia directo desde un workflow de HubSpot](https://nuvia.ai/es/docs/artigos/15879535-enviar-plantillas-whatsapp-nuvia-desde-workflow-hubspot) 7. [Cómo inscribir leads/contactos en campañas de Nuvia directamente desde un workflow de HubSpot](https://nuvia.ai/es/docs/artigos/15879734-inscribir-contactos-campanas-nuvia-desde-workflow-hubspot) ## ¿Todavía necesitas ayuda? Los clientes hablan con soporte por el chat dentro de la plataforma. ¿Aún no eres cliente? Habla con nuestro equipo. [Hablar con soporte en la plataforma](https://app.nuvia.ai) [Aún no soy cliente](https://nuvia.ai/es/contact) --- Source: https://nuvia.ai/es/docs/artigos/16474177-como-mapear-campos-entre-nuvia-y-hubspot