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.

Actions66

Queue → Get Items

AI-generated

Summary

Lists queued messages, with optional filters for batch ID, status, and search text. Use it to inspect individual items in the queue for the selected account or across accounts available to the API key.

Inputs

  • Account Name or ID — Select an account to filter queue items by account. If left empty, the node uses the credential's default account or automatically selects an account when the API key has access to exactly one; with multiple accounts, no account filter is added.
  • Filters — Optionally filter by Batch ID, a comma-separated Status list (pending, processing, sent, delivered, failed, cancelled, or all), or Search text.
  • Return All — When enabled, retrieves all matching results. Otherwise, retrieves up to the Limit, which defaults to 50.
  • Limit — Maximum number of matching results when Return All is disabled; defaults to 50.

Output shape

A list of queue item records, emitted as individual n8n items.

The request is paginated internally. Each record includes the API's queue item data; the operation description highlights item ID, chat, status, and scheduled time. With Return All disabled, results are capped at Limit.

Links

Discussion