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

Отправка
Видеообращения
Синтаксис запроса
ПОЧТА /<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> " } }
Параметры тела после
| | |
| | |
| | |
| |
Поддерживаемые видеоформаты
Поддерживаются только видеокодек H.264 и аудиокодек AAC. Поддерживается только один аудиопоток или отсутствие аудиопотока.
Обратите внимание, что видео, закодированные с использованием профиля H.264 «High» и B-кадров, не поддерживаются клиентами WhatsApp для Android. Мы рекомендуем использовать профиль H.264 «Main» без B-кадров или профиль H.264 «Baseline» при кодировании (или перекодировании с помощью такого инструмента, как ffmpeg) и размещать блоки moov перед блоками mdat для большей совместимости. Если вы используете ffmpeg, вы можете использовать флаг -movflags в faststart, чтобы разместить блоки moov перед блоками mdata.
3GPP
.3gp
видео/3gpp
16 МБ
Видео MP4
.mp4
видео/mp4
16 МБ
Пример запроса
локон 'https://graph.facebook.com/v25.0/106540352242922/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д '{ "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" } ] }