Zalo Group icon

Zalo Group

Quản lý nhóm Zalo
Join our community

Actions10

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:

{
  "json": {
    // API response object indicating result of adding users to the group
  },
  "pairedItem": {
    "item": 0
  }
}

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.
  • Malformed User IDs: Ensure the user IDs are provided as a comma-separated string without extra spaces or invalid characters.
  • Group Not Found: If the group ID does not exist or the authenticated user lacks permission, the API may return an error.
  • API Rate Limits: Frequent calls might hit rate limits; consider adding delays or batching requests.
  • Error Handling: If "Continue On Fail" is enabled, errors for individual items will be returned in the output JSON under an error field instead of stopping execution.

Links and References

Discussion