Для установки нужен один фрагмент кода. На конструкторе его обычно можно добавить в настройках, а на самописном сайте — передать разработчику. Платформа должна разрешать выполнение стороннего JavaScript в основной странице сайта.
После нового онбординга
После сохранения агента откроется установка с коротким списком действий. Код можно поставить, пока агент изучает сайт. Выберите платформу; если её нет в списке или вы не знаете название, оставьте «Любой сайт / не знаю платформу». Код и пошаговую инструкцию можно скачать и передать разработчику.
После установки кода и публикации сайта виджет сразу начнёт работать. Отдельно включать показ не нужно. Чтобы проверить подключение, нажмите «Проверить установку», затем «Открыть сайт для проверки». Адрес можно указать без https://, например example.com. msg8 ждёт сигнал от установленного кода, поэтому само копирование не подтверждает установку.
Для заявок достаточно одного рабочего канала. Почта владельца включена по умолчанию, если уведомления не отключены. Telegram и CRM можно подключить позже, даже если вы выбрали их в онбординге. Для агента, который только отвечает и даёт контакты компании, канал заявок не обязателен.
Шаг 1. Скопируйте код установки
В дашборде нажмите «Установить на сайт» (кнопка в Песочнице) или откройте Настройки → Встраивание. Скопируйте сниппет — в нём уже подставлены ключ вашего проекта и идентификатор агента:
<script>
(function(){if(!window.Chatbot){window.Chatbot=function(){(window.Chatbot.q=window.Chatbot.q||[]).push(arguments)};window.Chatbot.q=window.Chatbot.q||[]}var s=document.createElement("script");s.src="https://widget.msg8.ai/widget/loader.min.js";s.async=true;s.dataset.key="ВАШ_КЛЮЧ_ПРОЕКТА";s.dataset.agent="идентификатор-агента";(document.head||document.documentElement).appendChild(s);})();
</script>
💡 Копируйте код именно из дашборда — там значения
data-keyиdata-agentуже заполнены под ваш проект и агента.
Шаг 2. Вставьте код на сайт
Добавьте код один раз в общий шаблон всех нужных страниц перед </body> или в поле общего пользовательского кода платформы. Код можно размещать и в <head>, если так устроена платформа. Обычный HTML-блок или iframe не всегда подходит: он может не выполнять JavaScript либо ограничить виджет рамками блока.
Если доступа к настройкам нет, скачайте инструкцию для разработчика. В ней будут адрес сайта, выбранная платформа, точный код вашего агента и порядок проверки.
Tilda
Откройте Настройки сайта → Ещё → HTML-код для вставки внутрь HEAD. Нужны именно настройки сайта, чтобы код появился на всех страницах. Добавьте код целиком, сохраните и опубликуйте все страницы. Нужен тариф с поддержкой собственного HTML. Проверяйте опубликованный сайт, не редактор. Инструкция Tilda.
WordPress и WooCommerce
Установите Insert Headers and Footers от WPCode, откройте Code Snippets → Header & Footer, вставьте код в Footer и сохраните. Если общий код уже добавляется другим плагином, используйте его. На WordPress.com требуется тариф Personal, Premium, Business или Commerce; бесплатный тариф не подходит. Инструкция WordPress.com.
Shopify
В Online Store → Themes сделайте копию темы и выберите Edit code. Добавьте код в layout/theme.liquid перед </body>, сохраните и опубликуйте нужную тему. При других layout-файлах попросите разработчика проверить и их. Способ относится к витрине, а не к оформлению заказа и новым страницам аккаунта покупателя. Пробную платную тему нужно купить для редактирования кода. Редактор Shopify, общие шаблоны Shopify.
1С-Битрикс: Управление сайтом
Активный шаблон указан в Настройки → Настройки продукта → Сайты → Список сайтов у нужного сайта. Разработчик сохраняет копию его footer.php и добавляет код перед </body>. Файл находится в /local/templates/<template-id>/footer.php или /bitrix/templates/<template-id>/footer.php. Общий файл ядра /bitrix/footer.php менять не нужно. Если шаблонов несколько, проверить каждый используемый шаблон. Это инструкция для CMS 1С-Битрикс, а не конструктора сайтов Битрикс24. Структура шаблона в документации 1С-Битрикс.
Wix
Нужны опубликованный сайт и подключённый домен. В Settings → Development & integrations → Custom Code → Add Custom Code добавьте код, выберите All pages, загрузку один раз за посещение и Body – end, затем Apply. Используйте Custom Code вместо HTML iframe. Wix ограничивает выполнение некоторых сторонних скриптов: если код блокируется, передайте ошибку поддержке msg8 или разработчику. После смены основного домена добавьте код заново: Wix удаляет прежние фрагменты. Инструкция Wix.
Webflow
Откройте Site settings → Custom code → Footer code, вставьте код и нажмите Save changes. Затем опубликуйте сайт на нужный домен через Publish. Нужен активный Site plan или Workspace Core, Growth, Agency или Freelancer; нужны права Site manager или Designer. Инструкция Webflow.
Squarespace
Откройте Pages → Custom Code → Code Injection (в версии 7.0: Pages → Website Tools → Code Injection), добавьте код в общее поле Footer и сохраните. Функция доступна на Core, Plus, Advanced и некоторых прежних тарифах. Страницы оформления заказа не поддерживают этот код. Инструкция Squarespace.
Для другой платформы используйте универсальную инструкцию. Если её тариф или редактор запрещает сторонний JavaScript, установку нужно согласовать с разработчиком или поддержкой платформы.
Шаг 3. Проверьте установку
Нажмите «Проверить установку» и откройте сайт через «Открыть сайт для проверки». Дождитесь подтверждения в msg8. Обновите сайт и задайте агенту вопрос. Проверьте главную, ещё одну страницу и мобильный экран.
⚠️ Виджета не видно на сайте?
- Проверьте, что адрес сайта есть в списке: Настройки агента → Безопасность → «Где можно показывать чат». Браузер не откроет чат на домене, которого там нет — это самая частая причина.
- Убедитесь, что скрипт скопирован целиком и сайт опубликован.
- Очистите кэш браузера или откройте сайт в режиме инкогнито.
- Если вы ранее отключали показ виджета, включите его в настройках агента.
- Если платформа требует публикации, проверьте, что изменения опубликованы именно на нужный домен.
💡 Если на сайте стоит Яндекс.Метрика или Google Analytics, виджет сам передаёт в них открытие чата, первое сообщение и оставленный контакт — подключать ничего не нужно, только создать цели по инструкции Цели в Метрике и Google Analytics.
Что дальше
- Внешний вид виджета настраивается в Песочнице на вкладке «Дизайн».
- Чтобы агент собирал заявки — раздел «Сбор лидов».
