# Moguta.CMS

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

# Доступные действия

# Поиск товаров

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

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

Передайте идентификатор товара. Для выбранного варианта добавьте его идентификатор. Результат включает название, описание, артикул, цену, валюту, характеристики и варианты.

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

Передайте идентификатор товара и, если выбран вариант, его идентификатор. Действие возвращает доступность и известное количество выбранной позиции.

# Получение ссылки

Передайте идентификатор товара и, если выбран вариант, его идентификатор. Результат — публичная ссылка на соответствующую позицию витрины.

# Параметры действий

# Поиск и фильтры

Для поиска достаточно одного условия: текста (query), точного артикула (sku), категории (category) или характеристик (attributes). Если переданы несколько условий, результат должен соответствовать каждому из них. Фильтры применяются до выбора страницы.

• Текст ищется в названии, описании и артикуле без учёта регистра.
• Артикул сопоставляется точно с основным товаром или активным вариантом. Например, CN1 не заменяется товарами с артикулами CN16 или CN15.
• Категория — её ID, название или путь из Moguta.CMS. Подойдёт и часть названия. Родительская категория включает товары дочерних категорий.
• Характеристики задаются парами «название — значение». Используйте названия и значения из карточки Moguta.CMS. Для товара с вариантами все условия должны совпасть в одном активном варианте: размер одного варианта нельзя сочетать с цветом другого.

Названия характеристик сопоставляются без учёта регистра. Предпочитайте названия из ответа каталога. Для стандартных полей доступны четыре запасных ключа: size → «Размер», color → «Цвет», brand → «Бренд», material → «Материал». Реальное название поля каталога имеет приоритет. Другие синонимы не поддерживаются; неизвестные или неоднозначные названия и противоречивые значения одного поля не дают совпадения.

Размер, цвет и значения списков сопоставляются с отдельным значением целиком, без учёта регистра: L не совпадает с XL, «красный» — с «тёмно-красный». Если само значение содержит запятую, передавайте его целиком. Не объединяйте несколько вариантов выбора в одну строку. Для обычных текстовых полей и многострочного текста можно передать часть значения.

Лимит (limit) — от 1 до 20 результатов на странице, номер страницы (page) — от 1 до 1000. При подборе комплектации отдельные подходящие варианты считаются отдельными результатами. Если подходящего опубликованного товара или активного варианта нет, результат пустой. Нулевой остаток не скрывает вариант из поиска: перед обещанием наличия выполните отдельную проверку.

Если поиск возвращает search_too_broad, сузьте запрос: добавьте точный артикул, категорию или конкретную характеристику. Эта ошибка не означает, что товара нет.

# Идентификаторы товара и варианта

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

# Варианты и остатки

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

• Нулевой остаток означает отсутствие товара.
• Для ограниченного запаса возвращается точное количество.
• При неограниченном запасе количество не указано; бот сообщает доступность без выдуманного числа.

Не складывайте остатки разных вариантов и не обещайте количество, которого каталог не вернул. Неактивные товары и варианты не выдаются.

# Рекомендуемая последовательность

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

В предварительной проверке действия заполните параметры вручную. Затем задайте вопрос о том же товаре через подключённый чат на витрине и сравните ответ с Moguta.CMS. Для теста используйте отдельного бота и модель с поддержкой действий.

Все четыре действия работают в режиме чтения: они не создают заказ, не резервируют товар и не списывают оплату.