Главная · Блог · Ключ API Wildberries: какие права выдать и куда вставить его в ЧБТ
Ключ API Wildberries: какие права выдать и куда вставить его в ЧБТ
Ключ API Wildberries выпускается за минуту, а потом неделю выясняется, почему не приходят отзывы или пустой каталог. Почти всегда причина одна: ключу не выдали нужную категорию доступа. Разбираем, какие категории нужны каждому разделу ЧБТ, какой тип ключа вы получили и что это значит для частоты данных, куда вставить ключ и как читать пометки на карточке подключения — от «Работает» до «нет прав у ключа».
Где выпускается ключ
Ключ выпускает сам продавец в кабинете продавца Wildberries: «Настройки» → «Доступ к API». При выпуске отмечаются категории доступа — именно они решают, какие данные ЧБТ сможет читать.
Подключать магазин в ЧБТ могут владелец и администратор проекта. Оператор видит товары и заказы так же, как они, но подключать и отключать магазины не может.
Ключ вы не передаёте нам в переписке и не отправляете в поддержку — только вставляете в форму подключения. Там он хранится в зашифрованном виде и повторно не показывается никому, включая вас.
Какие категории нужны каждому разделу
| Раздел в ЧБТ | Категория ключа | Что даёт |
|---|---|---|
| Каталог | «Контент» | Карточки товаров: варианты, фото, характеристики |
| Цены и остатки | «Цены и скидки» | Цена с вашей скидкой продавца |
| Заказы | «Статистика» | Новые заказы без отмен — в счётчик, письмо и уведомления |
| Отзывы и вопросы | «Вопросы и отзывы» | Отзывы и вопросы без ответа — в счётчик и письмо |
| Заказы WB (сборка FBS) | «Маркетплейс» | Сборочные задания FBS, поставки и стикеры |
| Отчёты и атрибуция | «Аналитика» | Раздел пока не проверен на живых ключах |
Минимальный набор для бота, который продаёт по вашим карточкам и сообщает о заказах и отзывах: «Контент», «Цены и скидки», «Статистика», «Вопросы и отзывы». Если вы собираете заказы FBS через страницу «Заказы WB», добавьте «Маркетплейс».
Подсказка в форме и полный список
В форме подключения Wildberries под полем «API-токен продавца» стоит короткая подсказка: «Токен: кабинет WB → Настройки → Доступ к API. Нужны категории „Контент“, „Цены и скидки“, „Статистика“». Это минимум для каталога и заказов. Для отзывов и вопросов нужна ещё категория «Вопросы и отзывы» — без неё счётчик отзывов останется пустым, а карточка после первого опроса покажет «нет прав у ключа».
Лучше выпустить ключ сразу со всеми категориями, которые вам понадобятся: перевыпуск означает новый ключ и повторную вставку. Лишняя категория ничего не ломает — ЧБТ использует только то, что ему нужно для разделов.
Про «Маркетплейс» есть нюанс. Если ключу не хватает прав на цены, подсказка кабинета назовёт и эту категорию. Остатки с ваших складов ЧБТ для каталога пока не запрашивает, так что без неё в каталоге ничего не пропадёт. Но страница «Заказы WB» без неё не работает: она прямо пишет, что у ключа нет категории «Маркетплейс».
Тип ключа и почему данные приходят с задержкой
После подключения на карточке появляется строка «Тип ключа:» — ЧБТ определяет его по самому ключу: Базовый, Тестовый, Персональный или Сервисный. Если тип распознать не удалось, кабинет пишет «Тип ключа не распознан» и держится лимитов Базового: ошибиться в сторону «спрашивать реже» безопасно.
У Базового ключа Wildberries ставит строгие лимиты, и ЧБТ их соблюдает:
| Данные | Базовый ключ |
|---|---|
| Заказы («Статистика») | 1 запрос в 3 часа |
| Отзывы и вопросы | 5 запросов в час на обе части |
| Карточки («Контент») | 1 запрос в час, 100 карточек |
| Цены и скидки | 4 запроса в час |
Поэтому новый заказ с Базовым ключом может появиться в ЧБТ через несколько часов, а большой каталог загружается больше суток. У других типов кабинет пишет «У этого типа ключа лимиты Wildberries высокие — данные приходят с каждым опросом».
Не выпускайте Персональный ключ ради лимитов
Соблазн понятный: у Персонального ключа лимиты выше. Но по правилам Wildberries Персональный ключ предназначен для собственных систем продавца, а использовать его в облачных сервисах запрещено. Поэтому ЧБТ не советует его выпускать и не предлагает такую замену в кабинете.
Если вам критична скорость заказов, опирайтесь не на частоту опроса, а на сборку FBS: страница «Заказы WB» работает по категории «Маркетплейс», у которой у Базового ключа свой, более мягкий лимит.
И ещё одно правило площадки, которое стоит знать: лимит считается на продавца, а не на ключ. Два ключа одного магазина делят один счёт — выпуск второго Базового ключа для другого сервиса не даст ЧБТ больше запросов, а наоборот, может отнять их.
Куда вставить ключ в ЧБТ
- Откройте бота → «Маркетплейсы».
- Нажмите «Подключить площадку» и выберите Wildberries.
- Вставьте ключ в поле «API-токен продавца». Если магазинов Wildberries несколько, задайте название, чтобы различать их в списке и в сценариях.
- Нажмите «Подключить». ЧБТ сразу проверит, что ключ живой, и сохранит его в зашифрованном виде.
Проверка при подключении — лёгкая: ЧБТ спрашивает площадку, принимает ли она ключ, и не тратит на это ваши лимиты. Если ключ не Базовый, ЧБТ тут же проверяет и права: карточки, цены, отзывы и вопросы. У Базового ключа такая проба стоила бы часового лимита карточек, поэтому его права выясняет первый настоящий опрос — в ближайшие минуты после подключения.
Как читать пометки на карточке
В блоке «Подробнее: что умеет это подключение» у каждого раздела стоит состояние:
- Работает — раздел отвечает. У заказов, отзывов и вопросов это значение стоит сразу после подключения — это значение по умолчанию, а не ответ площадки; приходят ли данные на самом деле, видно по счётчикам последней проверки.
- не проверено на вашем ключе — ЧБТ ещё не убедился, что раздел работает именно у вас. У каталога и цен так до первой загрузки. Это не отказ и не ошибка.
- нет прав у ключа — площадка отказала по правам: категории не хватает.
- площадка не отдаёт — такого раздела у площадки нет. У Wildberries так помечены чаты: переписки с покупателями площадка не даёт.
Если ключу не хватает прав
Когда раздел получил «нет прав у ключа», карточка показывает «Ключу не хватает прав:» и называет «Нужны категории доступа» — с ссылкой на страницу доступа к API в кабинете продавца. Порядок действий:
- Выпустите в кабинете Wildberries новый ключ, отметив недостающие категории вместе с прежними.
- В карточке подключения нажмите «Заменить ключ» и вставьте новый. Ключ заменится, а данные останутся: счётчики, история событий и каталог.
- Нажмите «Проверить сейчас», чтобы не ждать следующего опроса.
Важная тонкость: «нет прав у ключа» ЧБТ ставит, только если в том же опросе ответил хотя бы один другой раздел. Если отказали все разделы, значит, проблема в самом ключе, а не в категориях.
Если площадка отклонила ключ
Когда все разделы получили отказ, кабинет пишет «Площадка отклонила ключ (401/403). Проверьте ключ и права доступа в кабинете продавца», а владельцу приходит письмо «обновите ключ» — не чаще раза в сутки, чтобы не засыпать почту.
Частые причины: ключ отозвали в кабинете Wildberries, скопировали не полностью или вставили ключ другого магазина. Решение одно — выпустить новый ключ и вставить его через «Заменить ключ». Отключать и подключать магазин заново не нужно: при отключении ключи удаляются, и это лишний шаг.
Если ключ исправен, а площадка попросила подождать из-за лимита, на карточке будет «Площадка попросила паузу» — это не отказ ключа. ЧБТ сам повторит запрос, когда площадка разрешит.
Чек-лист перед тем, как вставить ключ
- Ключ выпущен в кабинете того магазина, который вы подключаете, а не соседнего.
- Отмечены «Контент», «Цены и скидки», «Статистика» и «Вопросы и отзывы»; для сборки FBS — ещё «Маркетплейс».
- Ключ скопирован целиком, без пробелов и переносов по краям.
- Если магазинов Wildberries несколько, у каждого свой ключ и понятное название в ЧБТ, а основной отмечен кнопкой «Сделать основным».
- Для этого магазина не выпущены лишние Базовые ключи в других сервисах, которые съедают общий лимит продавца.
- В настройках аккаунта включены «Email-уведомления», чтобы получать письмо-сводку и письмо о проблеме с ключом.
После подключения подождите первый опрос — он пройдёт автоматически в ближайшие минуты — и откройте «Подробнее: что умеет это подключение». Если всё отмечено правильно, заказы, отзывы и вопросы появятся в счётчиках, а каталог начнёт загружаться страницами.
Безопасность ключа
- Хранение. Ключ хранится в зашифрованном виде и не показывается повторно — ни в кабинете, ни поддержке.
- Отключение. «Отключить» удаляет ключи, но не удаляет товары: каталог остаётся в кабинете и с публикации не снимается.
- Кто видит. Подключать и отключать магазины могут только владелец и администратор проекта.
- Отзыв. Если ключ мог утечь, отзовите его в кабинете Wildberries — ЧБТ перестанет получать данные, и вы вставите новый через «Заменить ключ».
Что ЧБТ делает с ключом: читает каталог, цены, заказы, отзывы и вопросы, а на странице «Заказы WB» работает со сборочными заданиями FBS по вашей команде. На отзывы и вопросы ЧБТ не отвечает.
Бот для WildberriesОтзывы без ответа на WBУведомления о заказах WBПодключить Ozon к боту