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 participants to a project or event group dynamically based on external triggers.
  • Integrating Zalo group updates into broader workflows such as CRM or customer support systems.

Example: Automatically add newly registered users to a specific Zalo group for onboarding announcements.

Properties

Name Meaning
ID Nhóm 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) 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. This 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 credential that provides cookie, IMEI, and user agent information.
  • The node uses the zca-js library to interact with the Zalo API.
  • Proper configuration of the Zalo API credential in n8n is necessary for authentication.

Troubleshooting

  • Invalid Credentials: If the node throws an error about missing or invalid API instance, verify that the Zalo API credentials are correctly configured and contain valid cookie, IMEI, and user agent values.
  • User IDs Format: Ensure the user IDs are provided as a comma-separated string without extra spaces or invalid characters.
  • Group ID Validity: Confirm that the group ID exists and the authenticated user has permission to modify the group.
  • API Rate Limits or Restrictions: The Zalo API may impose limits; if requests fail repeatedly, check for rate limiting or permission issues.
  • Error Messages: Errors thrown by the node will include messages from the underlying API call. Use these messages to diagnose issues such as invalid parameters or network problems.

Links and References

Discussion