Evolution API icon

Evolution API

Interact with Evolution API

Overview

The "Sair Do Grupo" (Leave Group) operation for the "Grupo" (Group) resource in this custom n8n node allows you to programmatically leave a specified group using the Evolution API. This is useful in scenarios where automated workflows need to manage group memberships, such as cleaning up inactive groups, automating user exits from chat or collaboration groups, or integrating with other systems that require dynamic group management.

Practical examples:

  • Automatically remove a bot or user from a WhatsApp group after completing a task.
  • Integrate with CRM or support systems to exit groups when tickets are closed.
  • Schedule regular cleanups of group memberships.

Properties

Display Name Type Description
Nome Da Instância String Digite o nome da instância (Enter the instance name). Required.
ID Do Grupo String ID do grupo que deseja sair (ID of the group you want to leave). Required.

Output

The output will be a JSON object (or array of objects) representing the result of the leave group operation. The exact structure depends on the response from the Evolution API, but typically it may include fields such as:

{
  "success": true,
  "message": "Left group successfully",
  "groupJid": "123456@g.us"
}

If the API returns additional data, those fields will also be included in the output.

Dependencies

  • External Service: Requires access to the Evolution API.
  • API Key/Credentials: You must configure valid Evolution API credentials in n8n under the credential type evolutionApi.
  • n8n Configuration: No special configuration beyond setting up the credentials is required.

Troubleshooting

Common Issues:

  • Invalid Instance Name or Group ID: Ensure both "Nome Da Instância" and "ID Do Grupo" are correct and exist in your Evolution API account.
  • Missing Credentials: If credentials are not set up or are invalid, the node will fail to authenticate.
  • Unsupported Operation Error: If the resource or operation is misspecified, you may see an error like:
    • "Operação não suportada."
      Resolution: Double-check that you selected the correct resource ("groups-api") and operation ("leave-group").

Error Messages:

  • "A função \"leave-group\" para o recurso \"groups-api\" não é suportada!"
    Resolution: This means the operation is not implemented for the selected resource. Verify your node configuration.

Links and References

Discussion