Сообщения в документации | Документация для разработчиков
Сообщения в документе
Обновлено: 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>Нить | Необходимый. Системный токен или бизнес-токен . | |
<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 |
Поддерживаемые типы документов
| Тип документа | Расширение | Тип MIME | Максимальный размер |
|---|---|---|---|
Текст | .текст | текст/простой | 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, но они не поддерживаются и могут обрабатываться некорректно.
Пример запроса
Пример запроса на отправку PDF-файла в виде документа с подписью пользователю 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": "document", "document": { "id": "1376223850470843", "filename": "order_abc123.pdf", "caption": "Ваше подтверждение заказа (PDF)" } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }