База знаний GetMyBot

Установка в приложении на React, Next.js или Vue

Как добавить чат в приложение на React, Next.js или Vue, чтобы он сохранялся при переходах между страницами.

На этой странице

В приложении на React, Next.js или Vue страницы часто переключаются без полной перезагрузки браузера. Код виджета нужно подключить в общем шаблоне приложения, чтобы чат не исчезал при таком переходе.

Скопируйте фрагмент из «Виджет → Установка» и добавьте домен приложения в «Разрешённые сайты». Размещение кода ниже предназначено для разработчика сайта. Настройки чата описаны в статье «Виджет на сайте».

Куда вставить фрагмент

Вставьте весь фрагмент один раз в общий шаблон приложения, который остаётся на месте при переходе между страницами. Размещение зависит от технологии сайта:

  • Next.js (App Router): корневой app/layout.tsx, внутри <head> (или через компонент Script со strategy="afterInteractive").
  • Next.js (Pages Router): pages/_document.tsx, внутри <Head>.
  • Vue с Vite или Vue Router: index.html в корне проекта, внутри <head>. Для Nuxt передайте фрагмент разработчику: он должен подключить его в общем шаблоне приложения.
  • React с Create React App: public/index.html, внутри <head>. React с Vite: index.html в корне проекта, внутри <head>.

Не вставляйте фрагмент в отдельную страницу: при переходе приложение может удалить её вместе с открытым чатом.

Как проверить установку

Опубликуйте изменение. Откройте чат и перейдите на другую страницу через меню приложения. Убедитесь, что чат и текущий разговор сохранились. Затем отправьте сообщение и проверьте его в кабинете.

Затем откройте «Виджет» → «Установка» в кабинете и запустите «Проверить установку» на опубликованной странице. Результат проверки готовности виджета описан в разделе «Автоматическая диагностика».

Почему код добавляют один раз

При смене страницы открытый чат должен остаться на месте. Поэтому подключайте виджет в общем шаблоне, который не удаляется при переходах, а не внутри отдельной страницы.

Загрузчик сохраняет существующую сессию через window.mybot = window.mybot || {}, а повторное подключение не создаёт второй виджет. Но если приложение удалит страницу вместе с чатом, несохранённое состояние потеряется. Поэтому повторно запускать скрипт при каждом переходе не нужно.

Подводные камни

  • Не добавляйте фрагмент повторно на отдельные страницы: при переходе приложение может удалить их вместе с чатом.
  • В приложении на Next.js с компонентом Script для загрузчика используйте strategy="afterInteractive", а не "beforeInteractive", чтобы не блокировать первую отрисовку.
  • Если сервер или CDN сохраняет копии страниц, очистите этот кэш при публикации. Иначе посетители продолжат получать старую страницу без нового кода.

Что дальше