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 → Search / List

AI-generated

Summary

Searches or lists persisted messages for the selected WhatsApp account. Use filters to narrow results by chat, full-text query, or timestamp, and choose whether to return all matches or cap the result count.

Inputs

  • Account Name or ID — Select the WhatsApp account to search. If omitted, the node auto-selects when the API key is bound to one account; with a multi-account key, choose an account.
  • Filters — Optional filters: Chat ID (phone digits or group JID), Search Text (full-text search), and After Timestamp (Ms), a Unix-millisecond cursor that returns messages after that time. The default timestamp of 0 applies no time cutoff.
  • Return All — Defaults to false. When enabled, returns all matching messages; otherwise, the Limit controls the maximum number returned.
  • Limit — Maximum results when Return All is off; defaults to 50 and must be at least 1.

Output shape

A list of message records, emitted as separate n8n items.

Each record includes message fields such as ID, chatId, senderId, senderName, body, type, timestamp, fromMe, replyTo, reactions, and delivery status. The API response includes pagination metadata, but the node's all-items helper returns the records as a list; the node emits each list entry as its own item. Requires SocialMate Pro.

Links

Discussion