Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions9

Overview

This node operation allows users to change the avatar image of a group in the Zalo messaging platform. It is useful for group administrators or bots that manage group settings and want to update the group's profile picture programmatically.

Common scenarios include:

  • Automatically updating group avatars based on events or schedules.
  • Customizing group appearance dynamically via workflows.
  • Managing multiple groups' avatars from a centralized automation.

For example, a workflow could trigger this node to set a new group avatar URL whenever a special event occurs, ensuring the group image reflects the current theme or announcement.

Properties

Name Meaning
ID Nhóm The unique identifier (ID) of the group whose avatar will be changed. This is a required string input.
URL Ảnh The URL of the new avatar image to set for the group. This must be a valid image URL and is required.

Output

The node outputs JSON data containing:

  • status: A string indicating success, typically "success".
  • response: The response object returned by the API call to change the group avatar. This usually contains details about the operation result, such as confirmation or error messages.

The output is paired with the input item index to maintain traceability in batch operations.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Zalo platform via an API authentication token (an API key credential).
  • The node uses a shared helper class internally to handle API requests, which requires proper credentials configured in n8n.
  • Network access to the provided image URL must be available so the Zalo API can fetch the new avatar image.

Troubleshooting

  • Invalid Group ID: If the group ID does not exist or the authenticated user/bot lacks permission, the API call will fail. Verify the group ID and permissions.
  • Invalid Image URL: The URL must point to a valid image accessible by the Zalo servers. Ensure the URL is correct and publicly reachable.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Confirm that the API key/token is correctly set up in n8n credentials.
  • API Rate Limits: Frequent avatar changes might hit rate limits imposed by Zalo. Implement retries or delays if needed.
  • Error Handling: The node captures errors per item; if "Continue On Fail" is enabled, it returns error details in the output JSON under error. Otherwise, it throws an error stopping execution.

Links and References

Discussion