search_messages
Search WhatsApp message history by keyword or phrase to return matching messages with full conversation context, timestamps, optional chat filtering, and pagination.
Instructions
Search message history for specific keywords or phrases. Returns matching messages with full conversation context and timestamps.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return (default 30, max 200). | |
| query | Yes | Search term to locate in message text. | |
| offset | No | Pagination offset. | |
| chat_id | No | Optional chat JID or contact name to restrict search within. |