Base de conocimiento de GetMyBot

Instalar en una aplicación React, Next.js o Vue

Añade el chat a una aplicación React, Next.js o Vue y mantenlo abierto al cambiar de página.

En esta página

En una aplicación React, Next.js o Vue, las páginas suelen cambiar sin recargar el navegador. El código del widget debe estar en la plantilla general de la aplicación para que el chat no desaparezca durante esos cambios.

Copia el fragmento completo de Widget → Instalación y añade el dominio de la aplicación a Sitios permitidos. La ubicación exacta del código depende de cómo se haya creado el sitio; puedes pasar estas instrucciones a su desarrollador. Consulta Widget en el sitio para configurar el chat.

Dónde colocar el código

Inserta el fragmento una sola vez en la plantilla general, que permanece al navegar por el sitio:

  • Next.js con App Router: en app/layout.tsx, dentro de <head>, o con el componente Script y strategy="afterInteractive".
  • Next.js con Pages Router: en pages/_document.tsx, dentro de <Head>.
  • Vue con Vite o Vue Router: en index.html de la raíz del proyecto, dentro de <head>. Si usas Nuxt, pide al desarrollador que lo añada a la plantilla general.
  • React con Create React App: en public/index.html, dentro de <head>. React con Vite: en index.html de la raíz del proyecto, dentro de <head>.

No lo añadas a una página individual: al navegar, la aplicación puede eliminar esa página junto con el chat abierto.

Cómo comprobar la instalación

Abre el chat y ve a otra página mediante el menú de la aplicación. Comprueba que el chat y la conversación siguen abiertos. Luego envía un mensaje y comprueba que aparece en GetMyBot.

Publica el cambio, abre Widget → Instalación en GetMyBot y pulsa Comprobar instalación sobre la página publicada. Consulta Diagnóstico automático para entender el resultado.

Por qué se añade el código una sola vez

El chat abierto debe permanecer al cambiar de página. Por eso, el widget se carga en una plantilla que no se elimina durante la navegación.

El cargador conserva la sesión existente mediante window.mybot = window.mybot || {}. Cargarlo otra vez no crea un segundo widget, pero si la aplicación elimina la página junto con el chat se puede perder el estado aún no guardado. No hace falta ejecutar el script en cada cambio de página.

Posibles problemas

  • No repitas el fragmento en páginas individuales: la aplicación puede eliminarlas junto con el chat.
  • Si usas el componente Script de Next.js, elige strategy="afterInteractive", no "beforeInteractive", para no retrasar la primera visualización.
  • Si el servidor o la CDN guarda copias de las páginas, vacía esa caché al publicar. De lo contrario, los visitantes seguirán viendo una versión antigua sin el código.

Siguientes pasos