SocialMate icon

SocialMate

Control WhatsApp from n8n or an AI agent: send & read messages, look up contacts, manage groups, download media, queue paced batches of personalised messages, and fetch conversation memory (Get AI Context) — all through your self-hosted SocialMate server.

Message → Send Text

AI-generated

Summary

Send a plain-text WhatsApp message to one phone number or group. Choose the WhatsApp account, enter the recipient and a 1–4096 character message, and optionally set queue priority, retries, or a message ID to quote in the reply.

Inputs

  • Account Name or ID — WhatsApp account to send from. Leave empty to auto-select when the API key has access to exactly one account; otherwise select an account.
  • Chat ID / Phone Number (required) — Recipient’s phone number in international format with country code, or a group JID ending in @g.us. Punctuation, a leading +, and a 00 prefix are accepted.
  • Text (required) — Message body, 1–4096 characters.
  • Options — Priority (Urgent, High, Normal, Low) and maximum retries apply if the message is auto-queued by the Pro anti-ban pipeline. Reply To Message ID quotes an existing message, such as one from a trigger, search, or earlier send.

Output shape

A single n8n item containing the send response as JSON.

A successful send returns the message ID and delivery status. If the anti-ban pipeline blocks the send with a structured rate-limit response, the operation returns sent: false and blocked: true with the reason and available retry details. Array responses are emitted as one item per entry.

Examples

Example 1: Send a direct message

Select an account, set the Chat ID / Phone Number to an international number such as +1 555 123 4567, and enter the message in Text.

Example 2: Reply to an existing message

Set Reply To Message ID to the message ID from a trigger, search result, or earlier send.

Links

Discussion