# Подключение HostCMS

Интеграция предназначена для консультаций по опубликованному каталогу выбранного сайта и магазина HostCMS: поиска товаров, проверки цены и наличия, выбора модификации и получения ссылки на витрину.

# Что подготовить

Проверенная конфигурация — HostCMS 7.1.7 «Старт» с модулями Интернет-магазин и Планировщик, PHP 8.2 или новее, PDO MySQL, OpenSSL, mbstring и cURL. Совместимость с другими версиями и редакциями ещё не проверена.

Нужны администратор с правом установки модулей и доступом к выбранному сайту, опубликованный HTTPS-магазин и хотя бы один видимый товар. Администратор хостинга должен настроить запуск штатного cron/schedule.php HostCMS раз в минуту.

Подписка интеграции оформляется отдельно в ChatRex. Лицензия HostCMS и подписка ChatRex — разные услуги.

# Подключение каталога

1. Откройте ChatRex AI Sales Assistant в Магазине приложений HostCMS и установите модуль штатным установщиком. Выберите сайт и интернет-магазин.
2. Откройте настройки модуля ChatRex и проверьте Сайт, Интернет-магазин и Склады для проверки наличия. Отмечайте только склады, остатки которых можно показывать покупателям. Без выбранных складов физический остаток будет равен нулю; неограниченные цифровые товары учитываются отдельно.
3. Нажмите Создать код подключения. Скопируйте Адрес модуля и Одноразовый код. Код действует десять минут; пароль администратора HostCMS передавать не нужно.
4. В ChatRex откройте Интеграции → Подключить интеграцию → Источники данных, выберите HostCMS.
5. Заполните Адрес подключения из модуля полным HTTPS-адресом и Одноразовый код, затем нажмите Подключить каталог.
6. Дождитесь статуса Подключено. Если для интеграции нужна подписка, проверьте её условия в открывшемся окне ChatRex. При повторном подключении действующая подписка сохраняется.

Если ответа нет из-за временной недоступности сайта, повторите попытку с тем же кодом до истечения его срока. Если ChatRex сообщает, что код истёк или уже использован, создайте новый. Магазин, связанный с другим подключением, сначала нужно отключить в прежней записи.

# Консультант по каталогу

В разделе ботов выберите шаблон HostCMS. Заполните название магазина, имя консультанта, описание ассортимента, правила доставки, оплаты и возврата, стиль общения и сообщение при невозможности получить данные. На шаге Источник выберите подключённый магазин HostCMS и проверьте итоговые настройки.

Вместо шаблона можно добавить четыре действия HostCMS существующему боту. Настройка сообщения о передаче вопроса специалисту сама по себе не подключает оператора и не создаёт заявку.

# Чат на витрине

1. Подключите онлайн-чат для сайта, разрешите в его настройках точный домен магазина и назначьте канал нужному боту.
2. В подключении HostCMS откройте блок Чат на сайте, выберите этот чат и нажмите Установить виджет.
3. Дождитесь подтверждения модуля, перезагрузите опубликованную страницу магазина и отправьте тестовый вопрос о товаре. Проверьте чат на компьютере и телефоне.

На одном сайте настраивается один виджет. Если код ChatRex уже вставлен вручную, автоматическая вставка не должна создавать второй чат. За удаление ручной вставки отвечает администратор сайта. При использовании кэша страниц или CSP потребуется проверка настроек хостинга; готовая совместимость со всеми шаблонами ещё не подтверждена.

# Обновление, отключение и удаление

Перед обновлением сохраните файлы модуля, его таблицы и файл ключа modules/chatrex/config/secret.php в защищённой резервной копии. Ключ и базу нужно восстанавливать вместе. Передавать этот файл в поддержку не требуется. Обновление должно сохранять подключение и уже настроенные задания планировщика, включая их паузы.

Чтобы отключить каталог, нажмите Разорвать соединение в ChatRex или Отозвать доступ в модуле HostCMS. Если одна сторона недоступна, отключите подключение и на другой стороне. Затем обновите страницы витрины и очистите их кэш.

Подготовленное удаление модуля убирает его доступ, автоматически настроенный виджет, собственные задания и таблицы; товары и заказы сохраняются. В HostCMS отключение модуля также вызывает его удаление: после повторного включения потребуется новое подключение. Ручные вставки чата удаляются отдельно.

Отключение интеграции не удаляет уже существующие диалоги ChatRex. Для удаления данных аккаунта обратитесь в support@chatrex.pro.

# Проверка результата

Сравните с витриной найденный товар, цену с валютой, выбранную модификацию, остаток и возвращённую ссылку. Проверьте отдельно товар с нулевым остатком и неограниченный цифровой товар. Бот не должен придумывать количество или сообщать об оформленном заказе: эти действия только читают каталог.