Чаты Wildberries через API: как не пропустить сообщения между опросами
Как построить приём сообщений чатов WB API: курсор next, сохранение chatID, очередь ответа, отдельные права токена и проверка восстановления после паузы.
Содержание статьи
Надёжный приём сообщений требует сохранённой точки продолжения. После паузы интеграция должна восстановить последовательность событий, связать их с диалогами и не создать повторные задания на ответ.
Документация проверена редакцией 11 октября 2026 года. Материал посвящён существующему интерфейсу чатов, а не новой рассылке покупателям.
Разделите чат и вопросы о товаре
Чат всегда начинает покупатель. Для работы с ним используется отдельная категория токена, отличная от вопросов и отзывов. Успешная интеграция ответов на вопросы ещё не подтверждает, что приложение получит сообщения личного диалога.
Редакционная рекомендация — описать эти потоки отдельно в настройках поддержки. Для каждого определить ответственного, источник события и допустимое действие. Не превращайте наличие технического метода отправки в сценарий произвольного первого обращения: он должен соответствовать механике диалога площадки.
Сохраняйте состояние после обработки
Первый запрос событий выполняют без next; далее передают next из ответа, пока totalEvents не станет нулём. Сохраняют chatID. Курсор — отметка в миллисекундах, а не в секундах.
Практический порядок для разработчика: получить порцию, надёжно записать сообщения, затем зафиксировать точку продолжения. Это редакционная рекомендация по устойчивости интеграции. Если курсор сохранить раньше самих данных, авария между двумя действиями способна оставить необработанный промежуток. Повторное получение уже принятого события, напротив, не должно создавать второй ответ покупателю.
Различайте получение и ответ
Прочитанное сообщение и отправленный ответ следует отражать разными состояниями внутренней очереди. Не закрывайте задачу только потому, что сотрудник открыл диалог: это не подтверждает решение вопроса покупателя.
Перед ответом сотрудник должен видеть нужный диалог, а не только последнюю строку уведомления. Если запрос завершился неопределённо, не запускайте безусловную повторную отправку. Сначала выясните результат операции; общий подход к таким случаям разбирается в материале об ошибках HTTP и повторных запросах.
Проверьте восстановление после паузы
Редакционный приёмочный сценарий включает несколько сообщений, остановку обработчика и повторный запуск с сохранённым курсором. Сверьте последовательность и количество событий, отсутствие повторных задач и правильную привязку к диалогу. Тест должен подтверждать обработку данных, а не только успешный статус запроса.
Отдельно проверьте ошибку прав доступа и неподдерживаемое вложение, не используя реальные личные сведения в тестовых журналах. Лимиты запросов смотрите для конкретного типа токена. Перенос значения из чужого примера без проверки контракта метода WB API может сделать исправную по смыслу очередь нестабильной.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы