Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions9

Overview

This node allows you to change the avatar (profile picture) of a Zalo group by providing the group's ID and the URL of the new image. It is useful in scenarios where you want to automate the management of Zalo groups, such as updating branding or visual identity across multiple groups, or programmatically changing group avatars based on events or schedules.

Practical examples:

  • Automatically update a group's avatar to reflect a special event or campaign.
  • Synchronize group avatars with your organization's current logo or theme.
  • Change the group avatar when certain workflow conditions are met.

Properties

Name Type Meaning
ID Nhóm String The unique identifier of the Zalo group whose avatar you want to change.
URL Ảnh String The direct URL to the new image that will be set as the group's avatar.

Output

The output is a JSON object with the following structure:

{
  "status": "Thành công",
  "response": { /* API response from Zalo after changing the avatar */ }
}
  • status: Indicates success ("Thành công" means "Success" in Vietnamese).
  • response: Contains the raw response returned by the Zalo API for the avatar change operation.

If an error occurs and "Continue On Fail" is enabled, the output will include:

{
  "error": "Error message"
}

Dependencies

  • External Service: Requires access to the Zalo API via the zca-js library.
  • Credentials: You must provide valid Zalo credentials (zaloApi) including cookie, IMEI, and user agent.
  • n8n Configuration: Ensure the Zalo credential is configured in n8n and assigned to this node.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the provided Zalo credentials (cookie, IMEI, user agent) are incorrect or expired, the node will throw an error:
    "No API instance found. Please make sure to provide valid credentials."

    • Resolution: Update your Zalo credentials in n8n.

  • Invalid Group ID: If the group ID does not exist or you do not have permission to modify it, the Zalo API may return an error in the response field.

    • Resolution: Double-check the group ID and your permissions.

  • Image URL Issues: If the image URL is invalid or inaccessible, the avatar change may fail.

    • Resolution: Ensure the image URL is correct and publicly accessible.

  • API Rate Limits or Restrictions: Excessive requests or unsupported operations may result in errors from the Zalo API.

Links and References

For further troubleshooting, consult the Zalo API documentation or contact Zalo support.

Discussion