Сообщения в документации | Документация для разработчиков
Сообщения в документе
Обновлено: 3 ноября 2025 г
Сообщения с документами — это сообщения, в которых отображается значок документа, содержащего ссылку на документ, который пользователь WhatsApp может нажать, чтобы загрузить.
Запрос
синтаксис
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "document", "document": { "id": "<MEDIA_ID> ",<!-- Only if using uploaded media --> "связь": "<MEDIA_URL> ",<!-- Only if using hosted media (not recommended) --> "подпись": "<MEDIA_CAPTION_TEXT> ", "имя файла": "<MEDIA_FILENAME> ", "подпись": "<MEDIA_CAPTION_TEXT> " } }'
Параметры запроса
<ACCESS_TOKEN>Нить
Необходимый.
Системный токен или бизнес-токен .
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD<API_VERSION>Нить
Необязательный.
Версия Graph API.
v25.0
<MEDIA_CAPTION_TEXT>Нить
Необязательный.
Текст подписи к медиафайлу.
Максимальное количество символов: 1024.
Счет-фактура Lucky Shrub<MEDIA_FILENAME>Нить
Необязательный.
Имя файла документа с расширением. Клиент WhatsApp будет использовать соответствующий значок типа файла в зависимости от расширения.
lucky-shrub-invoice.pdf<MEDIA_ID>Нить
Обязательно, если используются загруженные медиафайлы, в противном случае пропустите.
Идентификатор загруженного медиафайла .
1013859600285441<MEDIA_URL>Нить
Обязательно, если используются размещенные медиафайлы; в противном случае опустите.
URL медиафайла, размещенного на вашем общедоступном сервере. Для повышения производительности мы рекомендуем использовать
идентификатор и идентификатор загруженного медиафайла .https://www.luckyshrub.com/invoices/FmOzfD9cKf/lucky-shrub-invoice.pdf<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить
Необходимый.
Идентификатор бизнес-телефона WhatsApp.
106540352242922<WHATSAPP_USER_PHONE_NUMBER>Нить
Необходимый.
Номер телефона пользователя WhatsApp.
+16505551234Поддерживаемые типы документов
Текст
.текст
текст/простой
100 МБ
Microsoft Excel
.xls
application/vnd.ms-excel
100 МБ
Microsoft Excel
.xlsx
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
100 МБ
Microsoft Word
.doc
приложение/msword
100 МБ
Microsoft Word
.docx
application/vnd.openxmlformats-officedocument.wordprocessingml.document
100 МБ
Microsoft PowerPoint
.ppt
application/vnd.ms-powerpoint
100 МБ
Microsoft PowerPoint
.pptx
application/vnd.openxmlformats-officedocument.presentationml.presentation
100 МБ
PDF
.pdf
application/pdf
100 МБ
Официально поддерживаются и гарантированно корректно отображаются в клиенте WhatsApp только перечисленные выше типы документов. Другие типы файлов могут быть отправлены через API, но они не поддерживаются и могут обрабатываться некорректно.
Пример запроса
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": "document", "document": { "id": "1376223850470843", "filename": "order_abc123.pdf", "caption": "Ваше подтверждение заказа (PDF)" } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }