send
Delivers WhatsApp text messages from your own account, quotes replies, and forwards existing messages or media to a phone number or chat JID.
Instructions
Send a WhatsApp text message from the user's own account, or forward one. to is a phone number in international format or a chat JID (v_chats.jid — the only way to address a group). Optional reply_to is the v_messages.stanza_id of a message in that chat to quote. To forward instead, give forward (a v_messages.stanza_id from any chat: text, link, image, video, GIF, sticker, voice note or document) and no text. Irreversible and seen by real people: send only what the user explicitly asked for, to the chat they named. Needs whatskept live running.
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>"
},
"name": "send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | phone number in international format (+971501234567) or a chat JID from v_chats.jid | |
| text | No | the message text; omit when forwarding | |
| forward | No | optional: v_messages.stanza_id of a message (any chat) to forward to 'to' — instead of text | |
| reply_to | No | optional: v_messages.stanza_id of a message in the same chat to reply to (quote) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the message's stanza ID (ZSTANZAID in the database) | |
| ts | Yes | send time, UTC ISO | |
| chat | Yes | the chat JID the message went to | |
| warning | No | set when the message was sent but not recorded in the database; do not resend |