WhatsApp — Send message or attachment
Input
kind requiredWhat to send: a plain text message, an attached file of the given kind, or a saved contact's card.
name optionalExact chat/contact/group name to send to (the `name` field from get_inbox). Provide this OR `phone`, not both.
text optionalMessage text. Required when kind is "text".
phone optionalRecipient phone in international format, no saved contact needed. Confirm this number with the user before running; don't guess or reuse a number from context without checking. Non-digits are stripped, a leading "00" international prefix is removed, and a national number (leading trunk 0) is rejected with a clear error. e.g. "+1 555 123 4567", "15551234567" or "0015551234567". Provide this OR `name`, not both.
caption optionalOptional caption for image/video/document.
filename optionalFilename to send it as, e.g. photo.png / clip.mp4 / file.pdf. Required when kind is image/video/document.
mimeType optionalMIME type; inferred from kind + filename extension when omitted.
fileBase64 optionalFile contents, base64-encoded (no data: prefix). This is the only way to supply the bytes: they cannot be fetched from a URL at run time, so a large file is limited by whatever the caller's own transport allows inline. Required when kind is image/video/document.
contactName optionalThe saved name of the contact whose card to send, exactly as WhatsApp's address book shows it. Every phone number saved for that contact is included. Required when kind is "contact".
Output
kind requiredWhat was sent: "text", "image", "video", "document" or "contact".
sent requiredTrue once the send is confirmed: for text, a delivery tick appeared and WhatsApp did not flag a failure; for an attachment, the upload cleared its pending state and stayed unflagged through a settle window; for a contact card, the outgoing bubble naming the contact appeared unflagged.
recipient requiredThe chat name the message was sent to, read back from the conversation header.
account_used requiredThe phone number of the WhatsApp account that actually sent this, read back from the live session rather than taken from the request.
verified_on_page requiredTrue when the send was confirmed by inspecting the conversation afterwards, rather than assumed from the click.
id optionalWhatsApp message id of the message that was sent. Populated for every kind.
text optionalThe text that was sent; null for attachment and contact sends.
time optionalTimestamp of the sent message as shown in the bubble (e.g. "3:14 PM"); null for attachment and contact sends.
caption optionalThe caption sent with the attachment, or null.
filename optionalThe filename the attachment was sent as, or null for text and contact sends.
contactName optionalThe saved contact whose card was sent, or null for other kinds.
numbersSent optionalHow many of the contact's phone numbers the card carried, counted on WhatsApp's own confirmation screen. Null for other kinds.
already_present optionalWhether an outgoing message with exactly this text was already in the conversation before this send. Reported, not enforced - re-sending the same text is legitimate. Null for image/video and contact sends, where no comparable content is visible in the bubble.
WhatsApp — Get conversation
Open a WhatsApp chat by its exact name (as returned by get_inbox) and return its messages in chronological order: sender, direction (sent/received), time, date, text and media type. `count` = how many recent messages to load (scrolls up for older). A message that was deleted for everyone is still returned, flagged with `deleted: true` and carrying no text, so it is never mistaken for a message that could not be read.
WhatsApp — Get inbox
List the WhatsApp chat list (inbox): for each chat its name, date/time label, read/unread status, unread message count and last-message snippet. Ordered top→down (most recent first). `count` caps how many chats to return.
WhatsApp — Leave group
Leave (exit) a WhatsApp group by exact name, then confirm you are really out. With alsoDelete:true the conversation is also removed from your chat list; left off, the chat stays with its history. Only admins are notified when you leave. If you are already no longer a member of that group, it reports that instead of touching the conversation. Leaving removes you from the group and cannot be undone from here, so the group name is worth confirming with the user rather than guessed.