Actions9
Overview
This node manages Zalo groups by interacting with the Zalo API. Specifically, for the "Lấy Danh Sách Thành Viên" (Get Group Members) operation under the "Group" resource, it retrieves a list of members from a specified Zalo group. This is useful for scenarios where you need to monitor or process group membership data, such as syncing group members with another system, auditing group composition, or managing group roles.
Practical examples:
- Fetching up to 50 members of a specific Zalo group to display in a dashboard.
- Retrieving current admins and members to automate role-based notifications.
- Auditing group membership changes over time by comparing member lists.
Properties
| Name | Meaning |
|---|---|
| ID Nhóm | The unique identifier of the Zalo group from which to retrieve members. |
| Giới Hạn | The maximum number of group members to fetch (limit). |
Output
The output JSON contains detailed information about the group members:
{
"members": ["memberId1", "memberId2", "..."], // Array of member IDs limited by the 'Giới Hạn' property
"admins": ["adminId1", "adminId2", "..."], // Array of admin user IDs in the group
"currentMems": [...], // Additional array representing current members (context-specific)
"updateMems": [...], // Additional array representing updated members (context-specific)
"totalMember": 123 // Total number of members in the group
}
members: A sliced list of member IDs up to the specified limit.admins: List of admin user IDs.currentMemsandupdateMems: Additional member-related arrays whose exact usage depends on the API response.totalMember: The total count of members in the group.
No binary data output is produced by this operation.
Dependencies
- Requires a valid Zalo API credential including authentication details such as cookie, IMEI, and user agent.
- The node uses an external Zalo API client library (
zca-js) to perform API calls. - 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.
- Providing an incorrect or non-existent group ID will result in errors or empty responses.
- Exceeding API rate limits could lead to temporary blocking or errors.
Error messages:
"No API instance found. Please make sure to provide valid credentials."
Resolution: Verify that the Zalo API credential is correctly configured and valid.- Errors related to group not found or access denied typically indicate invalid group ID or insufficient permissions.
- Network or timeout errors suggest connectivity issues; retry after some time or check network settings.
Enabling "Continue On Fail" allows processing subsequent items even if one fails.
Links and References
- Zalo Official API Documentation (for reference on group management endpoints)
- n8n Documentation (general guidance on using credentials and error handling)