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 configurar la integración con HubSpot Sincroniza HubSpot con Nuvia: contactos, empresas y deals en tiempo real, con mapeo de campos, etapas del embudo y reglas bidireccionales configurables. Disponible en Plataforma > Integraciones > HubSpot Quién puede hacerlo Administrador Actualizado el 3 de noviembre 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) La integración con HubSpot sincroniza automáticamente contactos y empresas entre Nuvia y tu cuenta de HubSpot. Así tus datos se mantienen siempre actualizados en ambas plataformas, sin necesidad de sincronización manual, y se crea un ciclo de retroalimentación continuo entre inbound y outbound. **Disponible en:** Plataforma > Integraciones > HubSpot **Quién puede hacerlo:** Administrador ## Lo que necesitas antes de empezar - Acceso de **Propietario** o **Administrador** en tu cuenta de Nuvia - Una cuenta activa en **HubSpot** (cualquier plan) - Permisos para conectar aplicaciones de terceros en tu cuenta de HubSpot - Claridad sobre qué campos quieres sincronizar entre las plataformas - Tener definido tu código de país (el código que identifica al país) predeterminado ### Conectar tu cuenta de HubSpot 1. Ve a **Configuración** > **Integraciones** 2. Ubica **HubSpot** en la lista y haz clic para abrir el panel 3. Haz clic en **Integrar ** y luego en **Agregar cuenta** 4. Inicia sesión en HubSpot y concede los permisos solicitados 5. Se te redirigirá de vuelta a Nuvia con el estado **Conectado** Importante la conexión requiere permisos de propietario o administrador en tu cuenta de HubSpot. Importante conectar la cuenta **no** importa la base que ya existe en HubSpot. A partir de la conexión, Nuvia sincroniza solo lo que cambie de ahí en adelante. Para traer contactos que ya existen en HubSpot, usa **Listas > Importar miembros**. ### Configurar el mapeo de campos El mapeo de campos determina qué información se sincroniza entre Nuvia y HubSpot. Nuvia no viene con mapeos preconfigurados; todos se definen manualmente. 1. En la página de la integración con HubSpot, ubica tu cuenta y haz clic en **Configurar** 2. Haz clic en **Campos** 3. Haz clic en **agregar mapeo** 4. Selecciona el campo de Nuvia (derecha) y la propiedad de HubSpot (izquierda) para asociarlos 5. Haz clic en **Guardar mapeos** Consejo los campos personalizados son totalmente compatibles. Cualquier propiedad de HubSpot (incluidas las propiedades personalizadas) se puede mapear a cualquier campo personalizado de Nuvia. Crítico los campos de **lista desplegable** y **opción múltiple** exigen que el texto de la opción en Nuvia sea idéntico al de HubSpot — incluidas mayúsculas, acentos y espacios. Cualquier diferencia hace que HubSpot rechace **el registro completo**, y ninguno de los otros campos de ese contacto se guarda, sin aviso en pantalla. Antes de mapear campos de selección, lee [Cómo mapear campos entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/16474177-como-mapear-campos-entre-nuvia-y-hubspot). ### Configurar el mapeo de etapas del embudo Alinea las etapas de ventas entre las plataformas para que los movimientos en el pipeline se reflejen automáticamente. 1. En la página de la integración con HubSpot, haz clic en la pestaña **Embudos** 2. Define la plantilla usada para nombrar los deals creados automáticamente en HubSpot. 3. Para cada etapa del embudo de Nuvia, selecciona el deal stage correspondiente en HubSpot 4. Haz clic en **Guardar mapeo** Nota el mapeo de campos y el mapeo de etapas son mecanismos independientes. Mapear un campo no mueve una etapa, y mapear una etapa no sincroniza un campo. Detalles en [Qué sincroniza Nuvia con HubSpot y cuándo](https://nuvia.ai/es/docs/artigos/16473526-que-sincroniza-nuvia-con-hubspot-y-cuando). ### Configurar el código de país predeterminado El código de país predeterminado completa el código de país de los teléfonos que **llegan de HubSpot** sin esa información, para que el contacto se cree correctamente en Nuvia. 1. Abre la pestaña **Avanzado** 2. En **Configuración de teléfono**, selecciona el código de país en el selector (ej.: +55 - Brasil) La configuración se guarda automáticamente al seleccionarla — no hay botón **Guardar**. Cómo funciona la regla: - Solo se aplica cuando el número tiene **11 dígitos o menos** y todavía no empieza con ese código de país - Los números que ya llegan en formato internacional (con +) no se modifican - Para Brasil, un número de 8 dígitos que empieza con 6, 7, 8 o 9 recibe automáticamente el noveno dígito - Los números con menos de 8 dígitos se descartan y el contacto no se crea - La opción **Ninguno (detectar automáticamente)** hace que Nuvia intente identificar el país por los primeros dígitos, lo que puede fallar Importante el código de país predeterminado actúa **solo en la entrada**. **No cambia** el teléfono que Nuvia envía a HubSpot — en la salida van el código de país y el número exactamente como están guardados en el contacto de Nuvia. Si los teléfonos llegan mal a HubSpot, la corrección se hace en el registro del contacto, no en esta configuración. ### Configuración de la pestaña Avanzado Además del código de país predeterminado, la pestaña **Avanzado** reúne las reglas de sincronización de la cuenta. ConfiguraciónQué hace **Actualizar campos** El botón **Sincronizar campos** recarga las propiedades de HubSpot, habilita las nuevas para mapeo y quita los mapeos de propiedades que ya no existen **Creación automática de contactos** Crea o vincula el contacto en HubSpot al iniciar una conversación **Actualizar el owner cuando el Contact/Deal se actualice en HubSpot** Refleja en Nuvia el cambio de responsable hecho en HubSpot **Consultar propiedades antes del agente** Busca las propiedades del contacto en HubSpot en tiempo real antes de cada respuesta del agente. Agrega una consulta por atención (costo y límite de API) y viene desactivado de forma predeterminada **Enviar la transcripción a HubSpot después de resolverse** Envía el contenido de la conversación resuelta como registro de comunicación asociado al contacto. Vale para WhatsApp y LinkedIn **Fuentes de eventos del webhook** Permite descartar eventos que vienen de ciertos orígenes de HubSpot (edición manual, formulario, automatización, workflow, integraciones y API, importación, migración) Importante desactiva una **fuente de eventos** solo en una emergencia. Los eventos de ese origen pasan a descartarse en la entrada y no se recuperan después. ### Creación automática de contactos En la pestaña **Avanzado**, ubica **Creación automática de contactos ** y haz clic en el botón para activarla. Cuando está activada, todo contacto que inicie una conversación se crea en HubSpot – o se vincula, si ya existe un registro con el mismo teléfono o correo. - **Activada:** garantiza que ninguna conversación quede sin un contacto correspondiente en HubSpot - **Desactivada:** el control pasa a ser individual por etapa del embudo (solo las etapas configuradas para crear contacto en HubSpot activarán la creación) Consejo esta configuración tiene prioridad sobre el control por etapa del embudo. Si está activada, crea el contacto en cualquier nueva conversación, sin importar la etapa. ### Actualizar el owner cuando el Contact/Deal se actualice en HubSpot Interruptor en la pestaña **Avanzado**. Cuando está activado, los cambios en el **Contact Owner** o el **Deal Owner** hechos en HubSpot se reflejan automáticamente en el agente vinculado a la conversación abierta del contacto en Nuvia – manteniendo al mismo agente o IA respondiendo, sin transferir la atención. #### **Cómo configurarlo:** 1. En la pestaña **Usuarios**, configura la **Fuente de sincronización** (Contact Owner o Deal Owner) y mapea los usuarios de HubSpot a los usuarios de Nuvia 2. En la pestaña **Avanzado**, activa el interruptor **Actualizar el owner cuando el Contact/Deal se actualice en HubSpot** #### **Comportamiento:** - Nuvia recibe el webhook de HubSpot con el nuevo owner - Identifica al usuario de Nuvia correspondiente usando el mapeo de la pestaña **Usuarios** - Ubica la última conversación abierta del contacto y actualiza el agente vinculado - El agente o la persona que estaba respondiendo sigue respondiendo (la conversación no se transfiere) Importante el interruptor queda deshabilitado mientras la **Fuente de sincronización** esté en **Desactivado**. Configura los mapeos de usuarios en la pestaña **Usuarios** antes de activarlo. Consejo si el nuevo owner de HubSpot no tiene mapeo a un usuario de Nuvia, o si el contacto no tiene una conversación abierta en el momento del webhook, Nuvia ignora el evento en silencio y no cambia nada. ### Consultar el historial de sincronización El historial de sincronización muestra un registro completo de todas las sincronizaciones, actualizaciones, errores y conflictos. 1. En la página de la integración con HubSpot, haz clic en la pestaña **Historial** 2. Revisa los registros por fecha/hora, tipo, acción y estado 3. Haz clic en un error para ver los detalles y las indicaciones para resolverlo Consejo los logs se guardan por **7 días** y no hay alerta automática de fallas. Consulta el Historial con regularidad, sobre todo después de cambiar campos o etapas. Para el paso a paso de diagnóstico, consulta [Solución de problemas de la integración con HubSpot](https://nuvia.ai/es/docs/artigos/16474434-solucion-de-problemas-integracion-con-hubspot). #### Dos nuevos tipos de evento en el filtro El filtro de tipo de evento del historial sumó dos opciones: - **Propietario asignado** → Nuvia definió el propietario (owner) del contacto o del deal en HubSpot. Cuando la asignación falla, el evento aparece como **Falla en la asignación de propietario** - **Transcripción enviada** → Nuvia envió la transcripción de la conversación a HubSpot. Cuando el envío falla, el evento aparece como **Falla en el envío de la transcripción** #### Ver los datos detrás de cada evento Al hacer clic en un evento del historial, el panel de detalle se abre con hasta tres bloques de datos; cuáles aparecen depende de la dirección del evento. - **Campos mapeados** (en ambos sentidos) → solo los campos que mapeaste en **Campos**, con el valor que viajó en ese evento. Un campo que no se envió aparece marcado con **(no enviado)** - **Campos recibidos de HubSpot** (solo cuando el evento vino de HubSpot) → todo lo que HubSpot devolvió en ese evento, no solo lo que mapeaste, incluidos campos nativos como correo, teléfono y empresa. Cada fila trae el nombre legible de la propiedad, el nombre técnico debajo (ej.: contacts.email) y la marca **(mapeado)** cuando esa propiedad está en tu mapeo - **Datos de Nuvia en el envío** (solo cuando el evento salió de Nuvia) → el estado del registro en Nuvia en el instante del envío. Es el bloque que explica por qué un campo salió vacío o con un valor diferente al esperado Dos detalles útiles al leer los campos recibidos: - **Un evento trae más de una entidad.** Un evento de deal lleva las propiedades del deal y del contacto asociado. El nombre técnico debajo de cada fila dice de qué entidad viene cada valor (deals., contacts., leads.) - **Los campos de lista desplegable muestran la etiqueta, no el código.** Si la propiedad en HubSpot es una selección, Nuvia cambia el valor interno por el texto que ves en HubSpot Nota los bloques de campos se cargan solo cuando abres el evento — por eso el panel muestra **“Cargando los campos de este evento…”** por un instante. Si la carga falla, aparece el aviso **“No fue posible cargar los campos de este evento”** con el botón **Intentar de nuevo**: es una falla de carga, no significa que el evento se quedó sin datos. #### Buscar un evento por los IDs del contacto, de la conversación o de HubSpot El campo de búsqueda del historial ya no busca solo por nombre y teléfono. Ahora el texto que escribes también se compara con los identificadores guardados en cada evento: - **ID del contacto en Nuvia** → trae todos los eventos de ese contacto, incluidos los de deal y de lead asociados a él - **ID de la conversación en Nuvia** → trae los eventos vinculados a esa conversación - **ID del contacto en HubSpot** → trae los eventos de ese contacto, incluso cuando el objeto principal del evento era un deal o un lead - **ID del deal en HubSpot** e **ID del lead en HubSpot** → traen los eventos de ese deal o lead - El nombre o el teléfono del contacto siguen funcionando como antes El texto de ejemplo del campo cambió a **“Buscar por nombre, teléfono, conversación o ID…”** para reflejarlo. Bueno saber los identificadores se guardan en el propio evento en el momento en que ocurre. Los eventos antiguos, registrados antes de este cambio, pueden no tener todos los IDs completos; en esos casos, la búsqueda por nombre o teléfono sigue siendo el camino. #### Filtrar solo las fallas El selector de **tipo de evento** pasó a listar también los eventos de falla, que antes no aparecían en la lista y por eso no se podían aislar: - Falla en la sincronización de contacto - Falla en la creación de deal - Falla en la actualización de etapa del deal - Falla en la sincronización de campos - Falla en la creación de lead - Falla en la asignación de propietario - Falla en el envío de la transcripción Usa este filtro cuando quieras ver solo lo que salió mal, sin tener que recorrer los registros de éxito. #### Compartir un historial ya filtrado Los filtros del historial ahora quedan registrados en la dirección de la página. Esto significa que: - Al aplicar búsqueda, tipo de evento, dirección, estado o tipo de objeto, la dirección en el navegador se actualiza sola - Puedes **copiar la dirección y enviarla a otra persona**, y esa persona abre exactamente la misma lista filtrada - Volver a la página por una dirección guardada restaura los filtros que estaban aplicados - La dirección también guarda en qué pestaña de la configuración de HubSpot estás y qué cuenta está seleccionada. Si la empresa tiene **una sola cuenta** conectada, la dirección funciona incluso sin indicar la cuenta ### Ir del contacto directamente al historial de sincronización En la pestaña de campos del contacto, tanto en el panel de la conversación en el Inbox como en el panel de contacto, la sección **HubSpot** sumó un ícono de **reloj con flecha** (historial) junto a los IDs. Al hacer clic en él se abre, en una pestaña nueva, el **Historial** de HubSpot ya filtrado por ese contacto. Es el camino más corto para responder “¿qué envió y recibió Nuvia sobre este contacto?” sin pasar por Configuración y sin armar el filtro a mano. - **Cuándo aparece el ícono:** solo cuando el contacto tiene algún vínculo con HubSpot (ID de contacto, deal o lead) **y** tu perfil tiene permiso para ver la configuración - **Dónde aparece:** una vez por contacto, en el **ID del contacto** cuando existe; si no, en el ID del Deal o del Lead - **Qué trae el filtro:** todos los eventos del contacto, sin separar por tipo de objeto; los deals y leads asociados entran juntos Consejo si el ícono de historial no te aparece, verifica con el administrador si tu perfil tiene acceso a **Plataforma > Integraciones**. Sin ese permiso el panel de HubSpot es inaccesible y el atajo queda oculto a propósito. ### Abrir el contacto o el deal directamente en HubSpot desde una conversación Con la integración activa, aparece un ícono de enlace externo en la pestaña de campos del contacto dentro del módulo **Conversaciones**. Esto te permite abrir el contacto o el deal correspondiente directamente en la interfaz de HubSpot, sin salir de Nuvia ni buscar manualmente. #### Cómo usarlo 1. Abre una conversación en el módulo **Conversaciones** 2. Haz clic en Ver detalles debajo del nombre del usuario 3. En el panel lateral derecho, haz clic en la pestaña **Datos** 4. Ubica la sección **HubSpot** al final de la pantalla – aparece cuando el contacto está vinculado a un registro en HubSpot 5. Junto al **ID del contacto** o al **ID del deal**, haz clic en el ícono de enlace externo (un cuadrado con una flecha) 6. El perfil del contacto o el deal se abrirá directamente en HubSpot en una pestaña nueva Consejo el ícono de enlace externo solo aparece cuando tu cuenta de HubSpot está conectada y el portal ID está configurado correctamente. Si el ícono no aparece, verifica que la integración tenga el estado **Conectado** en **Plataforma > Integraciones > HubSpot**. ## Preguntas frecuentes ## Preguntas frecuentes **¿Cada cuánto sincroniza Nuvia los datos con HubSpot?** La sincronización es en tiempo real, orientada a eventos. Cuando algo cambia en HubSpot, un webhook notifica a Nuvia al instante. No hay un intervalo configurable. Sin embargo, conectar la cuenta no hace una carga inicial: solo se sincroniza lo que cambie a partir de ese momento. **Si elimino un contacto en Nuvia, ¿se elimina en HubSpot?** No. Las eliminaciones no se propagan en ninguna dirección. Si necesitas quitar datos de ambas plataformas (ej.: una solicitud de LGPD), debes eliminarlos manualmente en cada una. **¿Puedo sincronizar solo algunos campos y no todos?** Sí. En la pestaña Campos eliges exactamente qué campos quieres sincronizar. Los campos no mapeados no se sincronizan. **Configuré el código de país predeterminado y los teléfonos siguen llegando mal a HubSpot. ¿Por qué?** Porque el código de país predeterminado solo actúa sobre los números que **llegan de HubSpot**. En el sentido de salida, Nuvia envía el código de país y el número exactamente como están guardados en el contacto. La corrección se hace en el registro del contacto en Nuvia. **¿El enlace externo a HubSpot dentro de la conversación aparece para todos los usuarios?** Sí, el ícono de enlace externo aparece para cualquier usuario con acceso a la conversación, siempre que la integración con HubSpot esté activa y el contacto esté vinculado a un registro en HubSpot. El ícono de **historial de sincronización** es diferente: exige permiso para ver la configuración, porque lleva al interior del panel de Integraciones. **Busqué por el ID del contacto en el historial y no apareció nada. ¿Por qué?** Los identificadores se guardan en el evento en el momento en que ocurre. Los eventos registrados antes de este cambio pueden no tener el ID completo; intenta con el nombre o el teléfono del contacto. Recuerda también que los logs se guardan solo por 7 días. **Si cambio el owner de un contacto en HubSpot, ¿el agente en Nuvia cambia automáticamente?** Solo si el interruptor **Actualizar el owner cuando el Contact/Deal se actualice en HubSpot** está activado en la pestaña **Avanzado** y la **Fuente de sincronización** está configurada en la pestaña **Usuarios**. Cuando está activado, Nuvia actualiza el agente de la conversación abierta del contacto, manteniendo al mismo agente o IA respondiendo (sin transferir la atención). **¿La sincronización de owner afecta conversaciones ya cerradas?** No. Nuvia solo actualiza conversaciones con estado **Abierta** en el momento del webhook. Las conversaciones cerradas o resueltas no se modifican, aunque cambie el owner de HubSpot. **¿Y si tengo varias cuentas de HubSpot?** Actualmente, Nuvia admite una sola cuenta de HubSpot por workspace. Si necesitas conectar varias cuentas, tendrás que crear workspaces de Nuvia separados. **¿La integración con HubSpot funciona con el módulo de Campañas?** Parcialmente. Los eventos de HubSpot pueden disparar campañas automáticamente en Nuvia mediante webhooks. Nuvia no envía datos de desempeño de las campañas de vuelta a HubSpot; esos datos solo son visibles en los Paneles de Nuvia. **¿Puedo exportar el historial de sincronización para auditoría?** No. El historial está disponible solo para consulta en la interfaz, con filtros por tipo, dirección, estado y objeto, y también mediante la dirección de la página, que puedes copiar y compartir ya filtrada. Recuerda que los logs se guardan solo por 7 días. [SiguienteCómo sincronizar contactos y deals entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/14590403-como-sincronizar-contactos-deals-nuvia-hubspot) ¿Te ayudó este artículo? ## Artículos relacionados - [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) - [Qué sincroniza Nuvia con HubSpot y cuándo](https://nuvia.ai/es/docs/artigos/16473526-que-sincroniza-nuvia-con-hubspot-y-cuando) - [Cómo mapear campos entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/16474177-como-mapear-campos-entre-nuvia-y-hubspot) - [Solución de problemas de la integración con HubSpot](https://nuvia.ai/es/docs/artigos/16474434-solucion-de-problemas-integracion-con-hubspot) [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/14501908-como-configurar-la-integracion-con-hubspot