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

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

Видеообращения

Обновлено: 3 ноября 2025 г
В видеосообщениях отображается миниатюрное изображение видео с возможностью добавления подписи. Когда пользователь WhatsApp нажимает на предварительный просмотр, видео загружается и отображается пользователю.

Отправка видеосообщений

Используйте POST / /messages для отправки видеосообщения пользователю WhatsApp.

Синтаксис запроса

POST /< WHATSAPP_BUSINESS_PHONE_NUMBER_ID >/ сообщения

Тело поста

{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "{{wa-user-phone-number}}", "type": "video", "video": { "id" : "<MEDIA_ID> ", /* Только при использовании загруженных медиафайлов */ "ссылка": "<MEDIA_URL> ", /* Только если ссылка на ваши медиафайлы */ "caption": "<VIDEO_CAPTION_TEXT> " } }
Параметры тела после

Заполнитель

Описание

Пример значения

<VIDEO_CAPTION_TEXT>
Нить
Необязательный.
Текст субтитров к видео.
Максимальное количество символов: 1024.
Затмение, полное красок!
<MEDIA_ID>
Нить
Обязательно при использовании загруженных медиафайлов (рекомендуется).
1166846181421424
<MEDIA_URL>
Нить
Обязательно, если вы размещаете ссылку на свой медиафайл (не рекомендуется)
URL-адрес видеофайла на вашем общедоступном сервере. Для повышения производительности мы рекомендуем загрузить медиафайл самостоятельно.
https://www.luckyshrub.com/assets/lucky-shrub-eclipse-viewing.mp4
<WHATSAPP_USER_PHONE_NUMBER>
Нить
Необходимый.
Номер телефона пользователя WhatsApp.
+16505551234
Поддерживаемые видеоформаты
Поддерживаются только видеокодек 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 МБ
Пример запроса
Пример запроса на отправку видеосообщения с субтитрами пользователю WhatsApp.
curl 'https://graph.facebook.com/ v25.0 /106540352242922/messages' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d '{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "video", "video": { "id" : "1166846181421424", "caption": "Сочное затмение!" } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }

    
        

    


            

        

    


    


    
    

        

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