n8n-nodes-evolution-message-search 2.0.3 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -93,6 +93,16 @@ class SearchMessages {
93
93
  },
94
94
  ],
95
95
  properties: [
96
+ {
97
+ displayName: 'Tool Description',
98
+ name: 'toolDescription',
99
+ type: 'string',
100
+ typeOptions: {
101
+ rows: 4,
102
+ },
103
+ default: 'Search the WhatsApp message history of a conversation. ALL parameters are OPTIONAL except when explicitly needed:\n\n- Use ONLY keywords when user wants to find specific words/topics\n- Use ONLY dateFrom/dateTo when user asks about a time period (e.g. "last month", "yesterday")\n- Use BOTH keywords AND dates to combine topic search with time period\n- Use NONE when user wants recent messages (uses page 1)\n\nExamples:\n- "Did we talk about payment?" → use keywords="payment"\n- "What did we discuss last month?" → use dateFrom and dateTo only\n- "Anything about refund in January?" → use keywords="refund" + dateFrom/dateTo\n\nNavigation:\n- page: increase to see older messages (model can change)\n- pageSize: number of results per page (user-defined, do not change)',
104
+ description: 'Custom description shown to AI agent to help it understand how to use this tool',
105
+ },
96
106
  {
97
107
  displayName: 'Instance Name',
98
108
  name: 'instanceName',
@@ -107,7 +117,7 @@ class SearchMessages {
107
117
  type: 'string',
108
118
  required: false,
109
119
  default: '',
110
- description: 'WhatsApp conversation ID (JID). If empty, searches all conversations.',
120
+ description: 'WhatsApp conversation ID (JID). Leave empty to search all conversations.',
111
121
  placeholder: '5511999999999@s.whatsapp.net',
112
122
  },
113
123
  {
@@ -123,7 +133,8 @@ class SearchMessages {
123
133
  type: 'string',
124
134
  required: false,
125
135
  default: '',
126
- description: 'Search text in message content (model can set)',
136
+ description: 'OPTIONAL: Search text in message content. Leave empty to search by date only.',
137
+ placeholder: '={{ $fromAI("Keywords", "", "string") }}',
127
138
  },
128
139
  {
129
140
  displayName: 'Date From',
@@ -131,8 +142,8 @@ class SearchMessages {
131
142
  type: 'string',
132
143
  required: false,
133
144
  default: '',
134
- description: 'Start date for message search (model can set)',
135
- placeholder: '2024-01-01T00:00:00Z',
145
+ description: 'OPTIONAL: Start date (ISO format). Use when user mentions a time period. Leave empty to search all time.',
146
+ placeholder: '={{ $fromAI("Date_From", "", "string") }}',
136
147
  },
137
148
  {
138
149
  displayName: 'Date To',
@@ -140,8 +151,8 @@ class SearchMessages {
140
151
  type: 'string',
141
152
  required: false,
142
153
  default: '',
143
- description: 'End date for message search (model can set)',
144
- placeholder: '2024-12-31T23:59:59Z',
154
+ description: 'OPTIONAL: End date (ISO format). Use when user mentions a time period. Leave empty to search all time.',
155
+ placeholder: '={{ $fromAI("Date_To", "", "string") }}',
145
156
  },
146
157
  {
147
158
  displayName: 'Items per Page',
@@ -162,7 +173,8 @@ class SearchMessages {
162
173
  typeOptions: {
163
174
  minValue: 1,
164
175
  },
165
- description: 'Page number to retrieve (model can navigate)',
176
+ description: 'Page to retrieve (model can navigate: increase to see older messages)',
177
+ placeholder: '={{ $fromAI("Page_Number", "1", "number") }}',
166
178
  },
167
179
  ],
168
180
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "n8n-nodes-evolution-message-search",
3
- "version": "2.0.3",
3
+ "version": "2.0.4",
4
4
  "description": "Evolution API - Search Messages node for n8n. Search WhatsApp message history by keywords, dates, and conversation.",
5
5
  "keywords": [
6
6
  "n8n-community-node-package",