Integración HubSpot: el agente de Nodale sincroniza leads

Esta página es para el administrador de un espacio de trabajo de Nodale que conecta HubSpot. Explica qué solicita Nodale a HubSpot, qué escribe en él y qué lee de vuelta.

Instalar la integración

Necesitas ser administrador de tu espacio de trabajo de Nodale y un usuario de HubSpot con permiso para instalar aplicaciones en tu portal. Los demás miembros del espacio de trabajo ven la conexión, pero no pueden modificarla.

1. En Nodale, abre Settings, después Workspace, después Integrations, y elige la tarjeta HubSpot.
2. Haz clic en Connect HubSpot. HubSpot abre su página de consentimiento.
3. Elige el portal que quieres conectar, lee los scopes (listados más abajo) y acéptalos.
4. HubSpot te devuelve a Nodale, que muestra: «HubSpot is connected. Your portal is shown below.»

La tarjeta de conexión muestra entonces el portal, cuándo se conectó y la última sincronización. Un espacio de trabajo de Nodale conecta un único portal de HubSpot.

Al conectarse, Nodale añade a tu portal una propiedad de empresa oculta, Nodale record ID (nodale_external_id), en un grupo de propiedades llamado Nodale. Le permite a Nodale encontrar las empresas que ha creado.

Los scopes que solicita Nodale

HubSpot muestra estos scopes en su página de consentimiento. Todos son obligatorios.

Scope	Qué hace Nodale con él
oauth	Identifica el portal que has conectado.
crm.objects.contacts.read	Encuentra un contacto por su email y lee las propiedades que has mapeado.
crm.objects.contacts.write	Crea y actualiza contactos, y asocia un contacto a su empresa.
crm.objects.companies.read	Encuentra una empresa por su dominio o por su asociación con el contacto, y lee sus propiedades mapeadas.
crm.objects.companies.write	Crea y actualiza empresas.
crm.objects.deals.read	Lista tus pipelines de negocios y encuentra los negocios abiertos del contacto, para asociarles la nota.
crm.objects.deals.write	Se solicita junto con los scopes del CRM. Nodale no crea ni modifica ningún negocio.
crm.schemas.contacts.read	Lista las propiedades de contacto que puedes mapear.
crm.schemas.contacts.write	Crea una propiedad de contacto cuando la pides desde Nodale.
crm.schemas.companies.read	Lista las propiedades de empresa que puedes mapear.
crm.schemas.companies.write	Crea una propiedad de empresa cuando la pides, y la propiedad Nodale record ID.
crm.schemas.deals.read	Se solicita junto con los scopes del CRM. Nodale no mapea ninguna propiedad de negocio.
crm.schemas.deals.write	Se solicita junto con los scopes del CRM. Nodale no crea ninguna propiedad de negocio.
scheduler.meetings.meeting-link.read	Lee tus enlaces de reuniones de HubSpot, para que el agente reserve reuniones en ellos (ver más abajo).

Contactos y empresas

Cuándo lee y escribe Nodale en HubSpot

• En cuanto el visitante da un email, Nodale lee el contacto y su empresa en HubSpot, para que el agente sepa lo que tu CRM ya sabe de él. Leer nunca escribe nada en HubSpot.
• Después de cada conversación, una vez que Nodale ha redactado su resumen, envía el lead a HubSpot. Un lead se envía cuando tiene un email, esté cualificado o no.
• Los leads anteriores a la conexión no se envían.

Cómo encuentra Nodale el contacto y la empresa

• El contacto: el que Nodale ya ha asociado; si no, el que tiene el mismo email; si no, Nodale lo crea. Un contacto archivado no se toca.
• La empresa: la empresa principal del contacto en HubSpot; si no, la que Nodale ya ha asociado; si no, la empresa con el mismo dominio; si no, Nodale la crea con ese dominio y le asocia el contacto. No se busca ninguna empresa para una dirección de email personal (Gmail, por ejemplo).

Mapear los campos

Abre la pestaña Mapping de la página de HubSpot. Cada fila envía un campo de Nodale a una propiedad de HubSpot.

• Always sent here: el email va al email del contacto, el dominio de la empresa al domain de la empresa. Rellenan la propiedad cuando está vacía.
• Identity: nombre, apellido, cargo.
• Context: fuente UTM, medio UTM, campaña UTM y sitio de referencia, de la primera visita del lead.
• Qualification: los elementos del marco de cualificación de tu agente.
• Custom: los campos personalizados de tu espacio de trabajo, en el contacto o en la empresa.

La primera vez, Nodale propone un mapeo: los campos de identidad y de contexto asociados a las propiedades de HubSpot del mismo nombre. Valídalo o empieza en blanco.

Los cambios se quedan en borrador hasta que haces clic en Validate. Quitar un mapeo no borra ningún campo de Nodale ni ninguna propiedad de HubSpot. Un campo con error no se envía hasta que lo corriges; todo lo demás se sigue sincronizando.

Crear una propiedad de HubSpot. Para un campo sin propiedad, elige Create a HubSpot property: al validar, Nodale la añade a HubSpot en el grupo Nodale (con el nombre nodale_...) y envía el campo a ella.

Importar propiedades de HubSpot. Add HubSpot properties to Nodale convierte las propiedades de HubSpot que marcas en campos de Nodale, mapeados a ellas. Un desplegable se convierte en un campo de opciones, una casilla en un campo sí/no, y todo lo demás en texto.

Hacer coincidir los valores. Un campo de opciones enviado a un desplegable necesita que cada uno de sus valores coincida con una opción de HubSpot. No se envía hasta que todos los valores tienen la suya.

Elegir la dirección de sincronización

Cada campo mapeado tiene una dirección de sincronización. La predeterminada es Bi-sync on create, HubSpot priority on update. Un valor vacío en Nodale nunca vacía HubSpot.

Dirección de sincronización	Primer envío del lead	Envíos siguientes	Los dos tienen un valor
Bi-sync	Cada lado rellena el valor vacío del otro; un valor de HubSpot ya rellenado gana	Se propaga el lado que ha cambiado desde la última sincronización	Primer envío: gana HubSpot. Después, el lado que ha cambiado desde la última sincronización; HubSpot si han cambiado los dos
Bi-sync on create, HubSpot priority on update (predeterminada)	Cada lado rellena el valor vacío del otro	Gana HubSpot si tiene un valor; si no, Nodale lo rellena	Cada uno conserva el suyo en el primer envío, después gana HubSpot
HubSpot priority	El valor de HubSpot vuelve a Nodale; Nodale nunca escribe	Igual	Gana HubSpot
Nodale priority	Nodale escribe, incluso sobre un valor existente	Igual; no vuelve nada	Gana Nodale
Deactivate sync	No se envía nada	No se envía nada	Cada uno conserva el suyo

Por ejemplo, HubSpot tiene «Marketing Manager» como cargo y el visitante le dice al agente «Head of Growth». Con la opción predeterminada, HubSpot conserva «Marketing Manager». Con Nodale priority, HubSpot recibe «Head of Growth».

HubSpot devuelve valores a Nodale solo para el nombre, el apellido, el cargo y los campos de cualificación. Una propiedad de HubSpot de solo lectura solo puede estar en HubSpot priority o desactivada.

La nota de cada conversación

Cada conversación se convierte en una nota en HubSpot, asociada al contacto, a su empresa y a los negocios abiertos del contacto. Se escribe una vez y nunca se actualiza. Su fecha es el inicio de la conversación.

Elige lo que contiene en la pestaña Note. En este orden:

Bloque	Qué contiene	Se puede desactivar
Summary	A qué vino el visitante y cómo fue la conversación.	No
Next step	Lo que el agente recomienda hacer a continuación.	Sí
Qualification criteria	Los valores recogidos frente a tus criterios.	Sí
Qualification framework	Una línea corta por pilar de tu marco (MEDDIC por defecto; SPICED, BANT, CHAMP o NEAT), redactada a partir de la conversación. No se muestra cuando cualificas con tu propia lista.	Sí
Demos shown	Qué demos se reprodujeron.	Sí
Pages visited	Las páginas vistas antes y durante la conversación.	Sí
Open the lead in Nodale	Un enlace al lead.	No
Full transcript	La conversación completa, con líneas que empiezan por «Visitor:» o «Agent:».	Sí

Todos los bloques están activados por defecto. Una nota no supera el límite de tamaño de HubSpot: primero se acorta la transcripción («Transcript shortened, the full conversation is in Nodale.») y después se omiten los últimos bloques. El resumen y el enlace siempre se mantienen. Cuando el contenido de una conversación ya no se conserva, su nota va sin la transcripción.

Negocios

Nodale no crea ningún negocio ni modifica ninguno: ni importe, ni etapa, ni propiedad de negocio.

Asocia la nota de cada conversación a los negocios abiertos del contacto: los negocios del contacto en tu pipeline predeterminado (o, si no tiene ninguna etapa abierta, el primer pipeline que tenga una) cuya etapa no está cerrada. Un contacto que Nodale acaba de crear todavía no tiene ningún negocio, así que su primera nota va solo al contacto y a la empresa.

Reservar reuniones con HubSpot Meetings

El agente puede reservar reuniones en tus enlaces de reuniones de HubSpot, durante la conversación. Usa la misma conexión con HubSpot: no hay nada más que instalar. Un portal conectado antes de esta función muestra To reconnect en sus outcomes de reserva: reconecta HubSpot una vez para conceder el scope de los enlaces de reuniones.

1. En Nodale, abre Agents, después la pestaña Outcomes, y crea un New outcome de tipo Meeting booking.
2. Elige un Meeting type. Cada enlace de reuniones de HubSpot, personal o de equipo, figura una vez por duración, por ejemplo «HubSpot Meetings · Intro call · 30 min».
3. Asocia cada pregunta obligatoria del enlace de reuniones a un elemento que recoge el agente. El nombre y el email se rellenan automáticamente. Una pregunta de teléfono no es compatible: hazla opcional en HubSpot.

Cuando el visitante ha dado un email profesional y el momento es oportuno, el agente le ofrece horarios en su zona horaria y su idioma, y reserva el que elige. HubSpot crea la reunión con el nombre, el email, la zona horaria y las respuestas del visitante, según las reglas del propio enlace (horario, antelación, quién del equipo está disponible). Si el horario se ha ocupado mientras tanto, el agente ofrece otros.

Nodale no cancela ni cambia de fecha las reuniones: eso se hace en HubSpot.

Datos y desconexión

• Nodale solo escribe las propiedades que has mapeado, la nota y la propiedad de empresa Nodale record ID.
• Desconectar no borra nada en HubSpot. Borrar un lead en Nodale tampoco borra nada en HubSpot.
• Preguntas: support@nodale.ai.

Solución de problemas

Mensaje en Nodale	Qué ha pasado
HubSpot was not connected: access was refused on the HubSpot page.	La página de consentimiento se cerró o se rechazó.
The HubSpot connection link expired or was already used. Start again from this page.	El enlace es válido durante diez minutos y una sola vez. Vuelve a hacer clic en Connect HubSpot.
HubSpot did not answer. Please try again in a few minutes.	HubSpot no estaba disponible.
HubSpot refused the connection. Please try again, or contact support if it keeps happening.	HubSpot rechazó la solicitud.
Couldn’t connect HubSpot. Please try again.	Cualquier otro fallo.