Evolution API icon

Evolution API

Interact with Evolution API

Overview

The "Update Members" operation for the Group resource in this node allows users to manage group membership dynamically by adding, removing, promoting, or demoting members within a specified group. This is particularly useful in scenarios where group composition needs to be controlled programmatically, such as managing chat groups, team collaboration spaces, or community memberships.

Practical examples include:

  • Adding new participants to a project discussion group automatically when they join a project.
  • Removing inactive or unauthorized members from a group.
  • Promoting trusted members to administrators to delegate management responsibilities.
  • Demoting administrators back to regular members if needed.

Properties

Name Meaning
Name Da Instância The name of the instance where the group exists; identifies the specific environment or server.
Group ID 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 member phone numbers (e.g., 5511999999999,5511888888888) to apply the action to.

Output

The node outputs a JSON array containing the result of the update operation. Each element corresponds to the response from the API after performing the requested action on the specified members. The exact structure depends on the API's response but generally includes confirmation of success or failure for each member processed.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The node communicates with the Evolution API endpoint at https://doc.evolution-api.com/api-reference.
  • Proper configuration of the API credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Invalid or missing Group ID can cause the operation to fail.
    • Incorrectly formatted member numbers (not comma-separated or invalid phone number format) may lead to errors.
    • Insufficient permissions or invalid API credentials will prevent updates.
    • Attempting unsupported actions or using unsupported combinations of resource and operation will throw errors.
  • Error Messages:

    • "Operação não suportada." indicates that the selected operation is not supported for the chosen resource. Verify that "Update Members" is selected under the Group resource.
    • API errors related to authentication or authorization typically require checking the API key credential setup.
    • Validation errors about member lists usually mean the input format is incorrect; ensure numbers are comma-separated without extra spaces.

Links and References

Discussion