Actions16
Overview
This node manages Zalo groups, allowing users to perform various group-related operations via the Zalo API. Specifically, the "Tạo Nhóm" (Create Group) operation enables creating a new Zalo group with a specified name and a list of member user IDs.
Common scenarios where this node is beneficial include:
- Automating the creation of Zalo groups for team collaboration or event planning.
- Programmatically managing group membership by adding or removing users.
- Integrating Zalo group management into broader workflows such as CRM systems or marketing campaigns.
Practical example:
- Automatically create a group named "Project Team" and add multiple members by their user IDs when a new project starts.
Properties
| Name | Meaning |
|---|---|
| Tên Nhóm (groupName) | The name of the new group to be created. |
| 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) (userIds) | A comma-separated list of user IDs to be added as members of the new group. |
Output
The output JSON contains the response from the Zalo API after creating the group. It typically includes details about the newly created group such as its ID and member information.
Example output structure:
{
"json": {
// Response object returned by the Zalo API's createGroup method
},
"pairedItem": {
"item": 0
}
}
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, IMEI, and user agent strings to establish a session with Zalo.
- The external dependency is the
zca-jslibrary which provides the interface to the Zalo API.
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.
- Malformed User IDs: Ensure the user IDs string is correctly formatted as a comma-separated list without extra spaces or invalid characters.
- API Rate Limits or Errors: The Zalo API may return errors if limits are exceeded or parameters are invalid; check the error message for details.
- Empty Group Name or User List: Both the group name and user IDs are required; missing these will cause the operation to fail.
Links and References
- Zalo Official API Documentation
- Zalo Group Management API Reference
- zca-js GitHub Repository (library used for Zalo API interaction)