Подключение Wildberries

EasyChat собирает обращения Wildberries в общую очередь операторов. Личные чаты, вопросы о товарах, отзывы и возвраты остаются разными рабочими потоками: для каждого показываются только разрешенные площадкой действия.

Что подготовить

• Действующий кабинет продавца Wildberries.
• Персональный API-токен с категориями Чат с покупателями и Вопросы и отзывы.
• Категория Возвраты, если вы хотите обрабатывать заявки на возврат.
• Работающий основной cron EasyChat.
• HTTPS на сайте с EasyChat.

Персональный токен — правильный вариант для EasyChat: система установлена на вашем сервере и работает с данными вашего магазина. Базовый токен тоже можно подключить, но WB разрешает ему проверять чат значительно реже, поэтому новые сообщения могут появляться с большой задержкой.

Как создать Персональный токен

1. Войдите в кабинет WB Партнёры.
2. Нажмите название организации в правом верхнем углу.
3. Откройте Интеграции по API.
4. Нажмите + Создать токен.
5. Выберите вкладку Для интеграции вручную.
6. Выберите Персональный токен.
7. Назовите его, например EasyChat на сервере магазина.
8. Включите категории Чат с покупателями и Вопросы и отзывы. Добавьте Возвраты, если этот раздел нужен операторам.
9. Выберите Чтение и запись: без него EasyChat сможет показать обращения, но не сможет отправлять ответы и решения.
10. Подтвердите предупреждение WB, создайте токен и сразу скопируйте его.

WB показывает значение только один раз. Храните токен в менеджере паролей, не отправляйте его в переписке и не добавляйте на скриншоты. Категории после создания изменить нельзя: если права выбраны неправильно, создайте новый токен.

Официальные материалы WB:

• как создать, обновить или удалить токен;
• чем отличаются типы токенов;
• лимиты запросов WB API.

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

1. Откройте EasyChat → Интеграции.
2. В общем ряду каналов выберите вкладку Wildberries. Вы останетесь на странице интеграций и увидите только кабинеты WB.
3. Вставьте API-токен. EasyChat сразу и только на вашем сервере покажет его тип, срок действия и доступные категории.
4. Нажмите Проверить и подключить.
5. Оставьте включенными только нужные потоки обращений.

EasyChat сначала проверяет ключ, затем сохраняет его зашифрованным на сервере магазина. Если у токена нет отдельного права, соответствующий переключатель будет недоступен с понятной подписью Нет прав у ключа.

Локальная подсказка по типу токена не заменяет проверку WB: подлинность, актуальный срок и фактические права EasyChat всегда подтверждает через официальный API площадки.

Чтобы подключить еще один кабинет Wildberries, используйте ту же форму сверху. Подключение и переключатели сохраняются сразу, отдельная общая кнопка Сохранить интеграции на этой вкладке не требуется. Сводка канала, безопасное подключение и список кабинетов расположены сверху вниз в одном порядке, поэтому нужный статус и следующий шаг видны без перехода на дополнительные страницы.

Что появится в диалогах

• Чаты покупателей позволяют отвечать текстом и поддерживаемыми файлами.
• Вопросы о товарах можно отметить просмотренными, ответить или отклонить.
• Отзывы можно обработать и, когда API разрешает, отправить или изменить ответ.
• Возвраты показывают только действия, доступные для текущей заявки.

Артикул, название и доступные данные товара сохраняются рядом с обращением. Оператор видит площадку и тип потока в web-панели и Android-приложении. Buyer Chat иногда передаёт только артикул. В этом случае EasyChat использует название, уже полученное из вопроса или отзыва о том же товаре в этом же подключённом кабинете. Если название ещё неизвестно, показывается нейтральная подпись «Товар Wildberries» и артикул — обращение не будет ошибочно подписано как объявление другой площадки. Данные разных кабинетов не смешиваются. Если на вопрос или отзыв уже отвечали в кабинете WB, EasyChat показывает рядом и сам ответ продавца. Изменённый в WB ответ обновляется в том же диалоге без дубликатов.

Вложения

Wildberries принимает JPEG, PNG и PDF. EasyChat проверяет реальный MIME, размер и суммарный лимит до отправки. Площадка может принять файл на модерацию не сразу: в этом случае EasyChat безопасно повторит проверку, не дублируя сообщение.

Как идёт синхронизация

Wildberries не отправляет обычный webhook для Buyers Chat, поэтому EasyChat забирает события фоновым polling через основную очередь cron. Первый импорт проходит тихо: старые сообщения не вызывают AI-ответы и лишние push оператору. Чаты, вопросы, отзывы и ответы обрабатываются раньше фоновой повторной проверки ещё не готовых вложений, поэтому медленная модерация файла не задерживает текстовую переписку. EasyChat отдельно сверяет новые и уже обработанные вопросы и отзывы, поэтому не теряет ответы, которые появились после самого обращения. После обновления со старой версии выполняется одна такая же тихая сверка доступной истории. Дата в диалоге остаётся датой сообщения на WB, а не временем его загрузки в EasyChat. Поэтому старая история не выдаётся за новые обращения и не поднимается наверх списка.

Ответ, отправленный из EasyChat, остаётся в истории одним сообщением. Когда Wildberries возвращает подтверждение доставки через историю Buyer Chat, EasyChat связывает его с исходным пузырём оператора или ИИ и не показывает рядом повтор «Оператор Wildberries». После обновления тихая сверка так же убирает подтверждённые старые дубли, не сравнивая тексты сообщений.

Когда оператор отвечает на вопрос или отзыв из EasyChat, подтверждённый WB ответ сразу появляется в диалоге. Если локальное сохранение было временно недоступно, следующая сверка восстановит его без повторной отправки покупателю.

Частота выбирается автоматически по типу токена и общему лимиту кабинета:

• с Персональным токеном чат обычно проверяется каждым запуском минутного cron, а вопросы, отзывы и возвраты — в безопасном регулярном ритме;
• с Базовым токеном EasyChat соблюдает сниженные лимиты WB: чат проверяется примерно раз в час, а вопросы и отзывы делят общий лимит и приходят реже;
• ответ WB 429 и указанное площадкой время ожидания всегда имеют приоритет: EasyChat не создаёт лавину повторов.

Четыре раздела одного кабинета не являются четырьмя магазинами. Это четыре независимых рабочих потока одного кабинета: чат, вопросы, отзывы и возвраты. Если подключено три кабинета, в очереди будет до двенадцати потоков, но общий лимит каждого кабинета координируется автоматически.

Покупатель должен первым начать личный чат в Wildberries. Продавец не может открыть произвольный новый чат через API.

Проверить в обе стороны

1. Напишите продавцу из приложения Wildberries как покупатель.
2. Дождитесь диалога с меткой Wildberries в EasyChat.
3. Проверьте карточку товара и тип обращения.
4. Ответьте из web-панели.
5. Повторите ответ из Android-приложения.
6. Отправьте допустимое изображение или PDF в обе стороны.

Для вопроса, отзыва или возврата дополнительно проверьте специальное действие. EasyChat просит подтверждение перед необратимой операцией и защищает повторный клик одним идентификатором запроса.

Частые ситуации

• Ключ не подключается. Проверьте срок действия, категории токена и право чтения/записи.
• Поток серый. У ключа нет соответствующей категории Wildberries.
• Сообщения приходят с задержкой. Проверьте основной cron и время последней сверки в карточке кабинета. Если указано Базовый токен, замените его на Персональный по инструкции выше.
• EasyChat распознал Базовый токен. Интеграция не сломана: она работает в безопасном редком режиме, чтобы WB не заблокировал запросы. Для нормальной частоты создайте Персональный токен.
• Токен «только чтение». Создайте новый с уровнем Чтение и запись.
• Файл пока не появился. Он может находиться на модерации Wildberries; EasyChat повторит получение автоматически.
• После действия показана неопределённая доставка. Не повторяйте решение вручную: EasyChat сначала сверит обращение с Wildberries и только затем безопасно разрешит новое действие.
• После подключения пришла старая история. Это начальная тихая синхронизация, она не должна создавать автоответы.
• После обновления появились прежние ответы WB. EasyChat восстановил ранее недоступную часть переписки. Эти сообщения не становятся непрочитанными и не запускают автоответ.

Мини-чеклист

• Создан Персональный токен с минимально нужными категориями.
• Кабинет показывает статус Подключен.
• Основной cron выполняется регулярно.
• Входящее обращение появилось с правильным типом.
• Ответ и допустимый файл доставлены покупателю.
• Android показывает тот же диалог и карточку товара.