Онлайн-чат для 1С-Битрикс: установка модуля за 5 минут

Сайты на 1С-Битрикс часто живут годами, обрастают доработками, и любое вмешательство в шаблон превращается в задачу для разработчика. Поэтому онлайн-чат для 1С-Битрикс удобнее всего ставить готовым модулем: он подключает виджет сам, без правки шаблона и без риска что-то сломать. В этой инструкции — установка модуля ChatDeck по шагам, вариант без модуля, работа с несколькими сайтами и передача данных авторизованных пользователей.

Что понадобится

• доступ к административной панели Битрикса с правами на установку решений;
• доступ к файлам сайта (FTP, SFTP или файловый менеджер хостинга) — чтобы загрузить модуль;
• аккаунт в ChatDeck и публичный ключ виджета вида pk_…. Ключ находится в настройках, в разделе с кодом установки.

Если аккаунта ещё нет, зарегистрируйтесь — это займёт минуту.

Установка модуля онлайн-чата в Битрикс

1. Скачайте модуль chatdeck.widget на странице интеграции с 1С-Битрикс.
2. Загрузите папку chatdeck.widget на сервер в каталог /local/modules. Если каталога /local/modules нет, создайте его.
3. Откройте административную панель и перейдите в раздел Marketplace → Установленные решения.
4. Найдите в списке ChatDeck и нажмите Установить.
5. В настройках модуля вставьте публичный ключ виджета и сохраните.
6. Откройте сайт в новой вкладке — в углу экрана появится кнопка чата.

Всё. Шаблон сайта при этом не меняется: модуль сам добавляет виджет на страницы. Обновление дизайна или смена шаблона его не затронут.

Совет: проверяйте сайт в режиме инкогнито или в другом браузере. Так вы увидите чат глазами обычного посетителя, а не администратора.

Как убедиться, что всё работает

• напишите тестовое сообщение в виджете на сайте;
• откройте панель операторов ChatDeck — диалог должен появиться во входящих;
• ответьте из панели и проверьте, что ответ пришёл в виджет.

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

Несколько сайтов на одной лицензии

Битрикс позволяет вести несколько сайтов в одной установке — например, основной магазин и отдельный сайт для оптовиков. Модуль ChatDeck поддерживает отдельный ключ для каждого сайта. Это удобно, если у сайтов разный дизайн или аудитория: для каждого можно указать свой ключ, а на сайте, где чат не нужен, просто не указывать его.

Передача данных авторизованных пользователей

Если посетитель вошёл в личный кабинет на вашем сайте, модуль передаёт в чат его имя и email. Оператор видит, с кем говорит, — не нужно спрашивать «как к вам обращаться» и «на какую почту оформлен заказ». Для анонимных посетителей чат работает как обычно.

Для разработчиков: если нужно передать дополнительные поля, это делается через JavaScript-вызов chatdeck('identify', {...}):

chatdeck('identify', {
  userId: '12345',
  name: 'Иван Петров',
  email: 'ivan@example.com'
})

Почему модуль удобнее ручной вставки кода

• Не нужно трогать шаблон. Чат подключается на уровне модуля, поэтому правки шаблона, обновления и смена дизайна его не затрагивают.
• Настройка в админке. Ключ меняется в настройках модуля, без доступа к файлам и без разработчика.
• Несколько сайтов в одном месте. Ключи для всех сайтов установки задаются в одних настройках.
• Данные пользователей из коробки. Имя и email авторизованных посетителей передаются в чат автоматически, без собственного кода.

Если сайтом занимается подрядчик, модуль снимает с него лишнюю задачу: менеджер может сам поменять ключ или отключить чат, не дожидаясь правок в шаблоне.

Установка без модуля

Если ставить модули нельзя — например, так настроены права или политика поддержки сайта, — виджет можно подключить одной строкой кода прямо в шаблоне.

1. Откройте файл шаблона сайта footer.php. Обычно он лежит в /local/templates/<ваш_шаблон>/ или в /bitrix/templates/<ваш_шаблон>/.
2. Вставьте код виджета перед закрывающим тегом </body>:

<script src="https://chatdeck.ru/widget.js" data-chatdeck-key="pk_…" async></script>

1. Замените pk_… на ваш ключ и сохраните файл.
2. Сбросьте кеш: Настройки → Настройки продукта → Автокеширование, вкладка очистки файлов кеша. Без этого на части страниц может отдаваться старая версия.
3. Проверьте сайт в режиме инкогнито.

Код можно вставить и в <head> — виджет работает в обоих вариантах. Атрибут async означает, что скрипт загружается параллельно и не задерживает отрисовку страницы.

Минус этого способа: при смене шаблона код нужно перенести вручную, а данные авторизованных пользователей придётся передавать самостоятельно через identify. Поэтому, если есть возможность, используйте модуль.

Не сломает ли чат вёрстку сайта

Частый страх владельцев сайтов на Битрикс — что сторонний виджет «поедет» из-за стилей шаблона или, наоборот, испортит их. Виджет ChatDeck работает в Shadow DOM — изолированном фрагменте страницы, куда не проникают стили сайта и откуда не выходят стили чата. Цвета, скругления, положение кнопки, её размер и тему (светлая, тёмная, автоматическая или свои цвета) вы настраиваете в панели ChatDeck, не трогая CSS сайта.

Что ещё стоит настроить после установки

• Рабочие часы — чтобы вне их посетители знали, когда ответят операторы.
• Уведомления — установите десктопное приложение для macOS или Windows или приложение для iOS, чтобы не пропускать новые чаты.
• ИИ-ассистент — может отвечать первым на типовые вопросы и передавать сложные оператору. Подробнее — в статье про ИИ-консультанта для сайта.
• Команда — пригласите операторов. Платы за оператора нет, их количество не ограничено.

Частые вопросы

Модуль работает с любой редакцией Битрикса?

Модуль ставится как обычное решение через раздел «Установленные решения». Если в вашей редакции установка сторонних модулей недоступна, используйте вариант без модуля — одна строка кода в шаблоне.

Почему после установки чат не появился?

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

Можно ли показывать чат только на части сайтов?

Да. Модуль поддерживает отдельные ключи для каждого сайта в установке: укажите ключ там, где чат нужен.

Замедлит ли виджет загрузку страниц?

Скрипт подключается асинхронно и не блокирует отрисовку страницы, а стили виджета изолированы от стилей сайта.

Подключите чат к своему сайту

Модуль, панель операторов и приложения бесплатны, без платы за каждого оператора. Создайте аккаунт в ChatDeck, скачайте модуль на странице интеграции с 1С-Битрикс — и через пять минут посетители смогут написать вам прямо с сайта. Как проверить установку и найти первый диалог, показано в уроке «Установка чата на сайт».