Requisitos previos
- Una cuenta de HubSpot con permiso para autorizar nuevas conexiones de apps para el portal.
- Un plan de Scanova que incluya la integración con HubSpot. Sin él, al conectar aparece el error “Your plan does not include HubSpot integration”.
- Al menos un formulario del Form-builder o un código QR con una fuente de respuestas (Custom Form, Feedback, RSVP, consulta de Real Estate o feedback de Restaurant) ya configurada, ya que el asistente necesita algo desde donde sincronizar.
Configurar una conexión
HubSpot se abre como una página completa propia (no como un panel lateral), porque el asistente necesita el espacio.1
Abrir la integración de HubSpot
Desde Integrations, selecciona Add Integration, busca la tarjeta de HubSpot y selecciona Setup.
2
Conectar HubSpot
Selecciona Connect HubSpot. Se te redirige a HubSpot para autorizar a Scanova y luego vuelves al asistente. Un banner verde muestra el ID del portal conectado una vez que la autorización se completa correctamente.
3
Elegir qué sincronizar
Elige el tipo de fuente de respuestas: Forms (cualquier formulario del Form-builder), Custom Form Component, Feedback Form (Feedback QR Code), RSVP Form Component, Inquiry Form (Real Estate QR Code) o Feedback Form (Restaurant QR Code).
4
Seleccionar la fuente
Según el tipo elegido, busca y selecciona el formulario o código QR específico cuyas respuestas deben sincronizarse.
5
Elegir la acción de HubSpot
Selecciona qué objeto de HubSpot debe crear cada respuesta: Create Contact, Create Company, Create Deal o Create Ticket.
6
Mapear campos
Relaciona los campos de tu fuente con las propiedades de HubSpot. Las propiedades destacadas de HubSpot para el objeto elegido aparecen preseleccionadas; usa Add a field para mapear propiedades adicionales del catálogo completo. Los mapeos incompatibles se bloquean en línea — por ejemplo, una propiedad numérica de HubSpot no puede mapearse a un campo de texto, y una propiedad de fecha no puede mapearse a un campo que no sea de fecha.
Un mapeo que el asistente no marca como inválido pero que aun así no puede convertirse al tipo de la propiedad de HubSpot se descarta silenciosamente en el momento de la sincronización, en lugar de causar un error — la validación en línea existe precisamente para detectar esto antes de que ocurra.
7
Revisar, probar y completar
Nombra la conexión (se usará después para identificarla en Active Connections), revisa el resumen del mapeo y, opcionalmente, selecciona Send test para enviar un registro de prueba a HubSpot y confirmar que llega antes de seleccionar Complete setup.
Gestionar la conexión
- Disconnect (en el banner de conexión) detiene la sincronización de todo el portal — cada conexión de HubSpot asociada a él deja de enviar datos.
- Editar una conexión existente desde Active Connections vuelve a abrir el mismo asistente de 5 pasos, ya prellenado.
Qué datos fluyen y hacia dónde
Cada vez que el formulario o código QR configurado recibe una nueva respuesta, Scanova envía los valores de los campos mapeados a HubSpot como un nuevo registro del tipo de objeto elegido (Contact, Company, Deal o Ticket) en el portal conectado.Relacionado
- Slack — otra integración conectada por OAuth, con su propio creador de reglas con nombre.
- Webhooks — una alternativa genérica si necesitas enviar datos de respuestas a un destino que HubSpot no cubre.
- Form management — la API detrás de las fuentes de Forms desde las que sincroniza este asistente.
- Lead list management — la API detrás de las fuentes heredadas de sincronización de Lead List.