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

Универсальная установка

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

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

Когда Выбирать Этот Вариант

  • вашей CMS нет в списке готовых платформ;
  • сайт сделан на собственной системе;
  • вы хотите сами выбрать папку EasyChat и место вставки виджета.

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

  • Скачайте универсальный пакет EasyChat с лендинга easychat24.ru.
  • Сделайте резервную копию файлов и базы данных.
  • Подготовьте доступ к файлам сайта.
  • Уточните, в какой шаблон сайта вставляются общие скрипты.
Не публикуйте файлы с паролями, ключами внешних сервисов и настройками подключения. Если нужна помощь, отправляйте скриншоты без секретов.

Установка

  1. Загрузите папку EasyChat на сайт.
  2. Откройте страницу установки.
  3. Заполните данные, которые просит установщик.
  4. Создайте администратора EasyChat.
  5. После установки войдите в админку.

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

Пункты Подключить сервисы EasyChat24 и Получать важные новости EasyChat24 независимы. Технические сервисы заранее выбраны как рекомендуемая настройка для Android-приложения и push-уведомлений: до сохранения их можно отключить или пропустить весь экран. Новости остаются выключены, пока вы сами не включите подписку и не укажете email. Переписка, клиенты, заказы, пароли и API-ключи при этом не передаются.

Подключить Виджет

Добавьте код виджета в общий шаблон сайта или только на нужные страницы:

<script src="https://example.com/easychat/index.php?route=widget" async></script>

Замените example.com/easychat на адрес вашей установки EasyChat.

После вставки откройте публичную страницу сайта и проверьте, что кнопка чата появилась. Если сайт использует кеш, очистите кеш сайта и браузера.

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

Универсальная установка не подключена к планировщику CMS, поэтому фоновые задачи нужно добавить в панели хостинга.

Откройте в EasyChat раздел Планировщик и скопируйте команду или ссылку, которую показывает ваша установка. Добавьте ее в хостинг примерно раз в минуту. Не копируйте команды из чужих инструкций: путь и версия PHP у каждого сайта свои. Готовая консольная команда показана на чёрном фоне; значок $ служит только визуальной подсказкой и в буфер обмена не попадает.

Используйте PHP CLI 7.4 или новее. EasyChat показывает абсолютный путь только после проверки PHP, нужных расширений и целевого файла; проверенный hosting alias сохраняется в копируемой строке, а короткие имена не угадываются. Пересекающиеся запуски безопасно пропускает внутренний lock EasyChat, поэтому команда не зависит от системной утилиты flock. Не указывайте один только путь к cron.php: без PHP-интерпретатора планировщик обычно отвечает Permission denied. После сохранения нажмите Проверить запуск и дождитесь подтверждения от реально выполненной фоновой задачи.

Полную строку вставляйте в тип задания «Произвольная команда». См. официальную инструкцию Beget.

EasyChat проверяет не только версию PHP, но и доступ CLI к базе. На некоторых хостингах сайт и планировщик используют разные настройки PHP: установка через браузер проходит, а в cron нет mysqli. Модуль mysqlnd без mysqli этого не исправляет. Если EasyChat покажет такое предупреждение, выберите в панели другой PHP CLI либо попросите поддержку хостинга включить mysqli для CLI. Переключаться на старый драйвер mysql не нужно — он удалён из PHP 7. Для полной работы основной фоновой задачи также включите в CLI расширение curl: оно нужно для связи с мессенджерами, маркетплейсами, ИИ и служебными сервисами EasyChat.

Обновление

Перед обновлением сделайте резервную копию. Затем загрузите новую версию поверх текущей папки EasyChat, не удаляя настройки, вложения и логи.

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

Проверка

  1. Откройте админку EasyChat.
  2. Проверьте вход администратора.
  3. Откройте страницу сайта с виджетом.
  4. Отправьте тестовое сообщение.
  5. Ответьте оператором и проверьте ответ в виджете.

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

  • Кнопка чата не появилась. Код добавлен не в тот шаблон или страница показывает старый кеш.
  • Админка не открывается. Проверьте, что все файлы загружены полностью.
  • Настройки не сохраняются. Проверьте права на папки установки.
  • Сообщения приходят с задержкой. Проверьте фоновую задачу на хостинге.

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

  • Резервная копия создана.
  • Файлы EasyChat загружены.
  • Админка открывается.
  • Код виджета подключен.
  • Фоновая задача добавлена на хостинге.
  • Первый диалог проверен.

Обновление

Для Generic PHP в EasyChat доступна транзакционная установка по кнопке: проверка подписи и архива, резервная копия, публикация и автоматический откат при ошибке. Конфигурация, переписка, загрузки и журналы не заменяются файлами релиза. Подробнее о проверках.

Админка EasyChatПроверьте EasyChat после установки. Виджет на сайтеПодключите и проверьте код виджета. Частые вопросыРазберите ошибку установки.

Конфликт хранилища

Если EasyChat сообщает, что хранилище недоступно, проверьте с администратором хостинга собственные папки EasyChat, права записи и правила доступа. Не направляйте вложения или журналы в общие папки магазина. При неизвестных защитных правилах EasyChat сохраняет файл и останавливает свою операцию. После устранения конфликта повторите установку.

Фотографии операторов и вспомогательные изображения чатов также сохраняются в собственных папках EasyChat. После обновления проверьте фотографию оператора и открытие вложения.

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