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