Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions16

Overview

This node manages Zalo groups, allowing users to perform various group-related operations via the Zalo API. Specifically, for the "Tạo Nhóm" (Create Group) operation under the "Group" resource, it enables creating a new Zalo group with a specified name and initial members.

Common scenarios where this node is beneficial include:

  • Automating the creation of Zalo groups for team collaboration or event planning.
  • Programmatically managing group membership by adding multiple users at creation.
  • Integrating Zalo group management into broader workflows, such as onboarding processes or community management.

Practical example:

  • Automatically create a Zalo group named "Project Team Alpha" and add user IDs "12345,67890,11223" as initial members when a new project starts.

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 member IDs to be added to the group upon creation.

Output

The output JSON contains the response from the Zalo API after creating the group. It typically includes details about the newly created group such as its ID, name, members, and other metadata returned by the API.

Example output structure (simplified):

{
  "id": "string",          // The unique identifier of the created group
  "name": "string",        // The name of the group
  "members": ["string"],   // Array of member IDs in the group
  // ... other group details as provided by the API
}

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

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Incorrectly formatted user IDs (e.g., missing commas or extra spaces) 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."
      Resolution: Verify that the API credentials are correctly set up and not expired.
    • Errors related to invalid parameters (e.g., empty group name or user IDs)
      Resolution: Ensure all required fields are filled correctly and user IDs are comma-separated without trailing commas.
    • If the node throws errors about processing options or parameters, check the input formatting carefully.

Links and References

Discussion