Как добавить API-токен Wildberries и синхронизировать данные с Hub

Подключение кабинета WB

Чтобы Hub мог управлять вашими рекламными кампаниями, ему нужен доступ к вашему магазину на Wildberries через API-токен.

i

В навигации Hub этот раздел называется «Кабинеты WB». В документации также встречается термин «WB-аккаунт» как синоним.

Шаг 1. Получите API-токен в личном кабинете WB

1
Откройте личный кабинет Wildberries.
2
Перейдите в раздел «Доступ к API» (или Настройки → API в зависимости от версии интерфейса WB).
3
Создайте новый токен с необходимыми правами (как минимум — управление рекламой). Создание токена доступно только владельцу кабинета.
4
Скопируйте токен — он отображается только один раз.
!

Не передавайте токен третьим лицам. Если Hub сообщает об ошибке или недействительности токена — создайте новый в личном кабинете WB и обновите его в разделе «Кабинеты WB».

Раздел API в личном кабинете WB Partners
Раздел API в личном кабинете WB Partners

Шаг 2. Добавьте кабинет в Hub

1
В Hub перейдите в раздел «Кабинеты WB» (левое меню).
2
Нажмите «Добавить кабинет» или «Подключить кабинет продавца».
3
В открывшейся форме:
  • В поле «Токен API» вставьте API-токен.
  • В поле «Название кабинета» введите удобное название (например, название магазина).
4
Нажмите «Добавить кабинет».

Hub проверит токен через Wildberries API. Если токен верный — появится сообщение «Кабинет успешно подключён», и кабинет отобразится в списке.

Форма «Добавление кабинета»
Форма «Добавление кабинета»

Шаг 3. Привяжите кабинет к проекту

После добавления кабинета:

  • Если проекты уже есть: Hub предложит выбрать один или несколько проектов для привязки — выберите их и подтвердите.
  • Если это первый кабинет и проектов ещё нет: окно закроется, кабинет сохранится в системе. Следующий шаг — создайте проект и выберите этот кабинет в форме создания проекта.

Шаг 4. Дождитесь первичной синхронизации

После добавления кабинета Hub начинает синхронизировать каталог товаров — все карточки товаров из вашего магазина. Синхронизация может занять несколько минут. После её завершения товары появятся в соответствующем разделе.

i

Кампании не импортируются автоматически. Чтобы начать управлять существующими кампаниями из Wildberries, их нужно импортировать вручную — откройте проект и нажмите кнопку «Импортировать из WB».

Поддержание актуальности данных

Hub автоматически обновляет каталог товаров по расписанию. Данные по кампаниям (статусы, ставки, кластеры) Hub также поддерживает актуальными в фоне. Чтобы начать управлять существующими кампаниями из Wildberries, воспользуйтесь импортом — подробнее: Импорт кампаний из WB.

Изменить название кабинета или обновить токен

Чтобы переименовать кабинет или заменить API-токен:

1
В разделе «Кабинеты WB» нажмите «Настроить» рядом с нужным кабинетом.
2
В открывшемся окне «Настройки кабинета»:
  • Введите новое Название кабинета (если нужно переименовать).
  • В поле Токен API введите действующий токен — поле обязательно для заполнения.
3
Нажмите «Сохранить».
Окно «Настройки кабинета»
Окно «Настройки кабинета»

Удалить кабинет

!

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

1
В разделе «Кабинеты WB» нажмите «Настроить» рядом с нужным кабинетом.
2
В окне «Настройки кабинета» нажмите «Удалить кабинет» (красная кнопка).
3
В диалоге подтверждения нажмите «Удалить».

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

!

До обновления токена кампании этого кабинета не смогут передавать ставки в Wildberries. Обновляйте токен заблаговременно.

Возможные ошибки при подключении

ОшибкаПричинаРешение
«Токен недействителен»Токен введён неверно или уже истёкПроверьте токен в личном кабинете WB, создайте новый
«Нет доступа к API»У токена недостаточно правСоздайте токен с правами на управление рекламой
«Тайм-аут соединения»WB API временно недоступенПовторите попытку через несколько минут