Как подключить API-токен Wildberries к Snaplit
Snaplit подключается без пароля от кабинета продавца. Для модуля отзывов нужен Персональный токен Wildberries, созданный владельцем магазина.
Коротко: что важно
API-токен Wildberries позволяет Snaplit работать с выбранными разделами кабинета без передачи логина и пароля. Для ответов на отзывы важны тип токена, категории разрешений и возможность записи. Если хотя бы одно условие не выполнено, загрузка или публикация ответов не будет работать.
Интерфейс кабинета WB со временем меняется, поэтому полезно ориентироваться на смысл настроек. Нужен именно Персональный токен владельца магазина и доступ к категориям «Контент» и «Вопросы и отзывы» на чтение и запись. Snaplit проверяет эти свойства при подключении.
Почему разрешения проверяются по категориям
Wildberries разделяет API-доступ по функциональным категориям. Модулю отзывов нужны данные карточек для контекста и доступ к вопросам и отзывам для чтения и публикации. Поэтому наличие токена само по себе ещё не означает, что интеграция сможет выполнить нужное действие.
Snaplit связывает токен с выбранным модулем и проверяет разрешения до начала синхронизации. Это помогает сразу обнаружить токен только для чтения, истёкший ключ или доступ другого кабинета продавца. Ошибка на этапе подключения понятнее, чем молчаливый сбой при отправке ответа.
Типичные причины ошибки подключения
Чаще всего проблема связана с пропущенной категорией, режимом «Только чтение», истёкшим сроком или случайными пробелами при копировании. Проверьте настройки в кабинете WB и создайте новый токен, если назначение старого неясно. Не публикуйте секрет в обращении в поддержку.
Если один seller ID уже связан с другим аккаунтом Snaplit, новое подключение блокируется. Это защищает кабинет от неоднозначной привязки. В такой ситуации нужно восстановить доступ к исходному аккаунту или обратиться в поддержку, указав безопасные идентифицирующие данные без самого API-токена.
Создайте Персональный токен
Откройте раздел API в кабинете продавца Wildberries и создайте Персональный токен. Названия и расположение элементов интерфейса WB могут меняться, поэтому ориентируйтесь на тип токена и категории доступа.
Выберите разрешения
Для автоответов Snaplit нужны категории «Контент» и «Вопросы и отзывы» с доступом на чтение и запись. Токен только для чтения не позволит публиковать ответы.
Введите токен в Snaplit
Добавьте магазин, откройте подключение Wildberries и вставьте токен в плашку модуля отзывов. Сервис проверит тип, срок, seller ID и разрешения до сохранения.
Не храните копию без необходимости
- не пересылайте токен в мессенджерах
- не прикладывайте его к обращениям в поддержку
- при утечке отзовите токен в WB
- после перевыпуска обновите подключение в Snaplit
Применение в сервисе
Проверка токена внутри Snaplit
Форма подключения сразу сопоставляет токен с требованиями модуля отзывов. Если категория отсутствует, включён режим только для чтения или seller ID уже связан с другим аккаунтом, подключение не продолжается. Это помогает устранить проблему до фоновой синхронизации.
После успешной проверки Snaplit ставит загрузку доступных данных в очередь и показывает этап подключения. Если токен позже истечёт или будет отозван, создайте новый с тем же минимальным набором разрешений и обновите его в настройках магазина.
Практический пример
Что происходит после вставки токена
Ситуация
Владелец магазина создал токен, сотрудник вставил его в форму подключения модуля автоответов.
Вариант решения
Snaplit очищает случайные пробелы, проверяет тип и срок токена, seller ID и набор разрешений, затем выполняет контрольный запрос к API. Только после успешной проверки токен сохраняется в зашифрованном виде.
Почему так
Если токен создан только для чтения или без нужной категории, сервис сообщает о несоответствии. Правильнее перевыпустить токен с точным набором разрешений, чем выдавать лишний доступ.
Перед публикацией
Проверьте ответ по чек-листу
- токен создал владелец кабинета WB
- выбран тип «Персональный»
- включены «Контент» и «Вопросы и отзывы»
- разрешены чтение и запись
- токен не передавался через открытый чат
- после подключения копия удалена из небезопасных мест
- при ошибке проверен срок действия
Вопросы по теме
Короткие ответы
Почему токен только для чтения не подходит?
Он может позволить получить отзывы, но не разрешает отправить подготовленный ответ в Wildberries. Для полного сценария модулю нужна запись.
Может ли сотрудник создать токен?
По правилам текущего подключения токен создаёт владелец магазина Wildberries. Сотруднику можно передать его непосредственно для ввода, соблюдая правила безопасности.
Что делать после истечения токена?
Создать новый Персональный токен с теми же необходимыми категориями и обновить подключение в Snaplit. Старый токен больше не даст доступ к API.