# Подключение DIAFAN.CMS

ChatRex отвечает по опубликованным товарам выбранного раздела магазина и языка: находит товары, получает карточки, проверяет наличие и возвращает ссылки на витрину.

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

• DIAFAN.CMS 7 с модулем Интернет-магазин, PHP 7.4 и доступом администратора.
• Опубликованную витрину с действующим HTTPS-сертификатом.
• Раздел магазина, язык и код основной валюты, например RUB.
• Доступ к настройке cron на хостинге и резервную копию сайта.

Условия лицензии CMS и подписка ChatRex оформляются отдельно.

# Установите модуль в DIAFAN

1. В административной части откройте Дополнения для сайта.
2. Найдите ChatRex — AI-консультант для DIAFAN.CMS и нажмите Установить. Дождитесь сообщения Дополнение установлено.
3. Откройте появившийся пункт ChatRex. Выберите Раздел магазина, заполните Основная валюта (код ISO) и проверьте Публичный адрес этой языковой версии.
4. Нажмите Получить код подключения. Скопируйте Адрес модуля и Одноразовый код.

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

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

1. Откройте ChatRex → Интеграции → Подключить интеграцию → Источники данных → DIAFAN.CMS.
2. На вкладке Установка соединения заполните Адрес подключения из модуля и Одноразовый код. Пароль администратора CMS не требуется.
3. Нажмите Подключить каталог и дождитесь статуса Подключено.
4. Проверьте доступ к интеграции. Если действующей подписки или демодоступа нет, ChatRex предложит оформить подписку. При повторном подключении существующая подписка сохраняется.

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

# Настройте фоновые проверки

В панели хостинга создайте задание cron раз в минуту. Команда показана в настройках модуля ChatRex в DIAFAN: используйте указанный полный путь к chatrex.cron.php и тот же PHP 7.4, который обслуживает сайт.

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

# Настройте бота и чат

Создайте бота из шаблона DIAFAN.CMS или добавьте существующему боту четыре действия каталога. В каждой операции выберите подключение нужного магазина. Укажите правила доставки, оплаты и возврата, а также ответ при недоступности данных.

Для чата на витрине:

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

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

# Обновление и отключение

Перед обновлением сохраните базу данных CMS и файл modules/chatrex/config/secret.php. Установите доступное обновление в разделе Дополнения для сайта. При обычном обновлении подключение и ключ сохраняются.

Разорвать соединение в ChatRex или Отключить в настройках модуля отзывает доступ к каталогу и автоматически убирает виджет. Если сайт недоступен, отключите модуль и в CMS.

Для удаления снимите отметку ChatRex в Модули и БД и нажмите Обновить. Удаляются собственные данные и ключ модуля, виджет перестаёт загружаться, ChatRex получает уведомление об отключении. Товары, варианты и заказы CMS сохраняются. Старые диалоги ChatRex не удаляются.

После повторной установки заново задайте валюту, получите код и подключите существующую интеграцию. Ещё раз нажмите Установить виджет. Старый ключ больше не действует.

# Проверка перед запуском

Проверьте два товара, варианты, цену с валютой, скидку, остаток и ссылку. Измените тестовую цену или наличие в CMS и повторите поиск. DIAFAN может изменить идентификаторы вариантов при сохранении товара: используйте их из свежего результата, не сохраняйте старые ID в постоянных настройках действий.

При выключенном учёте остатков точное количество неизвестно. Бот должен сообщать только подтверждённую доступность. Если данные недоступны, предложите помощь специалиста; текст ответа сам по себе не настраивает перевод к оператору.

Помощь: support@chatrex.pro.