Сообщения с изображениями | Документация для разработчиков
Сообщения с изображениями
Обновлено: 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>Нить | Необходимый. Системный токен или бизнес-токен . | |
<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.
| Тип изображения | Расширение | Тип MIME | Максимальный размер |
|---|---|---|---|
JPEG | .jpeg | изображение/jpeg | 5 МБ |
ПНГ | .png | изображение/png | 5 МБ |
Пример запроса
Пример запроса на отправку изображения с подписью пользователю 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": "image", "image": { "id" : "1479537139650973", "caption": "Лучший суккулент в мире?" } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }
Комментарии отсутствуют
Комментарии отсутствуют