Actions53
- Instância Actions
- Mensagem Actions
- Grupo Actions
- Chat Actions
- Evento Actions
- Integração Actions
Overview
This node interacts with the Evolution API v2 to manage WhatsApp-related resources such as instances, messages, groups, chats, events, and integrations. Specifically, for the "Grupo" (Group) resource and the "Atualizar Descrição do Grupo" (Update Group Description) operation, it allows users to update the description of a WhatsApp group within a specified instance.
Common scenarios where this node is beneficial include automating group management tasks in WhatsApp business workflows, such as updating group descriptions dynamically based on external data or triggers, improving communication clarity within groups, or maintaining up-to-date information for group participants.
Practical example: A company uses this node to automatically update the description of a customer support WhatsApp group to reflect current support hours or ongoing promotions.
Properties
| Name | Meaning |
|---|---|
| Instance Name | The name of the WhatsApp instance where the group exists. This identifies which instance to operate on. |
| Group ID | The unique identifier of the WhatsApp group whose description will be updated. |
Note: Although your provided properties JSON only includes "Instance Name" and "Group ID", the actual operation "Atualizar Descrição do Grupo" would require an input for the new description text. However, this property is not explicitly listed in the snippet you provided.
Output
The node outputs a JSON object representing the result of the API call to update the group description. The output structure generally includes:
success: A boolean indicating if the operation was successful.message(optional): A success message string.timestamp: The ISO timestamp when the operation was completed.- Additional fields returned by the Evolution API related to the update operation.
If the API returns no content (null), the node outputs a generic success message with a timestamp.
The node does not output binary data for this operation.
Dependencies
- Requires an API key credential configured in n8n to authenticate requests to the Evolution API.
- The node depends on the Evolution API v2 endpoints being accessible and properly configured.
- The user must provide valid instance names and group IDs corresponding to their WhatsApp setup in Evolution API.
Troubleshooting
Common issues:
- Invalid or missing instance name or group ID parameters can cause the API request to fail.
- Authentication errors if the API key credential is not set up correctly.
- Network connectivity problems preventing access to the Evolution API.
- Attempting to update a group description on a non-existent or disconnected instance.
Error messages:
- Errors thrown by the node typically contain the API error message. For example, "Group not found" or "Unauthorized".
- If the node fails due to invalid JSON parsing or unexpected response format, ensure that the API endpoint is returning valid JSON.
Resolutions:
- Verify all required input parameters are correctly set.
- Check and configure the API authentication credentials in n8n.
- Confirm the Evolution API service is reachable and the instance is active.
- Use the node's "Continue On Fail" option to handle errors gracefully in workflows.
Links and References
- Evolution API Documentation (Assumed URL; replace with actual if known)
- n8n Documentation on Creating Custom Nodes
- WhatsApp Business API Overview
Note: The source code provided is a bundled class implementing multiple resources and operations. The summary above focuses solely on the "Grupo" resource and the "Atualizar Descrição do Grupo" operation as requested.