Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups, specifically focusing on group-related operations within the Zalo messaging platform. The "Lấy Danh Sách Thành Viên" (Get Group Members) operation retrieves a list of members from a specified Zalo group, including detailed profile information for each member.

Common scenarios where this node is beneficial include:

  • Extracting member lists for group management or analysis.
  • Synchronizing group membership data with other systems.
  • Monitoring group composition and member details for administrative purposes.

For example, a user can input a group ID and specify how many members to retrieve, then use the output to display member profiles or perform further automated processing.

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 object contains the following fields:

  • memberIds: An array of member IDs retrieved from the group, limited by the specified "Giới Hạn".
  • profiles: An object containing detailed profile information for each member ID in memberIds.
  • totalMembers: The total number of members returned (up to the limit).
  • limit: The requested maximum number of members to retrieve.
  • groupInfo: Metadata about the group itself, including general group information fetched alongside members.

This structure allows users to access both the raw member IDs and their corresponding profile details, along with contextual group information.

Dependencies

  • Requires an API key credential to authenticate with the Zalo platform.
  • Uses the zca-js library internally to interact with Zalo's API.
  • Node configuration must include valid credentials containing cookie, IMEI, and user agent strings for authentication.
  • No additional external services are required beyond the Zalo API.

Troubleshooting

  • Invalid Credentials: If the node throws an error indicating no API instance found, verify that the provided API key credential includes valid cookie, IMEI, and user agent values.
  • Empty Member List: If the group has no members or the limit is set too low, the output may contain empty arrays. Confirm the group ID is correct and the limit is sufficient.
  • API Rate Limits or Access Denied: Errors from the Zalo API may occur if the account lacks permissions or exceeds rate limits. Ensure the authenticated user has appropriate rights to access group data.
  • Malformed Input: Make sure the group ID is correctly formatted as a string and the limit is a positive number.

Links and References

Discussion