Установка
- Скопируйте код. В панели управления откройте Настройки → Установка. В коде уже стоит ID вашей организации.
- Вставьте его на все страницы сайта — перед закрывающим
</body>или внутри<head>. В конструкторах сайтов (Tilda, Wix, WordPress и других) для этого есть поле «свой код» в настройках сайта, в Google Tag Manager — тег «Пользовательский HTML». - Проверьте. Откройте сайт: в углу появится кнопка чата. Отправьте тестовое сообщение — оно придёт в панель, в раздел «Диалоги».
<script>
(function(d, w, c) {
w.SvyazioConfig = {
orgId: "ВАШ_ORG_ID",
serverUrl: "https://app.svyazio.ru"
};
w[c] = w[c] || function() {
(w[c].q = w[c].q || []).push(arguments);
};
var s = d.createElement('script');
s.async = true;
s.src = 'https://app.svyazio.ru/widget/svyazio.js';
if (d.head) d.head.appendChild(s);
})(document, window, 'Svyazio');
</script>Что делает каждая часть кода:
SvyazioConfig— настройки виджета. Сюда дописываются все параметры из этой документации.- Функция
Svyazio— очередь. Пока основной скрипт загружается, вызовы вродеSvyazio('openChat')складываются в неё и выполняются, как только виджет готов. Поэтому методы можно вызывать сразу, не дожидаясь загрузки. - Скрипт
svyazio.jsзагружается асинхронно и не задерживает отрисовку страницы.
Где вставить код в конструкторах и CMS
Код один и тот же везде — отличается только место, куда его вставляют. После вставки опубликуйте сайт заново, если конструктор этого требует.
Tilda
Настройки сайта → Ещё → «HTML-код для вставки внутрь body» (подойдёт и «внутрь head»). Вставьте код, сохраните и нажмите «Опубликовать все страницы» — без публикации изменения не попадут на сайт.
WordPress
Проще всего через плагин для вставки кода (например, WPCode — раздел «Footer»). Без плагина — в файле темы footer.php перед </body>; лучше в дочерней теме, иначе обновление темы удалит код.
1С-Битрикс
В шаблоне сайта: Настройки → Настройки продукта → Сайты → Шаблоны сайтов → нужный шаблон, файл footer.php, перед </body>. Если шаблонов несколько (например, отдельный для мобильной версии), добавьте код в каждый.
Wix и Webflow
Wix: Настройки → Пользовательский код → Добавить код, место «Body — end», применить ко всем страницам. Webflow: Project Settings → Custom Code → Footer Code, затем Publish.
Google Tag Manager
Создайте тег «Пользовательский HTML», вставьте код целиком, триггер — «All Pages», опубликуйте контейнер. Данные посетителя из dataLayer можно передавать в чат тем же тегом — пример в рецептах. Если на сайте строгий CSP с nonce, сниппет из GTM не унаследует его — см. CSP.
Как проверить, что всё работает
Откройте сайт в новой вкладке. Кнопка чата появляется в углу через секунду-две после загрузки. Если её нет, откройте консоль браузера (F12 → Console) и введите:
typeof window.SvyazioWidget // 'object' — виджет запущен
window.SvyazioConfig.orgId // должен совпадать с ID в кабинете
Svyazio('openChat'); // окно чата должно открытьсяЕсли SvyazioWidget — undefined, скрипт не загрузился или в конфигурации нет orgId. Разбор типичных причин — в разделе «Если что-то не работает».
Как убрать виджет
Удалите код установки из шаблона и опубликуйте сайт. Временно скрыть чат на отдельных страницах без правки шаблона можно параметром startHidden или методом hide.