Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions10

Overview

This node manages Zalo groups by interacting with the Zalo platform's group-related features. 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.

Common scenarios where this node is useful include:

  • Fetching current members of a Zalo group for monitoring or reporting.
  • Integrating group member data into other workflows or systems.
  • Automating group management tasks based on member lists.

For example, you might use this node to get up-to-date member information before sending targeted messages or analyzing group participation.

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 items).

Output

The output JSON contains detailed information about the group's membership:

  • members: An array of member IDs limited by the specified "Giới Hạn".
  • admins: An array of admin user IDs within the group.
  • currentMems: A list representing current members (likely more detailed info).
  • updateMems: A list of members who have been recently updated or changed.
  • totalMember: The total count of members in the group.

This structure allows downstream nodes or processes to access both summary and detailed membership data.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Zalo API credentials including an API key credential that provides authentication via cookie, IMEI, and user agent strings.
  • The node uses an external Zalo SDK/library (zca-js) to interact with the Zalo API.
  • Proper configuration of these credentials in n8n is necessary for successful API calls.

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 results.
    • Requesting a limit higher than the actual number of members returns only available members without error.

  • Error Messages:

    • "No API instance found. Please make sure to provide valid credentials."
      This indicates missing or invalid credentials; verify your API key and related parameters.
    • Errors thrown during API calls are caught and can be optionally continued on fail, returning the error message in the output JSON.

  • Resolution Tips:

    • Double-check the group ID and ensure it exists and is accessible with your credentials.
    • Confirm that the API credentials are correctly set up and not expired.
    • Use the "continue on fail" option to handle partial failures gracefully in batch operations.

Links and References

Discussion