Wildberries

Приложение Wildberries подключает кабинет продавца к рабочему пространству Promto. Агент может читать товары, заказы, остатки, цены, акции, отзывы, вопросы и отчёты, а после явного подтверждения — выполнять поддерживаемые изменения в кабинете.

Подключение

1. Откройте кабинет продавца Wildberries: Настройки → Доступ к API.
2. Создайте токен и выдайте только необходимые категории доступа.
3. Для полной работы выберите нужные категории: Контент, Маркетплейс, Статистика, Цены и скидки, Продвижение, Вопросы и отзывы, Поставки.
4. Скопируйте токен: кабинет может не показать его повторно.
5. В Promto откройте Wildberries, нажмите Подключить и вставьте токен.
6. Дождитесь проверки. Promto безопасными запросами определит реально доступные категории.

Срок действия токена задаётся в кабинете Wildberries и может составлять до 180 дней. После истечения создайте новый токен и переподключите интеграцию.

Интерфейс приложения

Приложение показывает подключение и экран Настройки. Там видны маска токена, найденные категории доступа, состояние последней проверки и действие отключения.

Рабочие данные не дублируются отдельными таблицами внутри приложения: товары, заказы и отчёты запрашиваются через агента в чате. Начать можно с готовых подсказок Wildberries в новом чате или написать задачу своими словами.

Работа с агентом

Основной агент использует инструмент promto_wildberries. Это встроенный инструмент чата, а не команда оболочки.

Задача	Действия инструмента
Товары	list_products
Заказы	list_orders, update_order_status
Остатки и цены	list_stocks, get_prices
Продвижение	list_promotions
Обратная связь	list_feedbacks, reply_feedback, list_questions
Финансовый отчёт	get_sales_report
Остальные методы Wildberries	request с разрешённой категорией API

Инструмент проверяет категорию токена до вызова. Если нужного права нет, агент получает wildberries_scope_missing и должен назвать конкретную недостающую категорию.

Практические сценарии

Найти причину падения продаж

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

Контролировать остатки

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

Разобрать отзывы и вопросы

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

Проверить юнит-экономику

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

Изменения в кабинете

update_order_status, reply_feedback и любой изменяющий вызов через request требуют предварительного показа результата и явного согласия пользователя. Только после согласия агент повторяет вызов с params.confirm=true.

Универсальное действие request предназначено для методов, которых нет в коротком списке. Используйте его осторожно: у методов записи разные схемы, а обновление карточки товара в API Wildberries может заменять объект целиком. Перед записью прочитайте текущее состояние, сохраните все обязательные поля и перечитайте объект после вызова.

Ограничения и безопасность

• Права токена разделены по категориям. Не выдавайте доступ «на всякий случай».
• Отчёт реализации следует запрашивать не чаще одного раза в минуту. Длинные периоды делите на интервалы и учитывайте ответ 429.
• Некоторые методы Wildberries могут вернуть формально успешный ответ, даже если из-за опечатки ничего не изменилось. После записи обязательно перечитайте объект.
• Выгрузки имеют ограничения по размеру и пагинации; потолок страницы не означает, что записей больше нет.
• Ответы на отзывы и смена статуса заказа видны реальным покупателям. Проверяйте ID, текст и новое состояние до подтверждения.
• Не передавайте токен в чат, файлы проекта или параметры request: сервер подставляет его самостоятельно.

Если не работает

Симптом	Что делать
wildberries_not_connected	Подключить кабинет владельцем рабочего пространства
wildberries_scope_missing	Создать токен с названной категорией или расширить права текущего токена
401 или сообщение об истёкшем токене	Проверить срок действия и переподключить новый токен
429	Не повторять запрос циклом; выдержать паузу и уменьшить период или размер страницы
Запись «успешна», но данных нет	Перечитать объект и проверить ID, поля и категорию метода
В отчёте не все строки	Продолжить пагинацию или разбить период на меньшие интервалы

Связанные материалы

• Настройки рабочего пространства
• Файлы
• Как получать лучший результат

Готовый промпт

Через promto_wildberries проанализируй продажи за последние 14 дней по артикулам <СПИСОК>. Сначала проверь доступные данные, затем сравни заказы, остатки, цены, акции и отзывы. Ничего в кабинете не меняй. Если для запроса не хватает категории токена, назови её. Покажи исходные периоды и отдельно перечисли выводы и рекомендуемые действия.