Document messages | Developer Documentation
Document messages
Updated: Nov 3, 2025
Document messages are messages that display a document icon, linked to a document, that a WhatsApp user can tap to download.
Request parameters
| Placeholder | Description | Example Value |
|---|---|---|
<ACCESS_TOKEN>String |
Required.
|
|
<API_VERSION>String |
Optional.
Graph API version. |
v25.0 |
<MEDIA_CAPTION_TEXT>String |
Optional.
Media asset caption text.
Maximum 1024 characters. |
Lucky Shrub Invoice |
<MEDIA_FILENAME>String |
Optional.
Document filename, with extension. The WhatsApp client will use an appropriate file type icon based on the extension. |
lucky-shrub-invoice.pdf |
<MEDIA_ID>String |
Required if using uploaded media, otherwise omit.
ID of the uploaded media asset. |
1013859600285441 |
<MEDIA_URL>String |
Required if using hosted media, otherwise omit.
URL of the media asset hosted on your public server. For better performance, we recommend using id and an uploaded media asset ID instead. |
https://www.luckyshrub.com/invoices/FmOzfD9cKf/lucky-shrub-invoice.pdf |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>String |
Required.
WhatsApp business phone number ID. |
106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>String |
Required.
WhatsApp user phone number. |
+16505551234 |
Supported document types
| Document Type | Extension | MIME Type | Max Size |
|---|---|---|---|
|
Text |
.txt |
text/plain |
100 MB |
|
Microsoft Excel |
.xls |
application/vnd.ms-excel |
100 MB |
|
Microsoft Excel |
.xlsx |
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
100 MB |
|
Microsoft Word |
.doc |
application/msword |
100 MB |
|
Microsoft Word |
.docx |
application/vnd.openxmlformats-officedocument.wordprocessingml.document |
100 MB |
|
Microsoft PowerPoint |
.ppt |
application/vnd.ms-powerpoint |
100 MB |
|
Microsoft PowerPoint |
.pptx |
application/vnd.openxmlformats-officedocument.presentationml.presentation |
100 MB |
|
PDF |
.pdf |
application/pdf |
100 MB |
Only the above listed document types are officially supported and guaranteed to display correctly in the WhatsApp client. Other file types may be sent via the API, but they are not supported and may not be handled as expected.
No comments to display
No comments to display