search_messages
Search and retrieve specific WhatsApp messages by query text, optionally filtering by chat JID, with pagination support to manage results effectively.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat_jid | No | Optional: The JID of a specific chat to search within (e.g., '123...net' or 'group@g.us'). If omitted, searches all chats. | |
| limit | No | Max messages per page (default 10) | |
| page | No | Page number (0-indexed, default 0) | |
| query | Yes | The text content to search for within messages |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chat_jid": {
"description": "Optional: The JID of a specific chat to search within (e.g., '123...net' or 'group@g.us'). If omitted, searches all chats.",
"type": "string"
},
"limit": {
"default": 10,
"description": "Max messages per page (default 10)",
"exclusiveMinimum": 0,
"type": "integer"
},
"page": {
"default": 0,
"description": "Page number (0-indexed, default 0)",
"minimum": 0,
"type": "integer"
},
"query": {
"description": "The text content to search for within messages",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}