Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

The "Update Group" operation in the Evolution API node allows users to modify settings or participants of a WhatsApp group. This operation is useful for managing group membership dynamically, such as adding or removing participants, promoting or demoting admins, or updating group metadata.

Practical scenarios include:

  • Automatically adding new members to a group based on external triggers.
  • Removing inactive or unauthorized participants from a group.
  • Changing admin roles programmatically to delegate group management.
  • Updating group information without manual intervention.

This operation streamlines WhatsApp group administration within automated workflows.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group to update.
Additional Fields Optional parameters to customize the update:
- Delay: Milliseconds to wait before sending the update request.
- Link Preview: Enable or disable link previews in messages sent during the update.
- Quoted Message ID: ID of a message to quote or reply to when sending messages.
- Mentions: Comma-separated list of phone numbers to mention in messages related to update.

Output

The node outputs a JSON object containing the response from the Evolution API after performing the update group operation. This typically includes confirmation of the action taken, updated group details, or error information if the operation failed.

If the operation involves sending messages (e.g., notifications about group changes), the output may also reflect message delivery status.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Evolution API service with valid credentials including:

    • Base URL of the API endpoint.
    • API key for authentication.
    • Instance name identifying the WhatsApp instance.

  • Optionally uses a secondary API validation service requiring its own API URL and key to verify subscription status before executing operations.

  • Proper configuration of these credentials in n8n is necessary for successful execution.

Troubleshooting

  • Invalid Credentials or Subscription Errors: If the node throws errors related to invalid API keys or subscription issues, verify that the provided API keys are correct and that the subscription to the Evolution API service is active.

  • Unknown Operation or Resource Errors: These occur if the operation or resource parameter is set incorrectly. Ensure "Resource" is set to "Group" and "Operation" to "Update Group".

  • Network or Timeout Issues: Delays or failures in connecting to the API endpoint can cause errors. Check network connectivity and API availability.

  • Malformed Group ID or Participant List: Providing incorrect group IDs or improperly formatted participant lists (should be comma-separated phone numbers) will result in API errors. Validate input formats carefully.

  • Permission Denied Errors: Attempting to perform actions without sufficient permissions (e.g., promoting a non-member to admin) will fail. Confirm that the authenticated instance has appropriate rights.

Links and References

Discussion