Esta guía cubre la configuración de Fin Messenger con la transferencia a HubSpot. Los clientes chatean con Fin a través de Fin Messenger en tu sitio web; cuando Fin no puede resolver el problema, lo dirige a la cola de agentes de HubSpot o crea un nuevo ticket de HubSpot con la transcripción completa de la conversación.
Requisitos previos
Antes de comenzar, asegúrate de tener lo siguiente:
HubSpot conectado vía OAuth: Si aún no te has conectado, sigue los pasos en Fin for HubSpot tickets: Setup — omite esto si ya estás conectado.
Acceso al sitio web: Acceso al código de tu sitio web o app para instalar el fragmento de Fin Messenger.
Permisos de HubSpot: Acceso de administrador a tu cuenta de HubSpot para agregar un canal de inbox.
Consejo: Crea un usuario dedicado — por ejemplo, "Fin AI" — en lugar de usar una cuenta personal. Esto mantiene la propiedad de los tickets de Fin separada de las colas de tus compañeros y facilita la gestión de la integración si necesitas pausarla o revocarla.
Parte 1: Conectar con HubSpot
En Deploy > Fin Messenger puedes conectar con HubSpot.
Conectar con HubSpot
Conecta tu cuenta de HubSpot para darle a Fin acceso a las conversaciones y habilitar soporte potenciado por AI.
Haz clic en el botón "Conectar".
Serás redirigido a HubSpot para autenticarte
Una vez que te autentiques, serás redirigido de vuelta a Fin para continuar.
Al conectar Fin con HubSpot, aceptas nuestros términos de plataforma de terceros.
Instala el canal Fin Messenger en tu portal de HubSpot
Conecta el canal Fin Messenger en tu helpdesk de HubSpot para permitir que Fin responda preguntas entrantes.
Ve a tu portal de HubSpot.
Navega a CRM → Inbox → Configuración.
Haz clic en Conectar un canal.
Selecciona tu cuenta Fin Messenger de la lista para comenzar a recibir conversaciones de Fin Messenger en tu inbox de HubSpot.
Haz clic en Conectar con Fin messenger para continuar con la configuración.
Haz clic en Conectar para completar la configuración y conectar tu canal Fin Messenger a tu Helpdesk de HubSpot.
Opcionalmente, habilita Asignación automática de conversaciones para dirigir automáticamente las conversaciones entrantes a un compañero.
Una vez instalado, regresa a tu espacio de trabajo Fin y haz clic en Actualizar estado para continuar.
Consejo: Prueba el Messenger en un entorno QA antes de instalarlo en producción.
Agente Fin HubSpot
Elige qué agente de HubSpot debe actuar Fin al manejar conversaciones de Fin Messenger. Este usuario se convierte en el propietario de los tickets mientras Fin los gestiona activamente — dejando claro en HubSpot qué conversaciones maneja Fin y cuáles tus compañeros.
Nota: Recomendamos una cuenta dedicada en lugar de una personal — es más fácil depurar cuando está claro qué administrador está actuando, y protege contra problemas si se elimina la cuenta del agente o cambian sus permisos. Si un usuario de HubSpot no aparece en la lista, verifica que tenga un asiento de soporte válido y permisos correctos en HubSpot.
Sincronizar datos desde HubSpot
Este paso es opcional, primero debes conectar con HubSpot para sincronizar datos. Usa estos datos para dirigir tu contenido a diferentes audiencias, clasificar tickets automáticamente y crear ramas en workflows.
Parte 2: Construye tu workflow
Personaliza cómo Fin saluda y responde a los clientes, o transfiere cuando no puede ayudar. Navega a Administrar workflow en tu espacio de trabajo Fin para personalizar la experiencia y ponerla en vivo.
Un workflow con el disparador cuando un cliente abre una nueva conversación en Fin Messenger se auto-poblará con un flujo predeterminado. El workflow predeterminado incluye:
Un paso de triaje de Fin — Fin intenta resolver la pregunta del cliente usando tu knowledge base y contenido
Un camino de resolución — si Fin resuelve la consulta, la conversación se cierra
Un camino de transferencia — si Fin no puede resolverlo, la conversación se escala a la cola de agentes de HubSpot o se crea un nuevo ticket de HubSpot con la transcripción completa
Dentro del workflow puedes personalizar:
El mensaje de saludo que Fin envía cuando un cliente abre una conversación
El comportamiento de respuesta de Fin — tono, disparadores de escalación y segmentación de contenido
Las condiciones de transferencia — cuándo Fin dirige a un compañero vs. crea un ticket, y a qué inbox o cola de HubSpot dirigir. Hay dos modos de transferencia para elegir: Transferir a agente en HubSpot (cuando el canal Fin Messenger está instalado en tu inbox de HubSpot) o Transferir a ticket en HubSpot (cuando no lo está).
Nota: Con una conexión exitosa, Fin crea automáticamente 4 workflows de HubSpot: Resolución, Pendiente, Ruta al equipo y Asignar nuevos tickets. Para verlos en HubSpot, ve a Automatización > Workflows.
No elimines estos — son necesarios para que Fin gestione correctamente los tickets.
Parte 3: Instala Fin Messenger
Instala Fin Messenger para web
Para instalación web:
Elige tu método de instalación (Code snippet, React, Angular, Vue, Ember, Shopify)
Sigue las instrucciones específicas del método — copia el paquete NPM/fragmento de código y pégalo antes de la etiqueta en cada página donde quieras que aparezca el Messenger
Usa Comprobar instalación para verificar que funciona
Asegura el Messenger con JWTs (especialmente para usuarios conectados)
Instala Fin Messenger para móvil
Para la instalación móvil:
Elige tu plataforma (iOS, Android o React Native)
Inicializa Fin en tu base de código y sigue los pasos específicos para cada plataforma
Genera tu clave API del SDK de iOS si usas iOS
Usa Comprobar instalación para verificar
Asegura con JWTs
Opcional: configura notificaciones push
Parte 4: Prueba
Prueba la integración
Usa el panel de prueba de Fin: Navega a la pestaña Test en la barra lateral de Fin para previsualizar la calidad de respuesta y verificar rutas de escalación sin afectar tu sitio en vivo.
Controla dónde se muestra el Messenger: El Fin Messenger solo aparece donde instalas el fragmento de código. Para pruebas, instálalo en una URL de staging o usa reglas de URL en la sección Deploy para restringirlo a una página de prueba específica (p. ej.,
yoursite.com/test) antes de lanzarlo a todos los visitantes.
Nota: La integración debe estar en Live para que Fin responda. Como controlas dónde se instala el fragmento del Messenger, puedes probar con seguridad mientras está en vivo: instálalo en una URL de staging o usa reglas de URL en la sección Deploy para limitarlo a una página de prueba específica. Los clientes no lo verán a menos que visiten esa URL.
Parte 5: Pon en vivo Fin Messenger
Cuando estés satisfecho con tu configuración, selecciona Go live para activar Fin.
Tu configuración de escalación depende de si tienes el canal Fin Messenger instalado en tu inbox de HubSpot:
Transferencia a agente en HubSpot
Usa esta opción cuando el canal Fin Messenger está instalado en tu inbox de HubSpot. Cuando Fin no puede resolver una conversación, actualiza el ticket a "Waiting on us" y desasigna Fin para que un compañero pueda atenderlo en HubSpot.
Transferencia a ticket en HubSpot
Usa esta opción cuando el canal Fin Messenger no está instalado en tu inbox de HubSpot. Fin maneja toda la conversación en tu espacio de trabajo sin sincronizar con HubSpot. Al escalar, se crea un nuevo ticket de HubSpot con la transcripción completa.
Importante: Si desactivas la verificación de usuario (OTP) en la transferencia a ticket, los usuarios conectados ya no serán verificados antes de que se cree un ticket en HubSpot. Sin la verificación de identidad con JSON Web Token (JWT), un cliente podría hacerse pasar por otro usuario en HubSpot — esto es un riesgo serio de seguridad. Desactiva OTP solo si confías plenamente en tu configuración de autenticación actual. Aprende más sobre verificación de identidad del cliente con el paso de flujo de trabajo Email OTP.
Verificación de usuario
Al usar Transferencia a ticket en HubSpot, puedes requerir que los users verifiquen su dirección de correo electrónico antes de que se cree un ticket. Esto añade una capa extra de confirmación de identidad en el punto de escalación.
Exigir verificación de correo electrónico antes de la transferencia a ticket: Cuando está activado, los users deben verificar exitosamente su correo antes de que se cree un ticket en HubSpot en su nombre.
Requerir OTP cuando el Messenger no está seguro: Si el Messenger no está asegurado con verificación de identidad JSON Web Token (JWT), los users deben verificar su correo electrónico con una contraseña de un solo uso (OTP) antes de que continúe la transferencia. Esto evita que usuarios no verificados creen tickets bajo la identidad de otra persona.
Consejo: La configuración más segura es implementar la verificación de identidad JWT en tu Messenger. OTP es un recurso para instalaciones de Messenger no seguras, no un sustituto de la verificación adecuada de identidad.
Nota: Durante la transferencia del Messenger, si el cliente no existe ya como contacto en HubSpot, se crea automáticamente un nuevo contacto con la información recopilada durante la conversación.
Segmentación de audiencia y contenido
Si atiendes múltiples ubicaciones o marcas, configura Audiences separadas en Fin para cada una y adjunta los fragmentos y sincronizaciones web relevantes a cada audiencia.
Reglas de prioridad de audiencia
Una audiencia más amplia (p. ej., "URL contiene theescapegame.com") no será automáticamente anulada por una más específica (p. ej., "URL contiene theescapegame.com/nashville") a menos que la audiencia específica tenga mayor prioridad.
Si un visitante en una página específica de ubicación recibe contenido de la audiencia incorrecta, verifica que la regla de audiencia específica esté clasificada por encima de la general.
Importante: Al actualizar las audiencias objetivo de contenido después de sincronizar, elimina el contenido y vuelve a sincronizar. Simplemente actualizar la audiencia en contenido ya sincronizado puede no aplicarse correctamente. Este es un comportamiento conocido, no una limitación permanente, así que revisa actualizaciones.
Nota: Fin puede sincronizar contenido directamente desde las URLs de tu sitio web. Si actualizas contenido en una página sincronizada, necesitarás volver a sincronizar para que Fin detecte los cambios — Fin no detecta automáticamente las actualizaciones de página.
Desactivar vs. revocar
Cuando necesitas pausar o eliminar la integración de HubSpot, tienes dos opciones y es importante entender la diferencia.
Desactivar, pausa la integración sin destruir tu configuración. Todos los workflows de HubSpot creados por Fin se deshabilitan y las conversaciones dejan de enrutar a través de Fin. Tu configuración, conexión OAuth y propiedades de HubSpot se conservan. Puedes reactivar en cualquier momento y continuar donde lo dejaste.
Revocar, es una eliminación completa. La conexión OAuth se destruye, los 4 workflows de HubSpot creados por Fin se eliminan permanentemente y tu configuración de Fin se borra. Tendrás que pasar por todo el proceso de configuración nuevamente si quieres reconectar.
Tomando el control de una conversación de Fin
Si necesitas intervenir mientras Fin está manejando activamente una conversación en Messenger, no desasignes manualmente a Fin antes de responder. Desasignar a Fin primero significa que no procesará mensajes entrantes porque ya no está asignado.
En cambio, responde directamente en HubSpot sin cambiar la asignación. Fin detecta que un compañero respondió y se retira automáticamente — no enviará más respuestas y limpiará las etiquetas de Fin para reflejar la transferencia.
Preguntas frecuentes
¿Puedo evitar que Fin Messenger se abra automáticamente cuando un visitante regresa?
¿Puedo evitar que Fin Messenger se abra automáticamente cuando un visitante regresa?
Actualmente no hay una configuración nativa para evitar que Fin se reabra cuando un visitante regresa a la página. El visitante debe hacer clic manualmente en el ícono del Messenger para reabrirlo. Contacta a tu equipo de cuentas de Fin para registrar la demanda de esta función.
¿Puedo personalizar el mensaje "Tu conversación ha sido transferida"?
¿Puedo personalizar el mensaje "Tu conversación ha sido transferida"?
El mensaje de confirmación de transferencia ("Tu conversación ha sido transferida a un ticket de soporte. Recibirás actualizaciones por correo electrónico.") es un mensaje del sistema y no puede ser editado.
Fin Messenger no aparece en el sitio web
Fin Messenger no aparece en el sitio web
Confirma que el fragmento de código del Messenger está correctamente instalado en tu sitio web y verifica que el Messenger esté configurado en Live en la configuración Deploy de tu espacio de trabajo Fin. Hay un pop-out predeterminado "¿Necesitas ayuda?" que aparece después de 6 segundos. Actualmente este comportamiento no puede desactivarse completamente.
Se están creando tickets duplicados en HubSpot
Se están creando tickets duplicados en HubSpot
Los tickets duplicados se crean cuando ambos modos de handoff están activos al mismo tiempo. Aquí te explicamos cómo solucionarlo según tu configuración: Si usas Hand-off to agent en HubSpot: Elimina la app Fin Messenger de tu inbox de HubSpot (ve a Settings → Inboxes en HubSpot). Tener el canal Fin Messenger instalado en HubSpot al mismo tiempo hace que cada escalada genere dos tickets. Si usas Hand-off to ticket en HubSpot: No tengas también el canal Fin Messenger instalado en tu inbox de HubSpot. El canal Fin Messenger ya crea un ticket en el handoff — agregar un paso Hand-off to ticket en HubSpot duplica esto. Solo un método de handoff debe estar activo a la vez.
Fin está dando respuestas incorrectas para una ubicación específica
Fin está dando respuestas incorrectas para una ubicación específica
Verifica lo siguiente:
Confirma que tus Audiences estén configuradas correctamente y que la audiencia específica por ubicación tenga mayor prioridad que cualquier audiencia general.
Confirma que los snippets y web syncs relevantes estén asignados a la audiencia correcta, no a la general.
Usa la función Test de Fin para simular un visitante desde una URL específica y verificar qué contenido está obteniendo Fin.