# Подключение 1С-Битрикс: Управление сайтом

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

# Что потребуется

Для подключения нужен уже работающий интернет-магазин на «1С-Битрикс: Управление сайтом» и доступ к управлению им.

• Поддерживаемая конфигурация ChatRex: «1С-Битрикс: Управление сайтом», редакция «Малый бизнес», главный модуль main 26.200.0, кодировка UTF-8. Требуются модули iblock и catalog, PHP 8.2 или новее, MySQL 8.0 или новее. Таблица настроек b_option и таблица очереди модуля должны использовать InnoDB. Модуль проверяет это условие, но не меняет движок таблиц ядра.
• Права администратора на установку и настройку модуля, публичный домен магазина по HTTPS и хотя бы один видимый товар.
• Аккаунт ChatRex. Подписка на интеграцию оформляется отдельно в ChatRex; бесплатная установка модуля не означает бесплатную подписку.

# Установка и подключение

Модуль ChatRex — AI-консультант для интернет-магазина опубликован в Маркетплейсе 1С-Битрикс. Установка модуля бесплатна; подписка ChatRex оформляется отдельно.

1. Скопируйте адрес своего магазина. Откройте главную страницу магазина, как её открывают покупатели. Скопируйте адрес из верхней строки браузера — например, https://ваш-магазин.ru. Если не знаете адрес или данные для входа, попросите сотрудника, который занимается вашим сайтом.
2. Откройте установку ChatRex. Нажмите Установить в окне подключения 1С-Битрикс в ChatRex. На открывшейся странице модуля нажмите зелёную кнопку Установить.
3. Укажите, в какой магазин установить ChatRex. В появившееся поле с https:// вставьте скопированный адрес своего магазина и нажмите Установить. Откроется управление вашим магазином. Войдите администратором и завершите установку. Ознакомьтесь с условиями, которые показывает установщик, и подтвердите их, если согласны.
4. Подключите установленный модуль. В управлении магазином откройте Настройки → Настройки продукта → Настройки модулей → ChatRex. Выберите свой сайт и нажмите Подключить ChatRex. Если активный сайт один, он выбран автоматически. Если сайтов несколько, выберите нужный в поле Сайт магазина и проверьте домен.
5. Подтвердите подключение. Откроется ChatRex: войдите в свой аккаунт и подтвердите магазин. При необходимости оформите подписку в открывшейся карточке интеграции. Затем вернитесь в модуль Битрикса и нажмите Я подтвердил подключение.

Если модуль уже установлен, начните с шага 4. Повторная установка не требуется.

При подтверждении проверьте показанный домен магазина. Сам переход по ссылке или вход в аккаунт ещё не привязывает магазин. Пароль администратора сайта передавать в ChatRex не требуется. Привязка магазина не активирует платную подписку автоматически; создание бота не заменяет подписку.

# Проверка подключения

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

Дождитесь первой синхронизации каталога: карточка ChatRex обновит статус автоматически. Проверьте статус и время последней синхронизации на основном экране модуля. Кнопка Открыть ChatRex открывает карточку именно этого магазина.

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

# Какие товары передаются

Модуль читает каталог выбранного сайта с правами обычного посетителя. В ChatRex передаются опубликованные товары и варианты, базовые цены, доступные посетителю, названия, артикулы, описания, остатки, изображения и публичные ссылки. Для поиска по свойствам передаются только отмеченные для поиска свойства типов «Строка», «Число» и «Список». Закрытые типы цен, покупатели, заказы и пароль администратора не передаются.

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

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

# Обновление модуля

Обновляйте установленный модуль штатными средствами Маркетплейса в административной панели 1С-Битрикс. Удалять модуль перед обновлением не нужно: подключение магазина и настройки сохраняются.

После обновления откройте настройки ChatRex в 1С-Битрикс. Проверьте статус подключения, последнюю синхронизацию и ответ бота на товаре своего магазина.

# Дополнительные настройки

Для проверки очереди, обновления ключа или отключения магазина откройте Дополнительные настройки в модуле 1С-Битрикс. Поле Адрес ChatRex API в модуле для рабочего магазина должно содержать https://app.chatrex.pro.

# Автоматическая проверка домена

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

Если домен не подтверждается, администратору сайта нужно проверить запись в /upload/chatrex/verification/ и доступность статических TXT-файлов по HTTPS на стандартном порту 443, без перенаправления на другой адрес. После устранения причины повторите подключение из модуля. Недоступный файл не создаёт подключение и не резервирует домен.

# Обновление ключа подключения

В модуле 1С-Битрикс откройте Дополнительные настройки и нажмите Обновить ключ подключения. Отключать магазин и копировать секретный ключ не нужно. Модуль получает новый ключ сам; прежний работает до подтверждения смены.

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

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

# Очередь синхронизации

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

События, требующие восстановления, не отправляются заново автоматически. После устранения причины администратор нажимает Восстановить события в модуле 1С-Битрикс. Модуль сначала проверяет у ChatRex, было ли событие принято: уже обработанное не дублируется, а повторная отправка разрешается только после подтверждения сервера. Если товар успел измениться, для восстановления используются его актуальные данные. Неподтверждённые события остаются в очереди восстановления; кнопка не обходит проверку.

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

# Проверка и отключение

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

Для отключения при доступной связи нажмите Отключить ChatRex в Дополнительных настройках модуля. Подключение отзывается, а его синхронизированный каталог удаляется из ChatRex. Если сайт не может связаться с ChatRex, отключите интеграцию также в ChatRex. При удалении модуля можно отдельно выбрать сохранение его локальных настроек; товары магазина не удаляются. Если нужна помощь, напишите на support@chatrex.pro.