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

Запрос
синтаксис
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "image", "image": { "id": "<MEDIA_ID> ",<!-- Only if using uploaded media --> "связь": "<MEDIA_URL> ",<!-- Only if using hosted media (not recommended) --> "подпись": "<MEDIA_CAPTION_TEXT> " } }'
Параметры запроса
<ACCESS_TOKEN>Нить
Необходимый.
Системный токен или бизнес-токен .
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD<API_VERSION>Нить
Необязательный.
Версия Graph API.
v25.0
<MEDIA_CAPTION_TEXT>Нить
Необязательный.
Текст подписи к медиафайлу.
Максимальное количество символов: 1024.
Самое лучшее суккулентное растение на свете?<MEDIA_ID>Нить
Обязательно, если используются загруженные медиафайлы, в противном случае пропустите.
Идентификатор загруженного медиафайла .
1013859600285441<MEDIA_URL>Нить
Обязательно, если используются размещенные медиафайлы; в противном случае опустите.
URL медиафайла, размещенного на вашем общедоступном сервере. Для повышения производительности мы рекомендуем использовать
идентификатор и идентификатор загруженного медиафайла .https://www.luckyshrub.com/assets/succulents/aloe.png<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить
Необходимый.
Идентификатор бизнес-телефона WhatsApp.
106540352242922<WHATSAPP_USER_PHONE_NUMBER>Нить
Необходимый.
Номер телефона пользователя WhatsApp.
+16505551234Поддерживаемые форматы изображений
Изображения должны быть 8-битными, в формате RGB или RGBA.
JPEG
.jpeg
изображение/jpeg
5 МБ
ПНГ
.png
изображение/png
5 МБ
Пример запроса
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": "image", "image": { "id" : "1479537139650973", "caption": "Лучший суккулент в мире?" } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }