Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups by interacting with the Zalo API. Specifically, the "Thêm Thành Viên Vào Nhóm" (Add User to Group) operation allows users to add one or multiple members to an existing Zalo group by specifying the group ID and user IDs.

Common scenarios where this node is useful include:

  • Automating group membership management in Zalo for community or team chats.
  • Adding new users to a group after registration or onboarding processes.
  • Bulk adding multiple users to a group efficiently via automation workflows.

Example: Automatically add newly registered users to a specific Zalo group by passing their user IDs as a comma-separated list along with the target group ID.

Properties

Name Meaning
ID Nhóm (groupId) The unique identifier of the Zalo group to which users will be added.
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 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 output structure:

{
  // API response object indicating the result of adding users to the group
}

No binary data output is produced by this operation.

Dependencies

  • Requires valid Zalo API credentials including an API key/token, cookie, IMEI, and user agent string.
  • The node uses the zca-js library to interact with the Zalo API.
  • Credentials must be configured properly in n8n to authenticate API requests.

Troubleshooting

  • Invalid Credentials: If the node throws an error about missing or invalid API instance, verify that the Zalo API credentials are correctly set up and have not expired.
  • Incorrect Group ID or User IDs: Ensure the group ID exists and the user IDs are valid and formatted as a comma-separated string without extra spaces.
  • API Rate Limits or Permissions: The Zalo API may restrict how many users can be added at once or require certain permissions; check API documentation and adjust accordingly.
  • Error Handling: 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