Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The node "Evolution API" allows interaction with the Evolution API, specifically supporting various resources and operations. For the resource "Grupo" and operation "Atualizar Membros" (Update Participants), it 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 chat groups, community moderation, or syncing membership lists programmatically.

Practical examples:

  • Automatically add new users to a group when they register on a platform.
  • Remove inactive members from a group based on certain criteria.
  • Promote trusted members to administrators for better group management.
  • Demote members 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. Options: Add Member, Remove Member, Promote to Admin, Demote to Member.
Membros Comma-separated list of member phone numbers to apply the action to (e.g., 5511999999999,5511888888888).

Output

The node outputs a JSON array containing the result of the update participants operation. Each item in the output array corresponds to the response from the Evolution API after performing the specified action on the group members. The exact structure depends on the API response but generally includes confirmation of success or failure per member.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The base URL for requests is https://doc.evolution-api.com/api-reference.
  • Proper configuration of the API credential within n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials leading to authentication errors.
    • Incorrect group ID causing failures to locate the target group.
    • Malformed or empty members list resulting in no action performed.
    • Unsupported actions if the action parameter is set incorrectly.

  • Error messages:

    • "Operação não suportada." indicates that the selected operation is not implemented for the chosen resource. Verify that "Atualizar Membros" is supported under "Grupo".
    • API errors returned from the Evolution API may include permission denied or invalid input errors; check the API documentation and ensure all required parameters are correctly set.

Links and References

Discussion