Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

This node allows you to update the name of a WhatsApp group via the Evolution API. It is useful in scenarios where you need to programmatically change group names, such as automating group management for customer support, event coordination, or community administration.

Practical examples:

  • Automatically renaming groups based on project phases.
  • Updating group names to reflect current topics or campaigns.
  • Managing multiple groups and keeping their names consistent with organizational standards.

Properties

Display Name Type Description
Nome Da Instância String Digite o nome da instância que vai atualizar o nome do grupo (Name of the instance that will update the group name). Required
ID Do Grupo String ID do grupo que terá o nome atualizado (ID of the group whose name will be updated). Required
Novo Nome Do Grupo String Novo nome que será definido para o grupo (New name to set for the group). Required

Output

The output is a JSON object (or array of objects) containing the result of the group name update operation. The exact structure depends on the Evolution API's response, but typically includes fields indicating success, status, and possibly the updated group information.

[
  {
    // Example fields (actual fields depend on API response)
    "success": true,
    "groupJid": "123456@g.us",
    "oldSubject": "Old Group Name",
    "newSubject": "New Group Name",
    "message": "Group name updated successfully"
  }
]

Note: The actual output fields may vary according to the Evolution API documentation.

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 additional configuration required beyond setting up credentials.

Troubleshooting

Common Issues:

  • Invalid Credentials: If your API key or credentials are incorrect, the node will fail to authenticate.
  • Missing Required Fields: All three properties are required. Omitting any will result in an error.
  • Unsupported Operation: If the resource or operation is not supported, you may see an error like:
    • "Operação não suportada."
      "A função "update-group-name" para o recurso "groups-api" não é suportada!"
      • Resolution: Ensure you have selected the correct resource and operation.

Other Potential Errors:

  • Network Issues: Connectivity problems with the Evolution API endpoint.
  • Invalid Group ID: Providing a non-existent or malformed group ID will cause the API to reject the request.

Links and References

If you need more details about the output structure, refer to the official Evolution API documentation for the "update group name" endpoint.

Discussion