Si has instalado el Intercom Messenger y no aparece correctamente, aquí tienes algunas formas comunes de solucionarlo.
Este artículo cubre cualquier integración web. La integración web implica añadir el fragmento de código JavaScript en una página web o puede hacerse de forma más automática como nuestras apps de WordPress y Shopify que solo requieren hacer clic y autorizar.
Una regla general es que si ves el ping de Intercom en la consola web, entonces el código debería estar instalado correctamente.
1. ¿Tienes una suscripción que incluya el Messenger?
No podrás usar el Messenger si no tienes una prueba o suscripción de Intercom.
2. ¿Has activado el tráfico de usuarios?
Asegúrate de haber habilitado el tráfico de usuarios para Messenger en Configuración > Canales > Messenger > Instalar.
3. ¿Has instalado correctamente el fragmento de JavaScript de Intercom?
Hay dos formas de instalar el Intercom Messenger usando JavaScript:
Instala Intercom para visitantes o leads, para que puedas chatear con visitantes desconectados.
Instala Intercom para users, para que puedas chatear con users conectados.
Debes asegurarte de usar el fragmento de código JavaScript correcto en el lugar correcto.
Si has seguido las guías anteriores para instalar el fragmento pero aún no ves el Messenger, aquí están los siguientes pasos:
En el fragmento de código JavaScript, asegúrate de haber reemplazado el marcador de posición “
app_id” con tu ID de workspace.Necesitas añadir el fragmento justo antes del final de la etiqueta de cierre
</body>en tu sitio web o en tu app.
Nota: Si usas una Aplicación de Página Única (SPA), consulta la Guía de Integración SPA para pasos específicos para integrar el Messenger en un entorno SPA.
4. Si usas Google Tag Manager para instalar el Messenger, ¿estás apuntando a la región correcta?
Para una configuración correcta de GTM, asegúrate de que el script de GTM esté colocado en la sección <head> de tu HTML y que las etiquetas estén configuradas y publicadas correctamente. Para más información, consulta la Guía de Instalación GTM.
Esta app usa un método sin código para instalar el Intercom Messenger. Si vas a usar GTM con un workspace regional, necesitarás pasar "api_base" como un atributo de datos personalizado, bajo la sección "tracking custom data about your users" con el valor regional:
Consulta este artículo para más información.
5. ¿Qué APP_ID estás usando? ¿Tienes múltiples apps?
¿Lo has introducido incorrectamente o tienes múltiples apps? Revisa el app_id en la solicitud ping (En Chrome: clic derecho en la página > Inspeccionar > Red); si no ves el ping, recarga la página.
También puedes intentar revisar intercomSettings en la consola, pero esto solo aplica para apps no single-page. Las apps single-page pueden no tener intercomSettings definido.
6. ¿Hay un ping en la página?
Abre la consola y prueba un método rápido para cargar el Messenger con Intercom('show');
Si eso no funciona, busca la solicitud ping (probablemente necesitarás recargar la página para verla). Si no ves ninguna solicitud ping, es probable que el fragmento de Intercom no esté instalado o no esté instalado correctamente.
7. ¿Tienes habilitadas las configuraciones correctas del Messenger?
Hay varias formas de personalizar el Messenger y añadir capas extra de seguridad. Sin embargo, algunas configuraciones pueden impedir que el Messenger se cargue si están configuradas incorrectamente.
Al instalar el Messenger, es posible ocultarlo a tu audiencia antes del lanzamiento:
¿Estás mostrando el lanzador del Messenger a las personas correctas?
En configuración del Messenger, puedes "Controlar el volumen de tus conversaciones entrantes" y configurar el lanzador del Messenger para mostrarlo a visitantes o users, o si coinciden con ciertos datos.
Si eliges mostrar el Messenger a visitantes o users que coincidan con ciertos datos, tus clientes (y tú) deberán coincidir con esos datos para ver aparecer el Messenger. Por ejemplo, si solo quieres mostrar el Messenger a users con estado "VIP", solo los users con esos datos verán el Messenger.
¿Has aplicado una configuración de seguridad del Messenger, pero no está configurada correctamente?
El Messenger no se cargará si la autenticación JWT / Verificación de Identidad está configurada incorrectamente. Además, la API del Messenger debe estar habilitada en la configuración de tu app para que la interfaz Switch funcione correctamente. Si la API del Messenger está deshabilitada, Switch no se cargará y puede mostrar una página en blanco.
Con los JWT, necesitas generar un token único para las solicitudes de tu user y proporcionarlo al iniciar al user. Este token único se genera usando tu clave secreta de la API del Messenger y al menos el ID único externo de tu user.
Con la Verificación de Identidad, usas la clave secreta de la configuración de seguridad de Intercom para generar un hash único para cada uno de tus users conectados, que envías junto con otros datos del user al Messenger.
Si aplicas una configuración de seguridad del Messenger sin enviar correctamente tokens o hashes a través de tu integración del Messenger para cada user, el Messenger no se cargará para ellos. De manera similar, si aplicas la Verificación de Identidad con tokens o hashes inválidos para cada user, el Messenger fallará al cargar.
La forma más fácil de ver si esta es la causa de tu problema es abrir la consola del navegador y buscar mensajes de error específicos.
Lee más sobre cómo solucionar errores específicos de JWT aquí o errores de Verificación de Identidad aquí 📚
¿Estás en un domain confiable?
En Mantén tu Messenger seguro puedes listar los domains confiables donde has instalado Intercom.
Si estos domains se han añadido incorrectamente o el domain en el que estás no está listado, el Messenger no se cargará y verás un error 403 en la consola del navegador.
Pasos para encontrar errores de domains confiables en la consola:
Abre la consola, haz clic en Red y luego actualiza la página.
Filtra las solicitudes de red escribiendo "ping".
Haz clic en la pestaña Respuesta.
8. ¿Estás usando un domain con sufijo público?
Instalar Intercom en tu sitio web depende de que el Messenger pueda crear una cookie de primera parte para tu domain, como *.customer-domain.com. Esto fallará (con navegadores modernos) en cualquier domain registrado como sufijo público, como firebaseapp.com o herokuapp.com. Consulta la lista completa de domains con sufijo público aquí.
9. ¿Ves un error 409 marcado en la consola?
Si ves un error 409 marcado en la consola, esto indica un conflicto. Normalmente este conflicto es causado por múltiples users existentes con la misma dirección de correo electrónico y que Intercom no sabe cuál intentas iniciar sesión.
Para resolver esto, puedes:
Usa un
user_idcomo identificador único al iniciar sesión de tus users.
Otras cosas para revisar
¿Usas una extensión para bloquear anuncios o modo de navegación privada?
Algunas extensiones para bloquear anuncios también bloquean JavaScript que incluye funcionalidad de seguimiento, como el Messenger. Descubre por qué sucede esto y qué hacer al respecto aquí.
¿Has modificado el fragmento de JavaScript de Intercom o aplicado estilos personalizados al messenger?
Cambiar el código de instalación o aplicar tu propio CSS a los elementos de Intercom puede tener resultados inesperados, por lo que no recomendamos hacerlo. Si tienes un caso específico en mente, chatea con nuestro equipo de soporte en el Messenger. Podemos orientarte. 😄 Además, asegúrate de que el parámetro hide_default_launcher en el objeto intercomSettings no esté configurado en true a menos que sea intencionado. Ajusta o elimina este parámetro si entra en conflicto con las reglas de visibilidad especificadas.
¿Estás usando el plugin de WordPress?
Si usas el plugin de Intercom para WordPress para chatear solo con visitantes desconectados, necesitarás cerrar sesión del panel de administración de WordPress antes de visitar tu sitio para ver aparecer el Messenger.
También debes tener WordPress 4.2.0 y PHP 5.6 o superior para que el Messenger se cargue correctamente cuando se instala con el plugin.
Algunos temas de WordPress no incluyen el elemento footer donde el plugin inserta el fragmento de JavaScript de Intercom. Si usas un tema sin footer, necesitarás instalar Intercom con el fragmento de JavaScript directamente en tus páginas de WordPress.
Otras formas de revisar errores
Puedes revisar la consola de tu navegador para cualquier otro error si tu Messenger aún no se carga correctamente. Aquí te mostramos cómo revisar en cada navegador web:
En Chrome usa el atajo de teclado ctrl + shift + J (Windows) o command + option + J (Mac) para abrir la consola de desarrollador.
En Firefox, usa el atajo de teclado ctrl + shift + K (Windows) o command + option + K (Mac). La caja de herramientas aparecerá en la parte inferior de la ventana del navegador, con la Consola Web activada.
En Edge, usa la tecla F12 para acceder a las Herramientas de Desarrollador F12. Una vez dentro, navega a la pestaña Consola.
En Safari, necesitarás activar el menú Desarrollar. Abre el menú Safari en la barra de menús de Mac y selecciona “Preferencias”. Luego, navega a la pestaña Avanzado y marca la casilla "Mostrar menú Desarrollar en la barra de menús". Ahora puedes usar el atajo de teclado command + option + C para abrir la consola de desarrollador.
Si aún tienes problemas para cargar el Messenger, chatea con nosotros en el Messenger y estaremos encantados de ayudarte.
¿Qué pasa si el Messenger no aparece en mi propio inbox y no puedo contactar con soporte?
Se decidió ocultar el Messenger en algunas situaciones dentro del Inbox para que no chocara con la barra lateral/Copilot. La solución es ir a otra página en la app y abrir el lanzador del Messenger desde allí.
Nota: Si no puedes acceder a la configuración del Messenger, asegúrate de tener habilitado el permiso "Puede acceder a la configuración del Messenger" permiso.