Evolution API icon

Evolution API

Interact with Evolution API

Actions114

Chat → Find Messages

AI-generated

Overview

This node interacts with the Evolution API to find chat messages based on various filters. It is useful for retrieving specific messages or sets of messages from a chat instance, such as filtering by contact, message ID, message direction (sent or received), and supports pagination and limiting the number of results. Practical examples include searching for messages from a particular contact, retrieving messages sent only by the user, or fetching a specific message by its ID.

Use Case Examples

  1. Retrieve all messages from a specific contact in a chat instance.
  2. Find a message by its unique message ID.
  3. Get only messages sent by the user, with pagination support.

Properties

Name Meaning
Instance Name The name of the chat instance to search messages in.
Contact Optional filter to search messages from a specific contact number.
Message ID Optional filter to find a specific message by its unique ID.
From Me Filter messages by direction: all messages, only those sent by the user, or only received messages.
Page Page number for paginated results.
Quantity Per Page Number of messages to return per page.
Limit Maximum number of messages to return; 0 means no limit.

Output

JSON

  • messages - Array of messages matching the search criteria.

Dependencies

  • Evolution API service with authentication credentials

Troubleshooting

  • Ensure the instance name is correctly specified; an incorrect instance name may result in no data returned or errors.
  • Verify that the contact number and message ID filters are correctly formatted if used.
  • Pagination parameters (page, quantity per page) should be positive integers; invalid values may cause errors or unexpected results.
  • The Evolution API credentials must be valid and authorized to access the chat data; authentication errors will prevent data retrieval.

Links

Discussion