Actions64
- Instance Actions
- Message Actions
- Group Actions
- Integration Actions
- Chat Actions
- Profile Actions
- Event Actions
Overview
The "Fetch Groups" operation of the Group resource in this node allows users to retrieve information about groups from the Evolution API. It supports three search methods: by invite code, by group ID, or fetching all groups. This flexibility makes it useful for scenarios such as:
- Looking up a specific group using its unique invite code.
- Retrieving detailed information about a group when its ID is known.
- Fetching all available groups, optionally including their participants.
Practical examples include managing group memberships, auditing group details, or integrating group data into workflows for communication or collaboration platforms.
Properties
| Name | Meaning |
|---|---|
| Instance Name | The name of the Evolution API instance to connect to. |
| Search Method | The method used to find groups. Options: "By Invite Code", "By Group ID", "Fetch All Groups". |
| Invite Code | The unique invite code of the group (required if searching by invite code). |
| Group ID | The identifier of the group to fetch (required if searching by group ID). |
| Get Participants | Whether to include the list of participants in each group when fetching all groups (boolean). |
Output
The node outputs JSON data representing the fetched group(s) information. Depending on the search method:
- By Invite Code or Group ID: Outputs details of the single matched group.
- Fetch All Groups: Outputs an array of all groups, optionally including participant lists if enabled.
The output structure typically includes group metadata such as IDs, names, and possibly participant details. There is no binary data output.
Dependencies
- Requires connection to the Evolution API endpoint.
- Needs an API authentication credential configured in n8n to authorize requests.
- The base URL for API requests is set to
https://doc.evolution-api.com/api-reference.
Troubleshooting
- Operation Not Supported Error: If the selected operation or resource is not implemented, the node will throw an error indicating unsupported operation. Ensure the correct resource and operation names are selected.
- Missing Required Parameters: When using "By Invite Code" or "By Group ID" search methods, omitting the required invite code or group ID will cause errors. Provide these parameters as required.
- API Authentication Issues: Failure to authenticate with the Evolution API due to missing or invalid credentials will prevent successful execution.
- Empty Results: Using "Fetch All Groups" without enabling participant retrieval may return limited information; enable participant fetching if needed.
Links and References
- Evolution API Documentation (base URL referenced in the node)