Actions10
Overview
This node manages personal Zalo groups, specifically allowing users to create and manipulate groups on the Zalo platform. The "Tạo Nhóm" (Create Group) operation enables creating a new group with a specified name and a list of member user IDs.
Common scenarios where this node is useful include:
- Automating the creation of Zalo chat groups for team collaboration or event planning.
- Managing group membership programmatically by adding or removing users.
- Updating group details such as name or avatar.
- Retrieving information about groups and their members.
Practical example:
- Automatically create a project discussion group in Zalo by specifying the project team members' user IDs and the group name, facilitating instant communication.
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 attempting to create 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 platform.
- Uses the
zalo-api-finallibrary internally to interact with Zalo's API. - The node expects valid authentication cookies, device IMEI, and user agent strings either from credentials or input data.
- Proper configuration of the Zalo API credential within n8n is necessary.
Troubleshooting
- Invalid Credentials: If the node throws an error indicating no API instance found, verify that the provided Zalo API credentials are correct and contain valid cookie, IMEI, and user agent values.
- Malformed User IDs: Ensure the user IDs string is correctly formatted as comma-separated values without extra spaces or invalid characters.
- API Rate Limits or Permissions: The Zalo API may restrict group creation or modification based on account permissions or rate limits; check your Zalo account status if operations fail.
- Error Handling: If the node is set to continue on failure, errors will be returned in the output JSON under an
errorfield for each failed item.
Links and References
- Zalo Official Developer Documentation
- Zalo API Node.js SDK (zalo-api-final) (for reference on API methods used)