Автоответы на отзывы WB через API: токен, запросы и ошибки

Когда у магазина на Wildberries появляется 30-50 отзывов в день, отвечать на них вручную становится отдельной работой. У WB для этого есть открытый API отзывов: можно забирать новые отзывы и публиковать ответы из своей программы. Ниже – как это устроено, какие запросы нужны и где такой конвейер обычно ломается. Всё описанное мы проверили на своём сервисе, который отвечает на отзывы продавцов.

Какой токен нужен

Токен создаётся в личном кабинете продавца: Профиль → Интеграции по API → Создать токен. Для своей программы подходит персональный токен.

• Категории доступа – «Вопросы и отзывы». Если ответ должен учитывать данные карточки товара, добавьте «Контент».
• Уровень доступа – «Чтение и запись»: чтение нужно, чтобы забирать отзывы, запись – чтобы публиковать ответы.

Токен – это JWT. Срок действия зашит в нём самом, в поле exp, и обычно составляет около 180 дней. Мы советуем читать exp при сохранении токена и напоминать владельцу кабинета о замене за неделю: когда срок выходит, все запросы начинают получать 401, и ответы молча перестают публиковаться.

Как забрать новые отзывы

Список отзывов отдаёт GET /api/v1/feedbacks на хосте feedbacks-api.wildberries.ru. Токен передаётся в заголовке Authorization как есть, без слова Bearer.

curl -G "https://feedbacks-api.wildberries.ru/api/v1/feedbacks" \
  -H "Authorization: $WB_TOKEN" \
  --data-urlencode "isAnswered=false" \
  --data-urlencode "take=40" \
  --data-urlencode "skip=0" \
  --data-urlencode "order=dateDesc"

• isAnswered=false – только отзывы без ответа продавца.
• take и skip – постраничная выдача. Для регулярного опроса хватает одной страницы свежих отзывов; полный обход нужен только при первом подключении.
• order=dateDesc – новые отзывы первыми.

Отзывы лежат в data.feedbacks. Для ответа понадобятся поля id, text, productValuation (оценка от 1 до 5), createdDate и productDetails – данные о товаре. Старые отзывы, которые уже ушли из основного списка, отдаёт отдельный адрес /api/v1/feedbacks/archive с теми же take, skip и order.

Как опубликовать ответ

Ответ публикуется запросом POST /api/v1/feedbacks/answer с телом из двух полей:

curl -X POST "https://feedbacks-api.wildberries.ru/api/v1/feedbacks/answer" \
  -H "Authorization: $WB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "ID_ОТЗЫВА", "text": "Спасибо за отзыв! Рады, что размер подошёл."}'

После публикации отзыв перестаёт попадать в выдачу с isAnswered=false. Но опираться только на это не стоит – об этом ниже.

Как устроить конвейер

Источник: схема автора

Удобно мыслить проходом по кругу, который запускается раз в несколько минут:

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

Запросы к API одного кабинета лучше выстраивать в очередь, а не отправлять параллельно: так проще не упереться в ограничения площадки по частоте запросов.

Где конвейер ломается

Источник: схема автора

1. 401 – истёк токен. Самая частая причина, почему «всё работало и перестало». Повторять запрос бессмысленно: нужно остановить кабинет и попросить владельца выпустить новый токен. Лучше – предупредить заранее по полю exp.
2. 429 – слишком частые запросы. Нужна пауза перед повтором и очередь запросов на кабинет. Мгновенный повтор только продлевает ограничение. Актуальные лимиты публикует сам WB в документации для разработчиков.
3. 5xx и обрывы сети. Повторяйте с нарастающей паузой, но ограниченное число раз. 401 и 403 при этом не повторяйте: это не временная ошибка.
4. Двойной ответ. Если ответ опубликован, а запись в вашу базу не прошла, следующий проход снова увидит отзыв и попробует ответить ещё раз. Поэтому id отвеченных отзывов храните у себя и проверяйте перед публикацией.
5. Нейросеть выдумывает. Без данных о товаре она обещает свойства, которых нет, или извиняется за то, чего не было. Лечится инструкцией с описанием товара, стоп-листом и ручной проверкой негатива первые недели.

Что в итоге

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

Если писать свой конвейер не хочется, всё это уже собрано в Астре: подключение кабинета занимает пару минут, а бесплатного тарифа хватает на сотню-другую ответов в месяц. Как подключить кабинет и настроить ответы – на странице автоответов на отзывы Wildberries.

Изображение на обложке: автор статьи