Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

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.
  • currentMems and updateMems: 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

Discussion