API
ДокументацияОшибки и поддержка

Файл не загружается или недоступен

Что проверить при загрузке, отправке или открытии медиафайла.

WAIX API · Обновлено 22 сентября 2026

Не загружается

  1. Используйте multipart/form-data: файл в поле file, UUID в connection_id.
  2. Проверьте размер до 32 MiB и ограничения конкретного типа.
  3. Убедитесь, что MIME соответствует реальному содержимому. Переименование расширения не конвертирует файл.
  4. Проверьте право media:write и рабочее подключение.

Загрузился, но не отправляется

В media.id передавайте provider_media_id, а не UUID объекта WAIX. Не указывайте одновременно id и link. Для внешней ссылки проверьте доступность без cookies/пароля, HTTPS и отсутствие секретных параметров. Медиа также подчиняется окну ответа.

Ссылка перестала работать

У ссылки ограниченный срок действия. Получите новую через GET /media/{id}/url. Если файл удалён или не перешёл в статус ready, загрузите его заново. В CRM сохраняйте ID файла и получайте свежую ссылку при открытии.

Остался вопрос по этой инструкции?Написать в поддержку →