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

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

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

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

Отправка Видеообращения

Используйте ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения Конечная точка для отправки видеосообщения пользователю 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> " } }

Параметры тела после

Заполнитель Описание Пример значения
<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.
локон '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" } ] }