Медиа | Документация для разработчиков

Для управления медиафайлами вы используете 4 различных точки доступа:

См. раздел «Поддерживаемые типы носителей» для получения информации о поддерживаемых типах и ограничениях по размеру.

Для некоторых запросов API, описанных в этом документе, требуется идентификатор медиафайла. Идентификаторы медиафайлов возвращаются API при загрузке медиафайлови включаются во входящие сообщения веб-хуков (сообщения с изображениями, сообщения с видеои т. д.).

Идентификаторы медиафайлов, возвращаемые API, истекают через 30 дней. Идентификаторы медиафайлов в веб-хуках истекают через 7 дней.

Для загрузки медиафайлов выполните GET- запрос к URL-адресу медиафайла и укажите свой токен доступа. Если вы не укажете токен, запрос завершится неудачей.

Обратите внимание, что при получении медиафайла по идентификатору, полученному через веб-перехватчик, этот идентификатор будет доступен для загрузки только в течение 7 дней.

Тип аудио	Расширение	Тип MIME	Максимальный размер
ААК	.aac	аудио/аАК	16 МБ
АМР	.amr	аудио/амр	16 МБ
MP3	.mp3	аудио/мпег	16 МБ
MP4 Аудио	.m4a	аудио/мп4	16 МБ
OGG Audio	.ogg	audio/ogg (только кодеки OPUS; базовый формат audio/ogg не поддерживается; только монофонический вход)	16 МБ

Тип документа	Расширение	Тип MIME	Максимальный размер
Текст	.текст	текст/простой	100 МБ
Microsoft Excel	.xls	application/vnd.ms-excel	100 МБ
Microsoft Excel	.xlsx	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	100 МБ
Microsoft Word	.doc	приложение/msword	100 МБ
Microsoft Word	.docx	application/vnd.openxmlformats-officedocument.wordprocessingml.document	100 МБ
Microsoft PowerPoint	.ppt	application/vnd.ms-powerpoint	100 МБ
Microsoft PowerPoint	.pptx	application/vnd.openxmlformats-officedocument.presentationml.presentation	100 МБ
PDF	.pdf	application/pdf	100 МБ

Изображения должны быть 8-битными, в формате RGB или RGBA.

Тип изображения	Расширение	Тип MIME	Максимальный размер
JPEG	.jpeg	изображение/jpeg	5 МБ
ПНГ	.png	изображение/png	5 МБ

Изображения в формате WebP можно отправлять только в сообщениях-стикерах.

Тип наклейки	Расширение	Тип MIME	Максимальный размер
Анимированная наклейка	.webp	изображение/вебп	500 КБ
Статическая наклейка	.webp	изображение/вебп	100 КБ

Поддерживаются только видеокодек H.264 и аудиокодек AAC. Поддерживается только один аудиопоток или отсутствие аудиопотока.

Обратите внимание, что видео, закодированные с использованием профиля H.264 «High» и B-кадров, не поддерживаются клиентами WhatsApp для Android. Мы рекомендуем использовать профиль H.264 «Main» без B-кадров или профиль H.264 «Baseline» при кодировании (или перекодировании с помощью такого инструмента, как ffmpeg) и размещать блоки moov перед блоками mdat для большей совместимости. Если вы используете ffmpeg, вы можете использовать флаг -movflags в faststart, чтобы разместить блоки moov перед блоками mdata.

Тип видео	Расширение	Тип MIME	Максимальный размер
3GPP	.3gp	видео/3gpp	16 МБ
Видео MP4	.mp4	видео/mp4	16 МБ

Обратите внимание, что несоответствие MIME-типа (131053) — распространённая ошибка. Проверьте ваши медиафайлы, чтобы убедиться в их MIME-типе. Убедитесь, что расширения файлов соответствуют их типам. Например, если вы используете UNIX, вы можете проверить файл через командную строку, чтобы определить его MIME-тип:

Максимально допустимый размер файла для медиасообщений в Cloud API составляет 100 МБ. В случае, если клиент отправит файл размером более 100 МБ, вы получите веб-хук с кодом ошибки 131052 и заголовком:

«Размер медиафайла слишком велик. Максимальный поддерживаемый нами размер файла: 100 МБ. Пожалуйста, свяжитесь с вашим клиентом, чтобы он отправил медиафайл меньшего размера, чем 100 МБ».

При срабатывании этого веб-перехватчика отправьте клиентам предупреждение о том, что их медиафайл превышает максимально допустимый размер.

Блог WhatsApp Business – Отправка медиасообщений WhatsApp изприложения