evolution-message-search

Evolution API - Search Messages node for n8n. Search WhatsApp message history by keywords, dates, and conversation.

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 2.0.5

Available Nodes

Documentation generating…

Evolution API - Search Messages icon
Evolution API - Search Messages
Search WhatsApp message history via Evolution API

Documentation

n8n-nodes-evolution-message-search

Evolution API - Search Messages node for n8n. Search WhatsApp message history by keywords, dates, and conversation.

Features

  • Search WhatsApp message history via Evolution API
  • Filter by keywords in message content
  • Filter by date range (from/to)
  • Filter by conversation ID (WhatsApp JID)
  • Paginated results with configurable page size
  • AI agent tool support (usable as tool in AI workflows)

Requirements

  • n8n instance (v1.0+)
  • Evolution API instance with API access
  • Existing evolutionApi credentials configured in n8n

Installation

Option 1: Install from npm (coming soon)

npm install n8n-nodes-evolution-message-search

Option 2: Install as community node

  1. In n8n, go to Settings > Community Nodes
  2. Click Install
  3. Enter: n8n-nodes-evolution-message-search
  4. Accept terms and install

Option 3: Install from source

cd n8n-nodes-evolution-message-search
npm install
npm run build
npm link

Then in your n8n installation directory:

cd ~/.n8n/custom
npm link n8n-nodes-evolution-message-search

Configuration

Credentials

This node uses the existing evolutionApi credential type. Before using the node:

  1. Go to Credentials in n8n
  2. Create a new Evolution API credential
  3. Enter your Evolution API URL and API key

Node Parameters

Parameter Who Sets Model Can Change Description
Instance Name User No Evolution API instance name
Conversation ID User Only if allowed WhatsApp conversation JID
Allow Model to Set Conversation User No Permission for AI model to set conversation
Keywords Model Yes Search text in messages
Date From Model Yes Start date for search
Date To Model Yes End date for search
Items per Page User No Results per page (1-100)
Page Number Model Yes Page to retrieve

Output Format

{
  "total": 100,
  "pages": 10,
  "currentPage": 1,
  "pageSize": 10,
  "records": [
    {
      "id": "msg_abc123",
      "key": {
        "remote": "5511999999999@s.whatsapp.net",
        "id": "some_id"
      },
      "message": {
        "conversationMessage": {
          "text": "Hello world"
        }
      },
      "messageType": "conversation",
      "fromMe": true,
      "timestamp": 1703001234
    }
  ]
}

Evolution API Reference

License

MIT

Discussion