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 specifying a resource and operation, along with necessary parameters such as server URL and API key. Specifically, for the Resource "Grupo" and Operation "Entrar No Grupo" (Join Group), this node enables an instance to join a group using an invite code. This is useful in scenarios where automated workflows need to manage group memberships dynamically, such as adding instances to collaboration groups or chat rooms based on external triggers.
Practical example: Automatically joining a newly created instance to a specific group when it is provisioned, by providing the invite code and instance name.
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 for authenticating requests to the Evolution API instance or globally. |
| Nome Da Instância | The name of the instance that will join the group. |
| Código Do Convite | The invite code of the group to join (example format: JZNHJLvnNd04UvGefiEZAA). |
Output
The node outputs a JSON array containing the response from the Evolution API after attempting to join the group. The exact structure depends on the API's response but typically includes confirmation of the join action or error details if the operation failed.
If the API returns any binary data (not indicated here), it would be included accordingly, but this operation primarily deals with JSON responses.
Dependencies
- Requires access to the Evolution API endpoint specified by the Server URL.
- Requires a valid API key credential for authentication.
- The node expects the Evolution API to support the "join-group" operation under the "groups-api" resource.
No additional environment variables or n8n configurations are explicitly required beyond these inputs.
Troubleshooting
Common issues:
- Invalid or expired API key leading to authentication errors.
- Incorrect Server URL causing connection failures.
- Invalid or expired invite code resulting in failure to join the group.
- Instance name not recognized by the API.
Error messages:
"Operação não suportada."indicates the requested operation is not supported for the given resource; verify the resource and operation names.- Network or authentication errors may occur if the Server URL or API key is incorrect; ensure these are accurate.
- API-specific error messages related to invite codes or instance names should be checked against the Evolution API documentation.
Links and References
- Evolution API Documentation (base URL referenced in the node)
- Consult your Evolution API provider for detailed information about the "join-group" operation and required parameters.