Actions64
- Instancia Actions
- Mensagem Actions
- Grupo Actions
- Chat Actions
- Perfil Actions
- Evento Actions
- Integração Actions
Overview
The node "Evolution API Direct" allows users to interact with the Evolution API by directly specifying the server URL and an API key. Specifically, for the Resource "Grupo" and Operation "Buscar Grupos," it enables searching for groups in different ways: by invite code, by group ID, or fetching all groups. This node is useful when you want to programmatically retrieve group information from the Evolution API, such as for automation workflows that manage or monitor group data.
Practical examples include:
- Fetching a specific group’s details using its invite code.
- Retrieving group information by its unique group ID.
- Listing all groups available in the instance, optionally including their participants.
Properties
| Name | Meaning |
|---|---|
| Server URL | The full URL of your Evolution API server (e.g., https://api.exemplo.com). |
| API Key | The API key credential required to authenticate requests to the Evolution API. |
| Nome Da Instância | The name of the instance within the Evolution API environment. |
| Método De Busca | The method used to search for groups. Options: "Por Código De Convite" (by invite code), "Por ID Do Grupo" (by group ID), "Buscar Todos Os Grupos" (fetch all groups). |
| Código Do Convite | The invite code of the group to search for (required if searching by invite code). |
| ID Do Grupo | The group ID to search for (required if searching by group ID). |
| Obter Participantes | Boolean flag indicating whether to retrieve the list of participants for each group (only applicable when fetching all groups). |
Output
The node outputs JSON data representing the group(s) retrieved from the Evolution API according to the selected search method. The structure typically includes group metadata such as group ID, name, invite code, and optionally the list of participants if requested.
If participants are fetched, the output will contain nested arrays or objects listing participant details per group.
No binary data output is indicated.
Dependencies
- Requires access to the Evolution API endpoint specified by the user.
- Requires a valid API key for authentication.
- The node expects the user to provide the correct server URL and instance name.
- No additional external dependencies beyond standard HTTP requests.
Troubleshooting
Common issues:
- Incorrect or missing API key leading to authentication errors.
- Invalid server URL causing connection failures.
- Providing invite code or group ID that does not exist results in empty or error responses.
- Forgetting to set required parameters based on the chosen search method.
Error messages:
- "Operação não suportada." — This indicates the selected operation is not supported; ensure the resource and operation names are correct.
- Network or authentication errors may occur if the server URL or API key is invalid; verify credentials and endpoint accessibility.
Resolutions:
- Double-check all required input fields are filled correctly.
- Confirm API key validity and permissions.
- Verify network connectivity to the specified server URL.
- Use the appropriate search method matching the provided parameters.
Links and References
- Evolution API Documentation: https://doc.evolution-api.com/api-reference (as referenced in the default baseURL)
- n8n Documentation: https://docs.n8n.io/ (for general node usage and troubleshooting)