Перейти к содержимому
Инструкции
Установка по платформам
Bitrix

Bitrix

Эта инструкция для сайтов на Bitrix. EasyChat устанавливается как модуль, открывается из админки сайта и показывает чат на публичных страницах.

Скачать дистрибутивПерейти к установкеОткрыть кабинет
После установки обязательно настройте основной cron и проверьте его запуск. Он должен работать каждую минуту, даже без посетителей на сайте. Используйте команду для своей CMS из Настройки → Планировщик (Cron).

Перед Установкой

  • Скачайте пакет EasyChat для Bitrix с лендинга easychat24.ru.
  • Сделайте резервную копию сайта.
  • Подготовьте доступ администратора Bitrix.
  • Используйте Bitrix main 24.0.0+, UTF-8 и PHP 8.2 или новее. CP1251 больше не поддерживается актуальными версиями платформы.
  • Убедитесь, что сможете проверить публичную страницу после установки.
Не отправляйте в поддержку пароли, полные серверные пути и настройки базы данных. Для диагностики обычно достаточно скриншота ошибки и адреса сайта.

Установка

  1. Установите пакет EasyChat способом, который подходит вашей версии Bitrix.
  2. В административной части откройте Настройки → Настройки продукта → Настройки модулей → EasyChat — онлайн-чат для сайта.
  3. Нажмите кнопку открытия админки EasyChat.
  4. Проверьте, что интерфейс EasyChat открывается без ошибок.
Если вы публикуете версию через партнерский кабинет 1С-Битрикс, загружайте .last_version.zip. Архив tar.gz сохранен только для совместимости и на глубоком дереве файлов может быть отклонен встроенным распаковщиком Marketplace. Перед публикацией EasyChat связывает ZIP по SHA-256 с отдельным журналом официальной проверки безопасности Bitrix; старый журнал для нового архива не принимается.

Прямой адрес страницы настроек: /bitrix/admin/settings.php?lang=ru&mid=wellsoft.easychat&mid_menu=1. Если в вашей админке выбран другой язык, замените значение lang.

При нормальной установке EasyChat не просит вручную вводить параметры базы данных. Модуль использует настройки вашего Bitrix.

При установке из 1С-Битрикс Marketplace код модуля хранится в системном каталоге Bitrix, а публичная часть EasyChat автоматически подготавливается в /local/easychat — отдельном разрешённом каталоге сайта. Ничего копировать, менять в путях или настраивать вручную не нужно.

Первый Вход

Нажмите «Открыть админку EasyChat» в настройках модуля. Bitrix проверит администратора и защитный код текущей сессии, а EasyChat создаст одноразовый вход только в момент клика. Логин и неизвестный начальный пароль вводить не нужно.

Кнопка открывает отдельную защищённую административную страницу Bitrix, а уже она передаёт вас в EasyChat. Если вместо EasyChat открылась карта сайта, установите актуальное обновление и повторите вход из настроек модуля.

Если вместо админки открылась форма входа, не подбирайте пароль. Вернитесь в настройки модуля и нажмите кнопку еще раз. Если это повторяется после обновления, установите полный свежий пакет модуля и очистите кеш Bitrix и OPcache на хостинге, чтобы wrapper и EasyChat core были одной версии.

При первом входе из Bitrix EasyChat покажет короткий экран дополнительных возможностей: мобильное приложение, уведомления, AI-помощник и новости обновлений. Если сейчас это не нужно, пропустите экран.

Виджет На Сайте

Откройте публичную страницу сайта и проверьте:

  • кнопка чата видна посетителю;
  • окно чата открывается;
  • тестовое сообщение попадает в EasyChat;
  • ответ оператора появляется в виджете.

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

Фоновые Задачи

Для уведомлений, интеграций и AI нужны регулярные фоновые задачи. Откройте в EasyChat блок планировщика и используйте команду или ссылку, которую показывает именно ваш сайт.

Добавьте ее в панель хостинга примерно раз в минуту. Если не уверены, какой вариант выбрать, отправьте поддержку скриншота блока планировщика без паролей.

После Обновления

Сделайте резервную копию, установите новый пакет поверх текущего и откройте EasyChat из админки Bitrix.

Проверьте:

  • админка EasyChat открывается;
  • старые диалоги сохранились;
  • виджет работает на публичной странице;
  • тестовое сообщение приходит в список диалогов.

Частые Ситуации

  • Страница настроек сообщает об устаревшей демо-сборке. Раньше карточка EasyChat в Marketplace ошибочно распространялась в тестовом режиме. Сейчас модуль бесплатен: нажмите Проверить обновления и установите актуальную сборку. Удалять модуль и его данные вручную не нужно.
  • EasyChat не открывается из Bitrix. Проверьте права администратора и повторно откройте модуль EasyChat. Вход создается только защищенным нажатием кнопки в настройках; обычная форма логина не требует угадывать пароль.
  • Виджет не виден. Включите виджет и очистите кеш сайта.
  • Сообщения приходят с задержкой. Проверьте, что фоновые задачи включены на хостинге.
  • После установки появилась ошибка. Не удаляйте файлы и таблицы вручную. Обновите EasyChat до свежей версии и отправьте в поддержку безопасный скриншот ошибки.

Мини-Чеклист

  • Установлен пакет EasyChat для Bitrix.
  • Админка EasyChat открывается из Bitrix.
  • При входе из Bitrix не запрашивается неизвестный начальный пароль.
  • Виджет виден на публичной странице.
  • Тестовый диалог создан и оператор ответил.
  • Фоновые задачи добавлены в панель хостинга.

Обновление

EasyChat проверяет официальный релиз, а установку выполняет штатная система модулей 1С-Битрикс. Это сохраняет контроль платформы над файлами и миграциями. Подробнее о проверках.

Последнее обновление
OpenCartWordPress