Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The node "Evolution API" provides an interface to interact with the Evolution API, specifically allowing operations on various resources. For the resource Grupo and operation Atualizar Membros (Update Participants), this node enables managing group members by adding, removing, promoting to admin, or demoting from admin status. This is useful in scenarios where automated group management is needed, such as maintaining membership lists, moderating group roles, or synchronizing group participants with external systems.

Practical examples include:

  • Automatically adding new users to a group when they register on a platform.
  • Removing inactive users from a group.
  • Promoting trusted users to administrators based on certain criteria.
  • Demoting users who no longer require admin privileges.

Properties

Name Meaning
Nome Da Instância The name of the instance to connect to the Evolution API.
ID Do Grupo The unique identifier of the group whose members will be updated.
Ação The action to perform on the members: Add member, Remove member, Promote to administrator, or Demote to member.
Membros Comma-separated list of phone numbers representing the members to update (e.g., 5511999999999,5511888888888).

Output

The node outputs a JSON array containing the result of the executed operation. Each item in the output corresponds to the response from the Evolution API for the requested update on group members. The exact structure depends on the API response but generally includes confirmation of the performed action and any relevant metadata.

If the node supports binary data output, it is not indicated in the provided code or properties, so the output is purely JSON-based.

Dependencies

  • Requires an API key credential to authenticate requests to the Evolution API.
  • The base URL for API requests is https://doc.evolution-api.com/api-reference.
  • Proper configuration of the API authentication credentials within n8n is necessary.
  • No additional external dependencies are indicated.

Troubleshooting

  • Unsupported Operation Error: If the node throws an error stating the operation is not supported, verify that the resource and operation names are correctly set to "groups-api" and "update-participants" respectively.
  • Invalid Group ID or Members List: Errors may occur if the group ID or members list is empty or malformed. Ensure these fields are correctly filled with valid values.
  • Authentication Failures: If API calls fail due to authentication, check that the API key credential is properly configured and has sufficient permissions.
  • API Rate Limits or Network Issues: Temporary failures might happen due to rate limiting or connectivity problems; retrying after some time or checking network settings can help.

Links and References

Discussion