Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions10

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 creating 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 group management responsibilities without transferring full ownership.

Practical example:
If you run a community or team chat on Zalo and want to assign trusted members as deputies to help moderate or manage the group, this operation lets you programmatically add those deputies by specifying their user IDs and the target group ID.

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 specified 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 to authenticate requests.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Incorrect group ID or user ID can lead to errors or no effect.
    • Network connectivity problems can prevent API calls from succeeding.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Check your credentials and ensure they are correctly set up.
    • Errors returned from the Zalo API (e.g., user not found, insufficient permissions) will be thrown and can be caught if "Continue On Fail" is enabled.

  • Resolution tips:

    • Verify the correctness of group and user IDs.
    • Refresh or re-enter API credentials if authentication fails.
    • Enable "Continue On Fail" to handle individual item errors gracefully during batch processing.

Links and References

Discussion