Mapa completo de lo que sale de Nuvia hacia HubSpot, de lo que entra de HubSpot a Nuvia, qué dispara cada envío y en cuánto tiempo aparece el dato del otro lado.
Disponible en: Plataforma > Integraciones > HubSpot
Quién puede hacerlo: Administrador
Qué va y qué viene
| Objeto | Nuvia → HubSpot | HubSpot → Nuvia |
|---|---|---|
| Contacto | Crea o vincula el contacto y guarda los campos mapeados | Crea o actualiza el contacto en Nuvia con los campos mapeados |
| Deal (negocio) | Crea el deal y mueve la etapa según el mapeo del embudo | Mueve la conversación vinculada, cuando la etapa está marcada como bidireccional |
| Lead | Crea el lead y guarda la etiqueta de la etapa | Vincula el lead a la conversación abierta y mueve la etapa, cuando está marcada como bidireccional |
| Empresa | Nuvia no la crea ni la modifica | Enriquece el registro de empresa de Nuvia por el dominio |
| Transcripción de la conversación | Se envía como registro de comunicación al contacto y/o al deal, cuando la conversación se finaliza o automáticamente (cerca de 1 h después del último mensaje) | No aplica |
| Owner (responsable) | Se guarda cuando se asigna un agente manualmente en Nuvia | Actualiza el agente de la conversación abierta, según el mapeo de usuarios |
Los dos disparadores de sincronización
Nuvia tiene dos mecanismos independientes, configurados en pestañas distintas, que no se reemplazan entre sí.
|
Por campo |
Por etapa del embudo | |
| Dónde se configura | Pestaña Campos | Pestaña Embudos |
| Qué lo dispara | Un campo mapeado cambia en el contacto o en la conversación | La conversación cambia de etapa en el embudo |
| Qué pasa | Las propiedades mapeadas se guardan en el contacto, en el deal y en el lead | Se crean o vinculan el contacto, el deal y el lead, y se actualiza la etapa del deal |
| ¿Depende del otro? | No | No |
En otras palabras: mapear un campo no mueve ninguna etapa, y mapear una etapa no sincroniza ningún campo. Si quieres las dos cosas, tienes que configurar las dos pestañas.
En cuánto tiempo llega el dato
No hay un intervalo programado ni sincronización cada hora. Todo se dispara por eventos, en el momento en que ocurren.
-
HubSpot → Nuvia: HubSpot avisa a Nuvia en cuanto el registro cambia.
-
Nuvia → HubSpot: el envío ocurre en cuanto se hace el cambio.
No hay carga inicial al conectar
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 están en HubSpot, usa la importación de listas: en la integración, entra a Listas, busca la lista que quieres y haz clic en Importar miembros.
Lo mismo vale en el sentido inverso: un contacto antiguo de Nuvia solo se envía a HubSpot cuando sufre algún cambio o cuando su conversación avanza a una etapa mapeada.
Nuvia no le devuelve a HubSpot lo que vino de allí
Cuando un cambio de etapa llega desde HubSpot y mueve la conversación en Nuvia, Nuvia no reenvía ese mismo cambio de vuelta. Esto evita el efecto de eco entre los dos sistemas.
Reglas que protegen tu pipeline en HubSpot
Al mover un deal, Nuvia verifica su situación actual antes de escribir:
-
Un deal ya cerrado (ganado o perdido) en HubSpot no se mueve.
-
Una etapa anterior a la actual no se aplica; el deal no retrocede.
En los dos casos el deal queda como está y el evento se registra en el Historial, sin error. Estas protecciones valen solo para deals. Las etapas de contacto (Lifecycle Stage y Lead Status) y de lead se guardan directamente, aunque representen un retroceso.
La verificación depende de que Nuvia pueda leer el pipeline en HubSpot. Si la lectura falla, o si la etapa actual del deal no se encuentra en el pipeline, Nuvia escribe de todos modos; la protección no bloquea por precaución.
Transcripción de la conversación
En la pestaña Avanzado, el interruptor Enviar transcripción de la conversación a HubSpot registra las conversaciones de Nuvia en la línea de tiempo de actividades de HubSpot, como registro de comunicación. El interruptor viene desactivado por defecto. Al activarlo, eliges adónde va la transcripción y cuándo.
Adónde:
-
Contacto: la transcripción queda en la línea de tiempo del contacto.
-
Negocio (deal): la transcripción queda en la línea de tiempo del deal vinculado a la conversación. Si la conversación no tiene un deal vinculado, no se envía nada al negocio.
Puedes marcar los dos destinos al mismo tiempo, y cada uno tiene su propia regla de envío. El último destino marcado no se puede desmarcar: para dejar de enviar, desactiva el interruptor.
Cuándo (por destino):
-
Cuando se finalice la conversación: la transcripción completa se envía una vez, al finalizar la conversación.
-
Automático: Nuvia envía la conversación por partes, cerca de 1 h después del último mensaje, y al menos 1 vez al día si la conversación no se detiene. Es útil cuando las conversaciones tardan en finalizarse. Cuando la conversación se finaliza, el envío de lo que aún estaba pendiente se adelanta.
Al activar el interruptor por primera vez, Nuvia ya marca Contacto con Cuando se finalice la conversación, que es el comportamiento anterior. Quien ya usaba la transcripción sigue con ese mismo comportamiento.
-
Vale para conversaciones de WhatsApp y LinkedIn. Las conversaciones de otros canales no generan envío.
-
Las transcripciones muy largas se dividen en partes secuenciales en HubSpot.
-
En el modo Automático, cuando una parte abarca más de un día, el primer mensaje de cada día aparece con fecha y hora (por ejemplo, 30/09 09:21). Así no confundes mensajes de días distintos.