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) # Solución de problemas de la integración con HubSpot Los síntomas más comunes de la integración con HubSpot, con su causa y su corrección. Disponible en Plataforma > Integraciones > HubSpot > Historial 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. Empieza siempre por el Historial 2. Los campos dejaron de llegar a HubSpot, sin error visible 3. El mismo contacto se convirtió en dos registros en HubSpot 4. El mismo contacto apareció con dos deals en HubSpot 5. Los contactos de HubSpot no llegan a Nuvia 6. El deal no cambia de etapa en HubSpot 7. La conversación no avanza cuando muevo el deal en HubSpot 8. Errores de HubSpot y qué hacer 9. Preguntas frecuentes **En esta página9 secciones** 1. Empieza siempre por el Historial 2. Los campos dejaron de llegar a HubSpot, sin error visible 3. El mismo contacto se convirtió en dos registros en HubSpot 4. El mismo contacto apareció con dos deals en HubSpot 5. Los contactos de HubSpot no llegan a Nuvia 6. El deal no cambia de etapa en HubSpot 7. La conversación no avanza cuando muevo el deal en HubSpot 8. Errores de HubSpot y qué hacer 9. Preguntas frecuentes **Disponible en:** Plataforma > Integraciones > HubSpot > Historial **Quién puede hacerlo:** Administrador **Módulo:** Plataforma ## Empieza siempre por el Historial Casi todo problema de sincronización tiene un registro en la pestaña **Historial**, dentro de la integración. De ahí sale el diagnóstico. 1. En **Plataforma > Integraciones > HubSpot**, haz clic en **Configurar** y abre la pestaña **Historial** 2. Busca por el nombre, teléfono o ID del contacto; el campo también acepta ID de conversación e ID de HubSpot 3. Filtra por **Estado: Error** o **Parcial** para ver solo lo que salió mal 4. Haz clic en el evento para abrir el panel de detalle En el detalle, la sección **Error** muestra la causa explicada en lenguaje claro y el código de HubSpot al lado, además del texto original devuelto por HubSpot. Importante el historial se guarda durante **7 días** y la integración **no envía alertas** cuando algo falla. Un problema que empezó hace dos semanas ya no tiene registro, por eso conviene consultar el Historial con regularidad, sobre todo después de cambiar campos o etapas. ## Los campos dejaron de llegar a HubSpot, sin error visible **Lo que ves:** un contacto se actualizó en Nuvia, nada cambió en HubSpot y no apareció ningún mensaje en la pantalla. **Causa más común:** un campo de **lista desplegable** o de **opción múltiple** con un valor que no coincide exactamente con las opciones de la propiedad en HubSpot. Una diferencia de mayúsculas, acentos o espacios es suficiente. Cuando eso pasa, HubSpot **rechaza el registro completo**; todos los demás campos de ese contacto tampoco se guardan. **Cómo confirmarlo:** en el **Historial**, el evento aparece con estado **Error** o **Parcial** y el mensaje “El valor enviado no es una de las opciones aceptadas por la propiedad X en HubSpot.” **Cómo resolverlo:** 1. Abre la propiedad en HubSpot y copia el texto exacto de las opciones 2. En Nuvia, ajusta las opciones del campo para que sean idénticas 3. Modifica un contacto de prueba y confirma en el Historial que el estado volvió a **Éxito** Nota el envío se separa por objeto: contacto, deal y lead van en solicitudes independientes. Por eso el estado puede quedar **Parcial**: el contacto se guardó y el deal fue rechazado, o al revés. Lo que pasó sigue guardado. ## El mismo contacto se convirtió en dos registros en HubSpot **Causa:** antes de crear un contacto, Nuvia busca el registro en HubSpot por **teléfono** y por **correo electrónico**. La búsqueda por teléfono cubre el número en formato internacional, con y sin espacio después del +55. Si el número está guardado en HubSpot en otro formato, la búsqueda no lo encuentra y se crea un contacto nuevo. Formatos que la búsqueda **no** encuentra: - (11) 99999-9999 con paréntesis y guion - 11999999999 sin el código de país - Un número con el noveno dígito de un lado y sin el noveno dígito del otro - Números de otros países guardados en formato local **Cómo resolverlo:** 1. Estandariza los teléfonos en HubSpot en formato internacional (+5511999999999) 2. Completa el **correo electrónico** de los contactos en Nuvia siempre que sea posible; cuando hay correo, tiene prioridad sobre el teléfono en la búsqueda y la vinculación es mucho más precisa 3. Combina los registros duplicados en el propio HubSpot Nota Nuvia ya tiene una protección contra duplicados causados por demoras de HubSpot. Cuando la búsqueda no encuentra el contacto en el primer intento, espera unos **30 segundos** y busca de nuevo antes de crearlo, porque HubSpot tarda unos instantes en indexar un contacto recién creado. ## El mismo contacto apareció con dos deals en HubSpot **Causa:** en Nuvia, el contacto es único por teléfono dentro de la cuenta; **hablar con dos bandejas de entrada distintas no duplica el contacto**. El deal, en cambio, se vincula a la **conversación**. Antes de crear un deal nuevo, Nuvia busca en HubSpot un deal ya asociado a ese contacto **en el mismo pipeline** y reutiliza ese registro. Es decir: dos conversaciones del mismo contacto mapeadas al **mismo pipeline** comparten el mismo deal. Aparecen dos deals cuando: - Las conversaciones están mapeadas a **pipelines distintos** de HubSpot - El contacto **todavía no estaba vinculado** a un registro de HubSpot cuando se creó el deal - La consulta de los deals asociados al contacto falló en ese momento **Cómo resolverlo:** revisa en la pestaña **Embudos** qué etapas tienen activado el interruptor **Deal** y a qué pipelines de HubSpot apuntan. Si el objetivo es un único deal por cliente, mantén la creación de deals en una sola etapa y en un solo pipeline. Los deals ya duplicados deben combinarse en HubSpot. ## Los contactos de HubSpot no llegan a Nuvia **Causa probable:** el teléfono del contacto en HubSpot no tiene código de país o está en un formato que Nuvia no puede interpretar. Los contactos con teléfono inválido se descartan al entrar y ese descarte **no genera registro en el Historial**. **Cómo resolverlo:** 1. Abre la pestaña **Avanzado** y ubica **Configuración de teléfono** 2. Selecciona el **código de país predeterminado** de tu operación (por ejemplo, +55 - Brasil). La configuración se guarda automáticamente al seleccionarla 3. Verifica que el contacto tenga teléfono en HubSpot; los contactos sin teléfono no se crean en Nuvia Cómo funciona el código de país predeterminado: - Solo se aplica a números que **llegan de HubSpot** sin código de país - 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 el noveno dígito automáticamente - Los números con menos de 8 dígitos se descartan Importante el código de país predeterminado actúa **solo en la entrada**, en los números que vienen de HubSpot. **No modifica** 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 salen en un formato incorrecto, la corrección se hace en el registro del contacto, no en esta configuración. Dejar la opción **Ninguno (detectar automáticamente)** hace que Nuvia intente adivinar el país por los primeros dígitos del número, lo que puede fallar en números sin código de país. Si tu operación es mayoritariamente brasileña, define +55 explícitamente. ## El deal no cambia de etapa en HubSpot Verifica en este orden: 1. **¿Existe el mapeo?** En la pestaña **Embudos**, confirma que hay una fila que vincula esa etapa del embudo al deal stage de HubSpot 2. **¿El deal está cerrado?** Nuvia no mueve un deal ya marcado como ganado o perdido en HubSpot 3. **¿La etapa es anterior a la actual?** Nuvia no mueve el deal hacia atrás. Si el deal ya está en una etapa más avanzada, el movimiento se ignora 4. **¿La conversación está vinculada a un deal?** Sin vínculo, no hay nada que mover Los puntos 2 y 3 son protecciones intencionales; en esos casos el deal queda como está y el evento se registra en el Historial sin error. ## La conversación no avanza cuando muevo el deal en HubSpot **Causa:** por defecto, cada fila de mapeo es **Nuvia → HubSpot**, es decir, solo en el sentido de salida. **Cómo resolverlo:** en la pestaña **Embudos**, cambia la columna **Dirección** de esa etapa a **↔ Bidireccional** (equivale a activar el **Hubspot → Nuvia** de la fila). La conversación también tiene que estar vinculada a un deal. ## Errores de HubSpot y qué hacer Mensaje en el HistorialQué significaQué hacer **El valor no es una de las opciones aceptadas** Campo de selección con un valor fuera de las opciones de la propiedad Igualar el texto de las opciones en los dos sistemas **La propiedad es de solo lectura** La propiedad la calcula HubSpot y no acepta escritura Quitar ese campo del mapeo **La propiedad no existe en HubSpot** La propiedad se eliminó o se renombró en HubSpot Ejecutar **Avanzado > Sincronizar campos** y rehacer el mapeo **El teléfono no es válido para el código de país** HubSpot no acepta el número enviado Corregir el teléfono en el registro del contacto en Nuvia **La conexión con HubSpot venció** Hay que renovar la autorización Volver a conectar la cuenta en **Plataforma > Integraciones > HubSpotContacto duplicado en HubSpot** Ya existe un registro con ese valor único Combinar los duplicados en HubSpot **Límite de solicitudes alcanzado** Volumen por encima de lo que HubSpot acepta en ese momento Nada que hacer — Nuvia vuelve a intentarlo automáticamente **Servicio no disponible** Inestabilidad del lado de HubSpot Esperar y revisar el Historial después ## Preguntas frecuentes ## Preguntas frecuentes **¿Cómo sé que la integración está bien sin tener que abrir el Historial a cada rato?** Por ahora no existe una alerta automática de fallas de sincronización. El seguimiento se hace en la pestaña **Historial**, filtrando por **Error** y **Parcial**. Como los registros duran 7 días, una revisión semanal cubre toda la ventana disponible. **Un contacto desapareció de HubSpot. ¿Nuvia lo eliminó?** No. Nuvia nunca elimina registros en HubSpot, y las eliminaciones no se propagan en ningún sentido; eliminar de un lado no elimina del otro. **¿Cómo fuerzo la resincronización de un contacto?** Edita cualquier campo mapeado del contacto en Nuvia. El cambio dispara un nuevo envío. **El evento aparece como “Intento 2 de 3”. ¿Qué significa?** Cada envío tiene hasta 3 intentos en total, el envío original y dos reenvíos más, con una espera de unos 5 segundos y después 15 segundos. Si la falla es de validación, un valor que HubSpot rechaza, los tres intentos fallan igual, porque el dato enviado es el mismo. Reintentar solo resuelve una inestabilidad momentánea. **Encontré el problema y lo corregí. ¿Los datos antiguos se sincronizan solos?** No. La corrección vale para los próximos envíos. Para reenviar los registros que fallaron, edita los contactos afectados o vuelve a importar la lista correspondiente. [AnteriorCómo mapear campos entre Nuvia y HubSpot](https://nuvia.ai/es/docs/artigos/16474177-como-mapear-campos-entre-nuvia-y-hubspot) [SiguienteCó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) ¿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) - [Qué sincroniza Nuvia con HubSpot y cuándo](https://nuvia.ai/es/docs/artigos/16473526-que-sincroniza-nuvia-con-hubspot-y-cuando) [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/16474434-solucion-de-problemas-integracion-con-hubspot