Перейти к основному содержимому

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

СМИ

Обновлено: 11 декабря 2025 г
Для управления медиафайлами вы используете 4 различных точки доступа:
Конечная точка Применение
Загрузите медиафайлы.
Получите URL-адрес для конкретного медиафайла.
Удалите определенный медиафайл.
Загружайте медиафайлы по URL-адресу.
См. раздел «Поддерживаемые типы носителей» для получения информации о поддерживаемых типах и ограничениях по размеру.

Получить идентификатор медиафайла

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

Загрузить СМИ

Для загрузки медиафайлов выполните следующие действия: ПОЧТА призыв к /НОМЕР_ТЕЛЕФОНА_ID/media и включают параметры, перечисленные ниже. Все медиафайлы, отправляемые через эту конечную точку, шифруются и сохраняются в течение 30 дней, если не будут удалены раньше.
Конечная точка Аутентификация
/НОМЕР_ТЕЛЕФОНА_ID/media
Разработчики могут аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в Панель управления приложения > WhatsApp > Настройка API.
Партнеры по решениям должны пройти аутентификацию с помощью токена доступа whatsapp_business_messaging разрешение.

Параметры

Имя Описание
файл
Необходимый.
Путь к файлу, хранящемуся в вашей локальной директории. Например: «@/local/path/file.jpg».
тип
Необходимый.
Тип загружаемого медиафайла. См Поддерживаемые типы носителей для получения дополнительной информации.
messaging_product
Необходимый.
Для обработки запроса используется служба обмена сообщениями. В данном случае используйте WhatsApp.

Запрос

curl 'https://graph.facebook.com/<API_VERSION> /<PHONE_NUMBER_ID> /media' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> ' \ -F 'messaging_product=whatsapp' \ -F 'file=@<FILE_PATH_AND_NAME> ;type=<MIME_TYPE> '
Ответ
В случае успеха:
{ "идентификатор": "<MEDIA_ID> " }
Пример запроса
curl 'https://graph.facebook.com/v25.0/106540352242922/media' \ -H 'Авторизация: Bearer EAAJB...' \ -F 'messaging_product=whatsapp' \ -F 'file=@/media/template_assets/black_friday_2025.mp4;type=video/mp4'

Пример ответа
{ "id": "1037543291543636" }
Получить URL медиафайла
Вы можете сделать запрос идентификатор медиа чтобы получить URL-адрес медиафайла, который затем можно запросить напрямую с помощью вашего токена доступа загрузить медиафайлОбратите внимание, что входящие медиасообщения, обрабатываемые веб-перехватчиками (сообщения с изображениями, видеосообщения(и так далее) включают URL-адрес медиафайла, который присваивается url свойство.
URL-адреса медиафайлов истекает через 5 минутПосле этого необходимо снова запросить идентификатор, чтобы получить новый URL-адрес.
Синтаксис запроса
curl 'https://graph.facebook.com/<API_VERSION> /<MEDIA_ID> ?phone_number_id=<BUSINESS_PHONE_NUMBER_ID> ' \ -H 'Авторизация: Предъявитель EAAJB'
Обратите внимание, что номер_телефона_идентификатор Этот параметр необязателен. Если он указан, запрос будет обработан только в том случае, если идентификатор номера телефона компании, указанный в запросе, совпадает с идентификатором номера телефона компании, на который был загружен медиафайл.
Синтаксис ответа
Успешный ответ включает объект с URL-адресом медиафайла. URL-адрес действителен только в течение 5 минут. Чтобы использовать этот URL-адрес, см Скачать медиафайлы.
{ "messaging_product": "whatsapp", "url": "<MEDIA_URL> ", "mime_type": "<MEDIA_MIME_TYPE> ", "sha256": "<SHA_256_HASH> ", "file_size": "<MEDIA_FILE_SIZE> ", "идентификатор": "<MEDIA_ID> " }
Удалить медиафайлы


Используйте кнопку УДАЛИТЬ / Конечная точка для удаления медиафайла.






Запрос
синтаксис
curl -X DELETE 'https://graph.facebook.com/<API_VERSION> /<MEDIA_ID> ?phone_number_id=<BUSINESS_PHONE_NUMBER_ID> ' \ -H 'Авторизация: Предъявитель EAAJB...'
Обратите внимание, что номер_телефона_идентификатор Этот параметр необязателен. Если он указан, запрос будет обработан только в том случае, если идентификатор номера телефона компании, указанный в запросе, совпадает с идентификатором номера телефона компании, на который был загружен медиафайл.
Пример ответа
{ "success": true }
Скачать медиафайл


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


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






Запрос
синтаксис
завиток '<MEDIA_URL> ' \ -H 'Авторизация: Предъявитель EAAJB...' \ -o '<DESIRED_FILE_NAME> '
В случае успеха API отправит в ответ двоичные данные медиафайла. Заголовки ответа содержат заголовок content-type, указывающий MIME-тип возвращаемых данных. Проверьте поддерживаемые типы носителей для поддерживаемых типов носителей.
Если попытка загрузки не удастся, вы получите сообщение 404 Не найдено код ответа. В таком случае попробуйте получить новый URL-адрес медиафайла и загрузите его снова. Если это не решит проблему, обновите свой токен доступа и попробуйте загрузить медиафайл еще раз.
Поддерживаемые типы носителей








Аудио








Тип аудио 

Расширение 

Тип 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-тип:


файл -I ваш-изображение-актив.png








Ограничения на загрузку медиасообщений


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


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


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








Узнать больше



    
        

    


            

        

    


    


    
    

        

             Вернуться наверх