send_media
Idempotent
Send images, videos, documents, and audio files to a WhatsApp contact or group using file paths, URLs, or base64 content. Supports optional captions and voice notes.
Instructions
Send media (image, video, document, audio) via WhatsApp.
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": {
"recipient_jid": "<recipient_jid>"
},
"name": "send_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recipient_jid | Yes | The recipient JID (e.g., 123456789@s.whatsapp.net or 123456789-12345678@g.us) | |
| media_path | No | Absolute path to the local media file | |
| media_url | No | URL of the media file | |
| media_content | No | Base64 encoded media content | |
| mime_type | No | MIME type of the media_content (required if using media_content) | |
| filename | No | Filename for the media (recommended if using media_content) | |
| caption | No | Optional caption for the media | |
| as_audio_message | No | Send audio specifically as a voice note (requires ffmpeg for conversion if not opus/ogg) | |
| idempotency_key | No | Optional idempotency key. Repeating the same send_media request with the same key returns the original result instead of sending again. | |
| include_full_data | No | Whether to include the full base64 data in the response |