Zalo Group icon

Zalo Group

Quản lý nhóm Zalo
Join our community

Actions10

Overview

This node manages Zalo groups by interacting with the Zalo API. It allows users to create new groups, retrieve group information, manage members, update group details, and post notes within groups. This is useful for automating group management tasks on Zalo, such as setting up new discussion groups, adding or removing members, changing group names or avatars, and posting pinned notes.

A practical example: Automatically creating a new Zalo group with specified members when onboarding a new project team, or periodically fetching group member lists for reporting purposes.

Properties

Name Meaning
Tên Nhóm (groupName) The name of the new group to be created.
Danh Sách ID Thành Viên (nếu nhiều người dùng vui lòng phân cách bằng dấu phẩy) (userIds) A comma-separated list of user IDs to be added as members of the group.

Output

The output JSON structure depends on the operation but for the "Tạo Nhóm" (createGroup) operation specifically:

  • json: Contains the response from the Zalo API after creating the group.
    • Typically includes details about the newly created group such as its ID, name, and member list.

For other operations (not requested here), outputs may include group info, member profiles, status messages, or error details.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential to authenticate with the Zalo API.
  • Uses the zca-js library internally to interact with Zalo services.
  • Requires valid credentials including cookie, IMEI, and user agent strings for authentication.
  • Must be configured with proper Zalo API credentials in n8n.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials causing authentication failures.
    • Incorrectly formatted user ID lists (should be comma-separated).
    • Network or API rate limiting errors from Zalo.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo. Check that the API key credential is correctly set and valid.
    • Errors during execution will be reported per item; if "Continue On Fail" is enabled, errors will appear in the output JSON under error.

  • Resolutions:

    • Verify and refresh API credentials.
    • Ensure user IDs are properly formatted without extra spaces.
    • Handle API limits by adding delays or retries.

Links and References

Discussion