Сервис берёт данные из WB по токену — это ключ доступа к данным магазина. Токен создаёт владелец магазина в кабинете продавца WB, а вы вставляете его в наш сервис. Это занимает пять минут.
Что понадобится
- Доступ владельца магазина на WB: создавать токены может только владелец профиля.
- Кабинет в нашем сервисе: Профиль → «Кабинеты» → «Создать».
В профиле, во вкладке «Общие», есть список «Первый запуск»: он отмечает пройденные шаги и показывает кнопку для следующего.
Шаг 1. Создайте основной токен
- Откройте кабинет продавца WB, нажмите на профиль и выберите «Интеграции по API».
- Нажмите «Создать токен» и откройте вкладку «Для интеграции вручную».
- Тип токена — «Персональный». Почему не «Базовый» — ниже.
- Название — любое, например «Аналитика».
- Отметьте все категории.
- Уровень доступа — «Только чтение».
- Создайте токен и сразу скопируйте его: WB показывает токен один раз.
Все категории — чтобы новый раздел сервиса заработал сам, без нового токена. «Только чтение» — чтобы через токен нельзя было ничего изменить в магазине.
Шаг 2. Вставьте токен в сервис
- Профиль → «Кабинеты» → кнопка «Токены» у нужного кабинета.
- Вставьте токен в поле «Основной токен» и нажмите «Сохранить токены».
Сервис сразу прочитает токен и покажет его тип, уровень доступа и срок. Если не хватает категорий, он скажет, каких именно и каких данных без них не будет.
Шаг 3. Дождитесь истории
После сохранения сервис загружает историю из WB: каталог, воронку продаж, рекламу и финансовые отчёты. Каталог появляется первым, финансовые отчёты — последними: WB отдаёт их медленнее всего. Пока идёт загрузка, вверху страниц видна строка «Загружаем историю из WB», а в профиле — ход по каждой части.
Для A/Б-тестов — второй токен
A/Б-тест меняет главное фото карточки, а для этого нужно право записи. Основной токен его не даёт, поэтому для тестов нужен отдельный токен:
- тип — «Персональный»;
- одна категория — «Контент»;
- уровень доступа — «Чтение и запись».
Вставьте его в поле «Контент для A/Б-тестов». Если A/Б-тесты не нужны, второй токен не нужен.
Если ваш основной токен уже с уровнем «Чтение и запись», второй тоже не нужен: тесты пойдут через основной. Форма покажет это у поля «Контент для A/Б-тестов».
Почему это безопасно
- Основной токен только читает. Через него нельзя изменить цены, карточки или остатки и нельзя потратить деньги.
- Токен для A/Б-тестов может менять только карточки товаров. Цены, реклама и финансы ему недоступны.
- Токены хранятся зашифрованными. После сохранения их не видно даже в форме.
- Удалите токен в кабинете WB — и доступ сразу прекратится.
Почему персональный, а не базовый
WB советует облачным сервисам базовый токен. Но у базового токена WB сильно урезал лимиты: финансовый отчёт — один-два запроса в сутки вместо одного в минуту, статистика рекламы — один запрос в час, воронка — два в час. На таких лимитах P&L не загрузится, а реклама и воронка будут отставать на часы. Поэтому пока мы просим персональный токен.
При создании персонального токена WB попросит подтвердить, что вы понимаете: токен не следует передавать третьим лицам. Без этой отметки токен не создать.
Токен действует 180 дней
Продлить токен нельзя. За две недели до конца срока над страницами появится строка об этом, а владельцу компании придёт письмо — за 14 и за 3 дня. Если WB перестанет принимать токен, письмо придёт в тот же час. Чтобы заменить токен:
- В кабинете WB у старого токена нажмите «Дублировать» — появится новый с теми же настройками.
- Вставьте его в то же поле у нас. История не пропадёт.
- Старый токен удалите.
Если что-то не так
- «Это не похоже на токен WB» — скопирован не весь токен или с лишними символами. Скопируйте заново.
- «Срок токена закончился» — создайте новый кнопкой «Дублировать».
- «Тестовый токен» — выбран тип «Тестовый». Нужен «Персональный».
- «Не хватает категорий» — создайте новый токен со всеми категориями и вставьте вместо старого.
- «Токены от разных магазинов» — второй токен создан в другом магазине. Все токены кабинета должны быть из одного.
- «WB не принимает токен» вверху страниц — токен удалили или отозвали. WB отзывает все токены, когда владелец меняет номер телефона. Создайте новый токен и вставьте его — строка пропадёт сразу. Сервис проверяет токены раз в час, так что строка может появиться не сразу после удаления токена.