Подключение магазина
Как выпустить API-токен Wildberries, какие категории доступа отметить и что делать, когда токен перестал работать. Только начинаете — сначала первичная настройка кабинета.
Как создать токен WB
- В кабинете WB Партнёры откройте Профиль → Настройки → Доступ к API (в новых версиях кабинета пункт называется «Интеграции по API»).
- Нажмите «Создать новый токен» и дайте ему имя, например «ProMotionAI».
- Отметьте категории доступа — список ниже.
- Галочку «Тестовый контур» не ставьте.
- Нажмите «Создать» и сразу скопируйте токен: WB показывает его один раз.
- Вставьте токен в сервисе: профиль внизу бокового меню → «Магазины» → «+ Подключить магазин».
Какие категории доступа нужны
Названия — как в кабинете WB при выпуске токена.
| Категория | Зачем сервису | Без неё не работает |
|---|---|---|
| Статистика | заказы, выкупы, остатки | РНП, Финансы, AI-ассистент, Юнит |
| Аналитика | воронка продаж, остатки по складам, платное хранение, поисковые запросы | РНП, Воронка, СЕО, Логистика |
| Финансы | отчёт о реализации | Финансы, План |
| Продвижение | рекламные кампании и их статистика, ДРР | Реклама, AI-ассистент, РНП (ДРР) |
| Контент | список карточек и их характеристики | карточки в любом разделе; по этой категории проверяется, что токен живой |
| Цены и скидки | текущие цены и скидки | Юнит-экономика |
| Маркетплейс | сборочные задания FBS | FBS |
| Поставки | поставки FBW, лимиты приёмки | Поставки и логистика |
Проще всего отметить все восемь сразу. Если какую-то категорию не включить, соответствующий раздел покажет предупреждение с перечнем недостающих, а остальное продолжит работать. Категории «Вопросы и отзывы», «Чат с покупателями», «Документы», «Возвраты» сервису не нужны.
Токен «Только на чтение» подойдёт?
Да, и мы рекомендуем выпускать именно такой: все разделы аналитики работают в режиме чтения. Токен с правом записи понадобится только для автопилота рекламных ставок, когда он появится, — об этом будет сказано отдельно при включении.
Сколько живёт токен
Токен WB действует 180 дней с момента выпуска, продлить его нельзя — только выпустить новый. За несколько дней до истечения выпустите новый токен и вставьте его в карточке магазина кнопкой «Заменить токен». Если токен уже истёк, сервис покажет баннер «Ключ WB недействителен или истёк» и остановит обновления до замены. Накопленные данные при этом никуда не пропадают.
Как понять, что с токеном что-то не так
- В карточке магазина (профиль → «Магазины») есть кнопка «Проверить»: сервис делает пробный запрос и показывает «Токен в порядке ✓» или текст ошибки.
- Если токен истёк или отозван, наверху появится баннер с кнопкой «Обновить ключ».
- Если не хватает категории, баннер перечислит, каких именно, а раздел, которому они нужны, подскажет то же самое.
Безопасно ли давать токен
- Токен хранится в зашифрованном виде (симметричное шифрование, ключ шифрования лежит вне базы данных). В интерфейсе и в ответах сервиса токен никогда не показывается целиком.
- Токен даёт доступ только к тем категориям, которые вы отметили. С токеном «Только на чтение» ни одна программа не сможет ничего изменить в кабинете.
- Отозвать токен можно в любой момент в кабинете WB — сервис сразу потеряет доступ.
- Удалить магазин из сервиса можно кнопкой «Удалить» в карточке магазина: обновления остановятся, а уже скачанные данные останутся в вашем аккаунте.
Можно подключить несколько магазинов
Да, сколько угодно. Переключение магазина — в боковом меню сервиса. Каждому магазину нужен свой токен, лимит ручных обновлений тоже считается на магазин.