# Действия 1С-Битрикс: Управление сайтом

Сначала подключите магазин через модуль ChatRex. В редакторе бота откройте Интеграции и действия и выберите подключение 1С-Битрикс. Действия читают синхронизированный каталог; для вызова ботом нужна действующая подписка или доступный деморежим ChatRex. Требования к версии CMS, PHP и базе данных приведены в инструкции подключения.

# Настройка торгового бота

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

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

Шаблон использует восемь правил работы с каталогом. Сохраните их и при самостоятельной настройке бота:

1. Прежде чем сообщать название, цену, вариант, наличие или ссылку, получите эти данные подходящим действием интеграции.
2. Не придумывайте товары, свойства, цены, остатки, скидки, валюту или ссылки.
3. При нескольких похожих товарах предложите не более трёх и задайте один уточняющий вопрос.
4. Перед рекомендацией варианта проверьте его наличие.
5. Передавайте цену и валюту точно из ответа магазина.
6. Если интеграция недоступна или товар не найден, сообщите об этом и предложите помощь оператора.
7. Не показывайте покупателю внутренние идентификаторы, JSON, названия действий и технические ошибки.
8. Не обещайте резервирование, создание заказа или скидку: эти действия только консультируют по каталогу.

# Найти товары в 1С-Битрикс

Передайте поисковый запрос длиной 2–200 символов. При необходимости укажите категорию, артикул, свойства и лимит от 1 до 20. Действие вернёт опубликованные товары и признак наличия следующих результатов.

Поиск учитывает название и артикул. Категория и свойства уточняют запрос. Названия и значения свойств берите из карточки товара: модуль передаёт только свойства типов «Строка», «Число» и «Список», отмеченные в 1С-Битрикс для поиска. Закрытые поля и типы цен недоступны боту.

# Получить товар из 1С-Битрикс

Передайте product_id из результата поиска. Действие вернёт название, артикул, цену, валюту, доступность, варианты, описание и ссылку.

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

# Проверить наличие в 1С-Битрикс

Передайте product_id. Если у товара несколько вариантов, сначала уточните у покупателя нужный вариант и передайте его variant_id из карточки товара. Без выбора действие не выполнится и не вернёт общий остаток вместо остатка варианта. Если вариант единственный, он выбирается автоматически.

Результат содержит доступность и известный остаток выбранного товара или варианта. Наличие не означает резервирование.

# Получить ссылку на товар

Передайте product_id. Действие вернёт публичную ссылку на карточку товара.

# Свежесть каталога

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

По умолчанию синхронизация каталога и данные выбранного товара должны быть не старше 48 часов. Если подходящий товар устарел, действие сообщает о необходимости восстановить синхронизацию, а не выдаёт старую цену или остаток и не скрывает товар как «не найденный». Обновление другой позиции не меняет возраст этих данных. Время получения результата соответствует синхронизации выданных товаров; само выполнение действия не делает их свежими.

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

# Последовательность в диалоге

1. Найдите товары по запросу покупателя и предложите подходящие позиции.
2. Получите карточку выбранного товара, уточните нужный вариант.
3. Проверьте наличие именно этого варианта и сообщите цену с валютой.
4. Дайте ссылку на карточку магазина.

Идентификаторы берите из предыдущего результата действия. Если товар скрыт, отсутствует в подключённом каталоге или проверка завершилась ошибкой, не придумывайте цену, остаток или ссылку. Эти действия не создают и не изменяют заказы, не резервируют товар и не списывают оплату.