Actions10
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 for this node include:
- Automating group management tasks in Zalo, such as updating group avatars to reflect current themes or events.
- Integrating Zalo group administration into broader workflows, e.g., marketing campaigns or community management.
- Keeping group information up-to-date without manual intervention.
Example: Automatically update the avatar of a promotional group every month with a new banner image hosted online.
Properties
| Name | Meaning |
|---|---|
| ID Nhóm | The unique identifier of the Zalo group whose avatar will be changed. This is required. |
| 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 output JSON contains two main fields:
status: A string indicating the success of the operation, typically"Thành công"meaning "Success".response: The raw response from the Zalo API after attempting to change the group's avatar. This may contain additional details about the operation's result.
No binary data output is produced by this operation.
Example output JSON:
{
"status": "Thành công",
"response": {
// API-specific response details here
}
}
Dependencies
- Requires an API key credential to authenticate with the Zalo platform.
- The node uses stored credentials including cookie, IMEI, and user agent strings to establish a session with Zalo's API.
- The external library
zca-jsis used internally to interact with Zalo's API. - Proper configuration of the Zalo API credentials within n8n is necessary for successful execution.
Troubleshooting
- Invalid Credentials: If the node throws an error about missing or invalid API instance, verify that the provided API key credential is correct and active.
- 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 directly to a valid image file.
- Network Issues: Connectivity problems can cause timeouts or failures; check network access to Zalo services.
- API Limits: Frequent changes might hit rate limits imposed by Zalo; consider adding delays or retries.
If the node encounters an error during execution and "Continue On Fail" is enabled, it will return the error message in the output JSON for that item instead of stopping the workflow.
Links and References
- Zalo Official Developer Documentation
- zca-js GitHub Repository (for the underlying Zalo API client library)
(Note: Replace with actual URLs if available)