Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups by interacting with the Zalo API. Specifically, the "Đổi Avatar Nhóm" (Change Group Avatar) operation updates the avatar image of a specified Zalo group using a new image URL.

Common scenarios where this node is useful include:

  • Automatically updating group avatars based on events or schedules.
  • Managing multiple Zalo groups and keeping their avatars consistent with branding or campaigns.
  • Integrating with other systems to reflect changes in group identity dynamically.

For example, a marketing team could use this node to update the avatar of a promotional group whenever a new campaign starts by providing the new image URL.

Properties

Name Meaning
ID Nhóm The unique identifier of the Zalo group whose avatar you want to change.
URL Ảnh The URL of the new avatar image to set for the group.

Output

The output JSON contains:

  • status: A string indicating success, typically "Thành công" (meaning "Success").
  • response: The raw response from the Zalo API after attempting to change the group avatar. This may include details about the updated group or confirmation data.

Example output structure:

{
  "status": "Thành công",
  "response": {
    // API response details here
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential to authenticate with the Zalo API.
  • The node uses stored credentials including cookie, device IMEI, and user agent strings to establish a session with Zalo.
  • The external dependency is the zca-js library which handles communication with the Zalo API.

Troubleshooting

  • Invalid Credentials: If the node throws an error about no API instance found, verify that the provided API credentials (cookie, IMEI, user agent) are valid and have not expired.
  • Invalid Group ID: Errors can occur if the specified group ID does not exist or the authenticated user lacks permission to modify it.
  • Invalid Image URL: Ensure the image URL is accessible and points to a valid image format supported by Zalo.
  • Network Issues: Connectivity problems with the Zalo API endpoint can cause failures; check network access and retry.
  • Error Handling: If the node is configured to continue on failure, errors will be returned in the output JSON under an error field for each failed item.

Links and References

Discussion