Send WhatsApp media message
send_media_messageSend WhatsApp images, videos, audio, documents, or stickers via a public HTTPS link or uploaded media ID, with optional captions for supported media types, within an open 24-hour service window.
Instructions
Send an image, video, audio, document or sticker, either by a public HTTPS link or by a media_id from upload_media. Captions are supported for image/video/document only. Requires an open 24-hour customer-service window.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"to": "<to>",
"media_type": "<media_type>"
},
"name": "send_media_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Recipient phone number, ideally E.164 (e.g. +971501234567) | |
| link | No | Public HTTPS URL of the media | |
| caption | No | Caption (image, video, document only) | |
| filename | No | File name shown for documents | |
| media_id | No | ID returned by upload_media (use instead of link) | |
| media_type | Yes | Kind of media to send | |
| reply_to_message_id | No | Optional wamid of a message to reply to (shown as a quoted reply) |