Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions9

Overview

This node manages Zalo groups by interacting with the Zalo API. Specifically, the "Add User to Group" operation allows users to add one or multiple members to an existing Zalo group. This is useful for automating group management tasks such as onboarding new members into team chats, community groups, or project channels on Zalo.

Practical examples include:

  • Automatically adding new employees to a company’s internal Zalo group.
  • Adding event participants to a dedicated Zalo group after registration.
  • Managing membership of social or interest-based groups programmatically.

Properties

Name Meaning
ID Nhóm (groupId) The unique identifier of the Zalo group where members will be added.
Danh Sách ID Thành Viên (userIds) A comma-separated list of user IDs representing the members to add to the group.

Output

The output JSON contains the response from the Zalo API after attempting to add the specified users to the group. It typically includes details about the success or failure of the operation and any relevant metadata returned by the API.

Example structure:

{
  // API response data confirming added users or error details
}

No binary data output is produced by this operation.

Dependencies

  • Requires valid Zalo API credentials including authentication tokens such as cookies, device IMEI, and user agent strings.
  • The node depends on the external zca-js library to interact with the Zalo API.
  • Proper configuration of the Zalo API credential in n8n is necessary before using this node.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Incorrect group ID or user IDs can lead to errors or no changes in group membership.
    • Network or API rate limits might cause request failures.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Verify that the API key/credentials are correctly set up.
    • Errors related to invalid parameters usually indicate wrong or missing group/user IDs. Double-check input values.
    • If the node fails but "Continue On Fail" is enabled, it returns an error object in the output JSON for that item.

Links and References

Discussion