Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions10

Overview

This node manages Zalo groups by interacting with the Zalo API. It allows users to create new groups, retrieve group information, manage group members, update group details, and create notes within groups. This is useful for automating group management tasks on Zalo, such as setting up new groups with specific members, updating group names or avatars, and handling membership changes programmatically.

A practical example: Automatically creating a new Zalo group with a list of user IDs when onboarding a project team, or fetching detailed member info from an existing group to sync with another system.

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) 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:

  • Returns the response from the Zalo API after creating the group.
  • The JSON contains details about the newly created group, including its ID and member list.

In general, outputs are paired with the input item index and contain either the API response or error messages if the operation fails.

No binary data output is produced by this node.

Dependencies

  • Requires valid Zalo API credentials including cookie, IMEI, and user agent information.
  • The node uses an external Zalo API client library (zca-js) to perform API calls.
  • Credentials must be configured in n8n with appropriate authentication tokens to access the Zalo API.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials will cause login failure and prevent any API calls.
    • Incorrectly formatted user ID lists (e.g., missing commas) may cause errors when creating groups.
    • Network or API rate limits could result in request failures.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials." — indicates missing or invalid credentials; verify and re-enter your API authentication details.
    • Errors returned from the Zalo API (e.g., invalid parameters) will be passed through; check that all required fields are correctly filled and formatted.

  • To handle errors gracefully, enable the "Continue On Fail" option in the node settings to process subsequent items even if one fails.

Links and References

Discussion