Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups by interacting with the Zalo API. It supports various group-related operations such as creating groups, retrieving group information, managing members and deputies, changing group details, and posting notes within groups.

The specific operation "Thêm Phó Nhóm" (Add Group Deputy) allows you to add a user as a deputy (co-admin) of a specified Zalo group. This is useful for delegating administrative responsibilities within a group without transferring full ownership.

Practical example:
If you manage a large Zalo group and want to assign trusted members as deputies to help moderate or manage the group, you can use this node operation to add those users by their user IDs.


Properties

Name Meaning
ID Nhóm The unique identifier of the Zalo group where you want to add a deputy.
ID Người Dùng The unique identifier of the user who will be added as a deputy in the group.

Output

The output JSON contains:

  • status: A string indicating the result of the operation, typically "Thành công" meaning "Success".
  • response: The raw response from the Zalo API after attempting to add the deputy user.

Example output structure:

{
  "status": "Thành công",
  "response": { /* API response object */ }
}

No binary data output is produced by this operation.


Dependencies

  • Requires valid Zalo API credentials including an API key credential that provides cookie, IMEI, and user agent information.
  • The node uses the external zca-js library to interact with the Zalo API.
  • Proper configuration of the Zalo API credential in n8n is necessary for authentication.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Incorrect group ID or user ID values will result in errors from the Zalo API.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with the provided credentials. Verify your API key and credential setup.
    • Errors returned from the Zalo API (e.g., user not found, insufficient permissions) will be passed through. Check the error message for details.
  • Resolution tips:

    • Double-check the group and user IDs are correct and exist.
    • Ensure the API credentials are up-to-date and have the required permissions.
    • Use the "Continue on Fail" option if you want the workflow to proceed despite individual item errors.

Links and References

Discussion