Solución de problemas de la integración con HubSpot

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.

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

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

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

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

Preguntas frecuentes