Actions13
Overview
This node manages Zalo groups, specifically allowing users to create and manipulate groups within the Zalo platform. The "Tạo Nhóm" (Create Group) operation enables creating a new group by specifying its name and members. This is useful for automating group creation workflows, such as setting up project teams, event groups, or community chats on Zalo.
Practical examples:
- Automatically create a group for a new project team with specified members.
- Set up event-specific groups by providing participant IDs.
- Manage social or work groups programmatically without manual intervention in the Zalo app.
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 member IDs to add to the group upon creation. |
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, name, and member information.
Example output structure:
{
"json": {
"id": "string", // The unique identifier of the created group
"name": "string", // The name of the group
"members": ["string"] // Array of member IDs included in the group
// ... other group-related metadata returned by the API
},
"pairedItem": {
"item": 0 // Index of the input item this output corresponds to
}
}
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential to authenticate with the Zalo platform.
- The node uses the
zca-jslibrary internally to interact with Zalo's API. - Proper configuration of credentials including cookie, IMEI, and user agent is necessary for successful API calls.
Troubleshooting
Common issues:
- Invalid or expired credentials may cause authentication failures.
- Incorrectly formatted member ID lists (e.g., missing commas) can lead to errors.
- Network connectivity problems might prevent API communication.
Error messages:
"No API instance found. Please make sure to provide valid credentials."
Resolution: Verify that the API key credential is correctly set up and valid.- Errors related to member ID parsing or empty member lists.
Resolution: Ensure the member IDs are provided as a comma-separated string without extra spaces or invalid characters. - API call failures due to rate limits or permission issues.
Resolution: Check API usage limits and permissions granted to the API key.