Actions9
Overview
This node manages Zalo groups, specifically allowing operations such as creating groups, retrieving group info, managing members and deputies, changing group avatars or names, and more. The "Đổi Avatar Nhóm" (Change Group Avatar) operation updates the avatar image of a specified Zalo group by providing a new image URL.
Practical scenarios include:
- Automatically updating group avatars based on events or schedules.
- Managing multiple Zalo groups programmatically.
- Integrating Zalo group management into broader workflows for team communication or marketing.
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, e.g.,"Thành công"("Success").response: The raw response from the Zalo API after attempting to change the group avatar. This typically includes details about the update operation.
Example output structure:
{
"status": "Thành công",
"response": {
// API response details here
}
}
No binary data is output by this node.
Dependencies
- Requires an API key credential to authenticate with the Zalo platform.
- Uses stored credentials including cookie, IMEI, and user agent strings to establish a session.
- Depends on the external
zca-jslibrary for interacting with the Zalo API. - Proper configuration of the Zalo API credentials in n8n is necessary.
Troubleshooting
- Invalid Credentials: If the node throws "No API instance found," it means authentication failed. Verify that the provided API credentials (cookie, IMEI, user agent) are correct and valid.
- Invalid Group ID: Providing a wrong or non-existent group ID will cause errors when trying to change the avatar. Double-check the group ID.
- Invalid Image URL: The image URL must be accessible and valid. Broken links or unsupported formats may cause the API call to fail.
- API Rate Limits or Permissions: If the Zalo API limits requests or the authenticated user lacks permissions, operations may fail. Check API usage policies and user rights.
- Use the "Continue On Fail" option to handle errors gracefully within workflows.
Links and References
- Zalo Official API Documentation
- n8n Documentation on Creating Custom Nodes
- zca-js GitHub Repository (for the underlying Zalo API client)