Zalo Group

Quản lý nhóm Zalo

Actions3

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 analyze or process group membership data, such as monitoring group activity, managing member roles, or integrating group information into other workflows.

For example, you might use this node to:

  • Fetch the first 50 members of a marketing group to send targeted messages.
  • Retrieve admin and member lists to audit group permissions.
  • Integrate group member data into a CRM system for better customer segmentation.

Properties

Name Meaning
ID Nhóm The unique identifier of the Zalo group from which to retrieve members.
Giới Hạn Maximum number of group members to return in the response. Must be at least 1.

Output

The node outputs a JSON object containing the following fields:

  • members: An array of member IDs limited by the specified "Giới Hạn".
  • admins: An array of admin IDs within the group.
  • currentMems: An array representing current members (details depend on API).
  • updateMems: An array representing updated members (details depend on API).
  • totalMember: The total number of members in the group.

Example output structure:

{
  "members": ["memberId1", "memberId2", "..."],
  "admins": ["adminId1", "adminId2", "..."],
  "currentMems": [...],
  "updateMems": [...],
  "totalMember": 123
}

No binary data is output by this node.

Dependencies

  • Requires an API key credential to authenticate with the Zalo API.
  • The node depends on the external zca-js library to interact with Zalo services.
  • Proper configuration of credentials including cookie, IMEI, and user agent strings is necessary for successful API calls.

Troubleshooting

  • Common Issues:

    • Invalid or expired credentials may cause authentication failures.
    • Providing an incorrect group ID will result in errors or empty responses.
    • Requesting a limit higher than the actual number of members returns only available members.

  • Error Messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Verify that the API key credential is correctly set up and contains valid cookie, IMEI, and user agent values.
    • Errors related to network or API limits should be handled by checking connectivity and respecting Zalo API rate limits.

  • Resolution Tips:

    • Double-check the group ID input for correctness.
    • Ensure the API credential is up-to-date and has required permissions.
    • Use the "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion