Evolution APIInstall

Overview

This node interacts with the Evolution API v2 to manage WhatsApp groups and other related resources. Specifically, the "Atualizar Nome do Grupo" (Update Group Name) operation allows users to change the subject/name of an existing WhatsApp group within a specified instance.

Common scenarios where this node is beneficial include automating group management tasks such as renaming groups based on campaign phases, updating group titles dynamically in customer support workflows, or maintaining organized group names in large-scale WhatsApp marketing or community management setups.

For example, a user might use this node to rename a group from "Summer Campaign 2023" to "Winter Campaign 2023" automatically when switching marketing campaigns, ensuring participants always see the current context in the group name.

Properties

Note: Although your provided properties JSON does not explicitly list the new group name property, the operation "Atualizar Nome do Grupo" implies that the node expects a parameter for the new group subject/name. This is consistent with the API's typical requirements for updating a group's subject.

Output

The node outputs a JSON object representing the response from the Evolution API after attempting to update the group name. The output includes:

• success: A boolean indicating if the operation was successful.
• message (optional): A message confirming the operation status.
• timestamp: The ISO string timestamp when the operation was performed.
• Additional fields returned by the API relevant to the update operation.

If the API returns an array or string, the node attempts to parse it into JSON objects accordingly.

The node does not output binary data.

Dependencies

• Requires an API key credential configured in n8n to authenticate requests to the Evolution API.
• The node uses HTTP requests to the Evolution API endpoints; thus, internet connectivity and proper API access permissions are necessary.
• The "Instance Name" must correspond to a valid and connected WhatsApp instance managed by the Evolution API.

Troubleshooting

• Missing or Invalid Instance Name: Ensure the "Instance Name" matches an active instance in the Evolution API. Errors may occur if the instance is not found or disconnected.
• Invalid Group ID: Providing an incorrect or non-existent group ID will cause the API to fail updating the group name.
• API Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
• Network Issues: Connectivity problems can lead to request failures; check network status and API availability.
• Unexpected API Responses: If the API returns unexpected data formats, the node may fail to parse responses properly.

Common error messages typically relate to authentication failures, invalid parameters, or resource not found errors. Reviewing the API documentation and verifying input values usually resolves these issues.

Links and References

• Evolution API Documentation (hypothetical link, replace with actual if available)
• n8n Documentation on Creating Custom Nodes
• WhatsApp Group Management Best Practices

Note: This summary is based solely on static analysis of the provided source code and input properties. Runtime behavior and dynamic API responses are not inferred beyond the static code structure.