Actions10
Overview
This node manages Zalo groups by interacting with the Zalo API. Specifically, the "Thêm Thành Viên Vào Nhóm" (Add User to Group) operation allows users to add one or multiple members to an existing Zalo group. This is useful for automating group management tasks such as onboarding new members into team chats, community groups, or project channels on Zalo.
Practical examples include:
- Automatically adding new employees to a company’s internal Zalo group.
- Adding participants to event-specific groups based on registration data.
- Managing membership of interest-based communities by syncing external user lists.
Properties
| Name | Meaning |
|---|---|
| ID Nhóm | The unique identifier of the Zalo group where members will be added. |
| Danh Sách ID Thành Viên (nếu nhiều người dùng vui lòng phân cách bằng dấu phẩy) | A comma-separated list of user IDs representing the members to add to the group. |
Output
The output JSON contains the response from the Zalo API after attempting to add the specified users to the group. It typically includes details about the operation's success and any relevant metadata returned by the API.
Example structure:
{
// Response object from the Zalo API indicating the result of adding users to the group
}
No binary data output is produced by this operation.
Dependencies
- Requires valid Zalo API credentials including an API key credential that provides cookie, IMEI, and user agent information.
- The node depends on the
zca-jslibrary to interact with the Zalo API. - Proper configuration of the Zalo API credential in n8n is necessary to authenticate requests.
Troubleshooting
Common issues:
- Invalid or expired credentials may cause authentication failures.
- Incorrect group ID or user IDs can lead to errors or no changes in group membership.
- Network or API rate limits might cause request failures.
Error messages:
"No API instance found. Please make sure to provide valid credentials."
Resolution: Verify that the Zalo API credentials are correctly set up and not expired.- Errors related to invalid parameters usually indicate wrong group or user IDs; double-check these values.
- If the node fails but "Continue On Fail" is enabled, error details will appear in the output JSON under the
errorfield.
Links and References
- Zalo Official API Documentation
- n8n Documentation on Credentials
- zca-js GitHub Repository (for the underlying Zalo API client library)