Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups by interacting with the Zalo API. Specifically, the "Lấy Danh Sách Thành Viên" (Get Group Members) operation 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 sending targeted messages to group members.

For example, you might use this node to:

  • Fetch up to a certain number of members from a Zalo group to analyze active participants.
  • Retrieve admin and member lists to manage permissions or roles externally.
  • Integrate group member data into CRM or marketing tools.

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 in one execution (limit on returned members).

Output

The output JSON contains detailed information about the group members:

{
  "members": ["memberId1", "memberId2", "..."],       // Array of member IDs limited by 'Giới Hạn'
  "admins": ["adminId1", "adminId2", "..."],          // Array of admin user IDs in the group
  "currentMems": [...],                                // Additional current members info (structure depends on API)
  "updateMems": [...],                                 // Updated members info (structure depends on API)
  "totalMember": 123                                   // Total number of members in the group
}
  • members: A sliced array of member IDs up to the requested limit.
  • admins: List of group administrators.
  • currentMems and updateMems: Additional metadata about members, potentially including status or recent changes.
  • totalMember: The total count of members in the group regardless of the limit.

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 that include cookie, IMEI, and user agent strings necessary for authentication.
  • The underlying implementation depends on the external zca-js library to interact with the Zalo API.

Troubleshooting

  • Invalid Credentials: If the node throws "No API instance found," it indicates invalid or missing credentials. Ensure the API key and related authentication details are correctly configured.
  • Group Not Found or Access Denied: Errors may occur if the provided group ID does not exist or the authenticated user lacks permission. Verify the group ID and user access rights.
  • Limit Exceeds Available Members: Setting a limit higher than the actual number of members will simply return all available members without error.
  • Network or API Errors: Temporary network issues or API rate limits can cause failures. Retrying after some time or checking API usage quotas may help.

Links and References

Discussion