Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions9

Overview

This node operation allows you to add one or more users to a specified group in the Zalo platform. It is useful for automating group management tasks such as onboarding new members into existing groups without manual intervention.

Common scenarios:

  • Automatically adding multiple users to a group after they register or meet certain criteria.
  • Managing group membership dynamically based on external triggers or workflows.
  • Bulk adding users to a group by providing a comma-separated list of user IDs.

Practical example:
You have a marketing campaign where new leads are collected and need to be added to a specific Zalo group for communication. This node can take the list of lead user IDs and add them all at once to the target group.

Properties

Name Meaning
ID Nhóm (groupId) The unique identifier of the group to which users will be added.
Danh Sách ID Thành Viên (userIds) A comma-separated string 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 status information indicating success or failure, and may contain details about the updated group membership.

Example structure:

{
  "status": "Thành công",
  "response": {
    // API response details about the addition operation
  }
}

No binary data output is produced by this node operation.

Dependencies

  • Requires an active connection to the Zalo platform via an API authentication token (credential).
  • The node internally uses a Zalo API client instantiated with cookie, IMEI, and user agent parameters retrieved from credentials or previous node executions.
  • Proper configuration of the API credential in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials leading to authentication failures.
    • Incorrect group ID or user IDs causing the API to reject the request.
    • Network connectivity problems preventing communication with the Zalo API.

  • Error messages:

    • Authentication errors: Ensure your API key or token is valid and has not expired.
    • "Cannot find group" or similar: Verify that the group ID exists and is accessible by the authenticated user.
    • "Invalid user IDs": Check that the user IDs are correctly formatted and separated by commas.
    • If the node is set to continue on fail, errors for individual items will appear in the output JSON under an error field.

Links and References

Discussion