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, ve a Connect en la navegación principal para autorizar el acceso de Fin a HubSpot — 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 del ticket 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
Ve a Connect en la navegación principal para conectar con HubSpot. La conexión se comparte entre HubSpot Tickets y Fin Messenger — si ya te conectaste para HubSpot Tickets, pasa al siguiente paso.
Conectar con HubSpot
Conecta tu cuenta de HubSpot para darle a Fin acceso a las conversaciones y habilitar soporte potenciado por IA.
Haz clic en el botón "Connect".
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.
En la página Deploy › Fin Messenger verás los pasos para configurar Fin Messenger.
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 → Settings.
Haz clic en Connect a channel.
Selecciona tu cuenta de Fin Messenger de la lista para comenzar a recibir conversaciones de Fin Messenger en tu inbox de HubSpot.
Haz clic en Connect with Fin messenger para continuar con la configuración.
Haz clic en Connect para completar la configuración y conectar tu canal Fin Messenger a tu helpdesk de HubSpot.
Opcionalmente, habilita Auto assign conversations para enrutar automáticamente las conversaciones entrantes a un compañero.
Una vez instalado, regresa a tu espacio de trabajo Fin y haz clic en Refresh status para continuar.
Consejo: Prueba el Messenger en un entorno de QA antes de instalarlo en producción.
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 automáticamente tickets y crear ramas en workflows.
Configura tu conexión a HubSpot
En la página Deploy › Fin Messenger, haz clic en Configura tu conexión a HubSpot. Esto abre una página de configuración con dos cosas por completar: selecciona el usuario de HubSpot como Fin actúa (usa una cuenta dedicada — por ejemplo, ‘Fin AI’ — en lugar de una personal), luego elige tu pipeline y asigna sus etapas a los estados de Fin.
Estado de Fin | Qué significa | Etapa predeterminada del pipeline de soporte |
Nuevo ticket | La etapa que Fin monitorea para recoger nuevos tickets | Nuevo |
Esperando al cliente | Fin mueve el ticket aquí mientras espera la respuesta del cliente | Esperando al contacto |
Esperando a tu equipo | Fin mueve el ticket aquí cuando se transfiere a un compañero humano | Esperando por nosotros |
Resuelto | Fin mueve el ticket aquí cuando resuelve una conversación | Cerrado |
Nota: Para encontrar los nombres de tu pipeline y etapas en HubSpot, ve a Settings > Data Management > Objects > Tickets > Pipelines y haz clic en el nombre de tu pipeline. Esta configuración se comparte en todos tus canales de HubSpot — si ya la configuraste para HubSpot Tickets, puedes omitir este paso. Para actualizar esta configuración en el futuro, ve a Settings > Channels > Fin Messenger.
Parte 2: Construye tu workflow
Personaliza la forma en que Fin saluda y responde a los clientes, o transfiere cuando no puede ayudar. En la página Deploy › Fin Messenger haz clic en Add 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 el Fin Messenger se auto-poblará con un flujo predeterminado. El workflow predeterminado incluye:
Un paso de triaje 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 HubSpot o se crea un nuevo ticket 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
Las condiciones de transferencia — cuándo Fin dirige a un compañero vs. crea un ticket, y a qué inbox o cola de HubSpot se dirige. Hay dos modos de transferencia para elegir: Hand-off to agent in HubSpot (cuando el canal Fin Messenger está instalado en tu inbox HubSpot) o Hand-off to ticket in HubSpot (cuando no lo está).
Parte 3: Instala el Fin Messenger
Instala Fin Messenger para web
Para la 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/code snippet y pégalo antes de la etiqueta en cada página donde quieras que aparezca el Messenger
Usa Check installation para verificar que funciona
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 de la plataforma
Genera tu clave API del SDK iOS si usas iOS
Usa Check installation para verificar
Opcional: configura notificaciones push
Parte 4: Prueba
Prueba la integración
Usa el panel de prueba Fin Test: Navega a la pestaña Test en la barra lateral de Fin para previsualizar la calidad de respuesta y verificar las 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 code snippet. 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 (por ejemplo,
yoursite.com/test) antes de lanzarlo a todos los visitantes.
Parte 5: Pon en vivo el Fin Messenger
Cuando estés listo, haz clic en Go live en el flujo de despliegue. Esto habilita los cuatro workflows HubSpot y Fin comenzará a manejar conversaciones basadas en el workflow y knowledge base que configuraste. Tu configuración de escalación depende de si tienes el canal Fin Messenger instalado en tu inbox HubSpot.
Transferencia a agente en HubSpot
Usa esta opción cuando el canal Fin Messenger está instalado en tu inbox HubSpot. Cuando Fin no puede resolver una conversación, actualiza el ticket a tu etapa waiting-on-team mapeada y desasigna a 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 HubSpot. Fin maneja toda la conversación en tu espacio de trabajo sin sincronizar con HubSpot. Al escalar, se crea un nuevo ticket HubSpot con la transcripción completa.
Importante: Si desactivas la verificación de usuario (OTP) al transferir a ticket, los usuarios con sesión iniciada ya no serán verificados antes de que se cree un ticket HubSpot. Sin la verificación de identidad JSON Web Token (JWT), un cliente podría suplantar a otro usuario en HubSpot — esto es un riesgo serio de seguridad. Solo desactiva OTP si confías plenamente en tu configuración de autenticación actual. Aprende más sobre verificar la identidad del cliente con el paso de workflow Email OTP.
Verificación de usuario
Cuando usas 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 transferir a ticket: Cuando está habilitado, los users deben verificar exitosamente su correo antes de que se cree un ticket HubSpot en su nombre.
Requerir OTP cuando el Messenger no es seguro: Si el Messenger no está asegurado con la 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 una solución alternativa para instalaciones de Messenger no seguras — no un sustituto para la verificación adecuada de identidad.
Nota: Durante la transferencia en Messenger, si el cliente no existe ya como contacto en HubSpot, se crea automáticamente un nuevo contacto usando 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 snippets y sincronizaciones web relevantes a cada audiencia.
Reglas de prioridad de audiencia
Una audiencia más amplia (por ejemplo, "URL contiene theescapegame.com") no será automáticamente anulada por una más específica (por ejemplo, "URL contiene theescapegame.com/nashville") a menos que la audiencia específica esté colocada en un orden de prioridad más alto.
Si un visitante en una página específica de ubicación está recibiendo contenido de la audiencia incorrecta, verifica que tu regla de audiencia específica esté clasificada por encima de la general.
Importante: Al actualizar las audiencias objetivo del 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 para 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, esto 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 remueve. Necesitarás 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 de 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 ha respondido 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 existe una configuración nativa para evitar que Fin se reabra cuando un visitante regresa a la página. El visitante tendría que hacer clic manualmente en el ícono de 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 de Messenger está correctamente instalado en tu sitio web y verifica que Messenger esté configurado como En vivo en la configuración de Deploy de tu espacio de trabajo Fin. Hay un pop-out predeterminado de "¿Necesitas ayuda?" que aparece después de 6 segundos. Este comportamiento no puede deshabilitarse completamente por ahora.
Se están creando tickets duplicados en HubSpot
Se están creando tickets duplicados en HubSpot
Se crean tickets duplicados cuando ambos modos de transferencia están activos al mismo tiempo. Aquí te explicamos cómo solucionarlo según tu configuración: Si usas Transferencia a agente en HubSpot: Elimina la aplicación Fin Messenger de tu inbox de HubSpot (ve a Configuración → Inboxes en HubSpot). Tener el canal Fin Messenger instalado en HubSpot al mismo tiempo hace que cada escalada genere dos tickets. Si usas Transferencia a 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 la transferencia — agregar un paso de Transferencia a ticket en HubSpot duplica esto. Solo un método de transferencia 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 de ubicación esté clasificada por encima de cualquier audiencia general en orden de prioridad.
Confirma que los fragmentos relevantes y las sincronizaciones web 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.