Evolution API icon

Evolution API

Interact with Evolution API

Overview

The "Update Settings" operation for the Group resource in this node allows users to modify specific group settings related to messaging and editing permissions. This is useful in scenarios where group administrators want to control who can send messages or edit group settings, such as managing announcement-only groups or enabling collaborative management of group configurations.

Practical examples:

  • Setting a group so that only admins can send messages, turning it into an announcement channel.
  • Allowing all members to send messages freely.
  • Restricting group setting edits to admins only.
  • Permitting all members to edit group settings collaboratively.

Properties

Name Meaning
Instance Name The name of the instance where the group exists; used to identify the target environment.
Group ID The unique identifier of the group whose settings are to be updated.
Action The specific setting to apply to the group. Options:
- Only Admins Send Messages (announcement)
- Everyone Sends Messages (not_announcement)
- Only Admins Edit Settings (locked)
- Everyone Edits Settings (unlocked)

Output

The node outputs a JSON array containing the result of the update operation. The exact structure depends on the API response but typically includes confirmation of the applied settings or details about the updated group. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The node uses the base URL https://doc.evolution-api.com/api-reference for API requests.
  • Proper configuration of the API authentication token within n8n credentials is necessary.

Troubleshooting

  • Unsupported operation error: If the specified operation or resource is not supported, the node throws an error indicating the unsupported function. Ensure the resource is set to "groups-api" and operation to "update-settings".
  • Missing required parameters: The node requires "Instance Name", "Group ID", and "Action". Omitting any will cause errors.
  • API authentication failures: Incorrect or missing API credentials will prevent successful requests.
  • Invalid Group ID: Providing an incorrect or non-existent group ID may result in API errors or no changes applied.
  • Network issues: Connectivity problems to the Evolution API endpoint will cause request failures.

To resolve these issues:

  • Verify all required input properties are correctly set.
  • Confirm API credentials are valid and properly configured.
  • Check network connectivity and API endpoint availability.
  • Review API documentation for correct usage of group IDs and actions.

Links and References

Discussion