Перейти к содержимому
OmniChannels.ai
Меню

WhatsApp Business API

Каковы ограничения на размер медиафайлов в WhatsApp API?

Обновлено

Краткий ответ

По документации Meta, на момент написания максимальные размеры медиа в WhatsApp Cloud API такие: изображения 5 МБ (JPEG, PNG, статичный WebP), видео 16 МБ (MP4 или 3GPP с H.264 и AAC), аудио 16 МБ, документы 100 МБ, анимированные стикеры 500 КБ и статичные 100 КБ. Загружайте файл и отправляйте его media ID, а не ссылку, и следите, чтобы MIME-тип соответствовал файлу.

Лимиты размера по типам медиа

Предельный размер любого медиа в Cloud API — 100 МБ. Файл может уложиться в лимит размера и всё равно быть отклонён из-за формата, например видео не в H.264 с аудио AAC или изображение не в 8-битном RGB или RGBA.

Тип медиаМаксимальный размерПримечания
Изображение5 МБТолько 8-битный RGB или RGBA
Видео16 МБВидео H.264, аудио AAC
Аудио16 МБAAC, AMR, MP3, M4A, OGG с кодеком Opus
Документ100 МБФайлы Office, PDF и текстовые файлы
Стикер (анимированный)500 КБТолько WebP
Стикер (статичный)100 КБТолько WebP

Загрузка или ссылка и срок жизни ID

Meta рекомендует для лучшей производительности загружать файл и отправлять его media ID. ID, полученные при загрузке, действуют 30 дней, а ID из входящих вебхуков — 7 дней, поэтому скачивайте файлы клиентов сразу. URL для скачивания истекает через 5 минут.

Подписи к изображениям, видео и документам могут быть до 1 024 символов. У аудио и стикеров подписей нет.

Частые ошибки

  • Ориентироваться только на размер и не учитывать кодек или цветовой формат.
  • Отдавать файл с MIME-типом, который ему не соответствует, — частая причина ошибки 131053.
  • Использовать media ID старше 30 дней.
  • Отправлять анимированный WebP как изображение: он будет отклонён.

Официальные источники