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