Evolution API

Interact with Evolution API

Actions64

Overview

The "Atualizar Membros" (Update Members) operation for the "Grupo" (Group) resource in this custom n8n node allows you to manage group participants via the Evolution API. This operation lets you add, remove, promote, or demote members within a specified group. It is particularly useful for automating group management tasks such as onboarding new users, removing inactive members, or managing admin privileges in messaging or collaboration platforms.

Practical examples:

Automatically add new employees to a company chat group.
Remove users who have left an organization from all relevant groups.
Promote trusted users to administrators based on workflow logic.
Demote users from admin status after a certain period.

Properties

Display Name	Type	Description
Nome Da Instância	String	Digite o nome da instância (Enter the instance name). Required to identify which instance to operate on.
ID Do Grupo	String	ID do grupo para atualizar os membros (Group ID to update members). Required to specify the target group.
Ação	Options	Ação a ser executada com os membros (Action to perform on members):
		- Adicionar Membro (Add Member)
		- Remover Membro (Remove Member)
		- Promover a Administrador (Promote to Admin)
		- Rebaixar Para Membro (Demote to Member)
Membros	String	Lista de números dos membros separados por vírgula (List of member numbers separated by commas, e.g., 5511999999999,5511888888888). Required.

Output

The output will be a JSON array containing the result(s) of the requested action. The structure of each item in the array depends on the response from the Evolution API, but typically includes:

[
  {
    "status": "success",
    "action": "add",
    "groupJid": "123456@g.us",
    "participants": [
      "5511999999999",
      "5511888888888"
    ],
    "message": "Members added successfully."
  }
]

status: Indicates if the operation was successful.
action: The action performed (e.g., add, remove, promote, demote).
groupJid: The group ID affected.
participants: List of participant numbers involved.
message: Human-readable message about the outcome.

Note: The exact fields may vary depending on the Evolution API's response.

Dependencies

External Service: Requires access to the Evolution API.
API Key/Credentials: You must configure valid credentials for the "evolutionApi" in your n8n instance.
n8n Configuration: Ensure the node has access to the internet and the Evolution API endpoint.

Troubleshooting

Common Issues:

Invalid Credentials: If the API key or credentials are missing or incorrect, authentication errors will occur.
Unsupported Operation: If you select an unsupported action, you may see an error like:
```
Operação não suportada.
A função "update-participants" para o recurso "groups-api" não é suportada!
```
Resolution: Double-check that you selected a valid combination of Resource and Operation.
Malformed Participants List: If the "Membros" field is not formatted correctly (e.g., missing commas), the API may reject the request.
Missing Required Fields: All properties are required; omitting any will result in validation errors.