Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups by interacting with the Zalo API. It allows users to create new groups, retrieve group information, manage members and deputies, update group details like name and avatar, and handle group notes. This is useful for automating group management tasks in Zalo, such as setting up new groups with specific members, updating group settings, or extracting member lists for further processing.

A practical example: Automatically creating a new Zalo group with a predefined list of user IDs when onboarding a new project team, saving manual setup time.

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 new group.

Output

The output JSON contains the response from the Zalo API after attempting to create a group. Typically, it includes details about the newly created group such as its ID, name, and member list.

Example output structure:

{
  "id": "string",          // The unique identifier of the created group
  "name": "string",        // The name of the group
  "members": ["string"]    // Array of user IDs who are members of the group
}

No binary data output is produced by this operation.

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 values is necessary for successful API calls.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Incorrectly formatted user ID lists (e.g., missing commas) can lead to errors when adding members.
    • Network connectivity problems might prevent communication with the Zalo API.
  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not establish a connection to Zalo due to missing or invalid credentials. Verify that the API key and related authentication details are correctly set.
    • Errors related to user IDs or group names usually indicate invalid input parameters; ensure all required fields are provided and properly formatted.

Links and References

Discussion