Actions9
Overview
This node manages Zalo groups, specifically allowing operations such as creating groups, retrieving group info, managing members, and changing group details. The "Đổi Avatar Nhóm" (Change Group Avatar) operation updates the avatar image of a specified Zalo group by providing a new image URL.
Common scenarios include:
- Updating the visual identity of a group by changing its avatar.
- Automating group management tasks like adding or removing members.
- Retrieving detailed information about groups for reporting or integration purposes.
Practical example:
- A community manager wants to update the group avatar automatically when a new event banner is available. They can use this node to set the new avatar by specifying the group ID and the URL of the new image.
Properties
| Name | Meaning |
|---|---|
| ID Nhóm | The unique identifier of the Zalo group whose avatar will be changed. |
| 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" (Success).response: The raw response from the API after attempting to change the group avatar, which may include additional metadata or confirmation details.
Example output structure:
{
"status": "Thành công",
"response": { /* API response object */ }
}
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 the Zalo service.
- The external dependency is the Zalo API accessed via the
zca-jslibrary.
Troubleshooting
- Invalid Credentials: If the node throws "No API instance found," verify that the provided API credentials (cookie, IMEI, user agent) are valid and have not expired.
- Invalid Group ID: Errors may 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 can cause timeouts or failures; check network access to the Zalo API endpoints.
- To handle errors gracefully, enable "Continue On Fail" in the node settings to process subsequent items even if one fails.
Links and References
- Zalo Official API Documentation
- n8n Documentation on Creating Custom Nodes
- zca-js Library (Zalo Client API) (for reference on underlying API calls)