Вложение из чата Wildberries может временно не скачиваться из-за модерации. Такой ответ отличается от ошибки авторизации или окончательного отказа в выдаче файла. Интеграция поддержки должна сохранять сообщение и состояние вложения отдельно. Документация проверена 14 октября 2026 года.

Как найти нужный файл

Метод /api/v1/seller/download/{id} получает файл или изображение по идентификатору. В путь передают downloadID из события чата. Это не chatID и не ID заказа. Подмена идентификаторов способна сломать загрузку, хотя сами сообщения продолжают поступать.

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

Что означают 202 и 451

Ответ 202 означает, что файл находится на модерации; в примере ответа предусмотрены moderationState и retrySeconds. Ответ 451 означает, что файл модерацию не прошёл. Ожидание проверки и отказ должны отображаться как разные состояния, а не общая надпись «ошибка загрузки».

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

Как не потерять обращение при ожидании

Сохранение текста сообщения не должно зависеть от успешного скачивания всех вложений. Иначе временная модерация фотографии задержит всю очередь поддержки. Отдельная задача загрузки позволит показать сообщение сразу и дополнить его файлом после подтверждения.

Это рекомендация по устройству процесса, а не особый статус WB. Для приёма самих событий используйте сохранение курсора чатов. Повторная обработка события не должна создавать ещё одну задачу скачивания того же вложения.

Что проверить перед вводом в работу

Разберите четыре сценария: доступный файл, ожидающий модерации, отклонённый файл и ошибка доступа. Для каждого у сотрудника должно быть понятное сообщение и дальнейшее действие. Не заменяйте фотографию пустым файлом, чтобы технически закрыть задачу.

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