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 allows users to create new groups, retrieve group information, manage group members, update group details, and create notes within groups. This is useful for automating group management tasks on Zalo, such as setting up new discussion groups, adding or removing members, changing group names or avatars, and posting pinned notes.

A practical example: Automatically creating a new Zalo group with specified members when onboarding a new project team, or fetching all members of a group to synchronize with another system.

Properties

Name Meaning
Tên Nhóm (groupName) The name of the new group to be created.
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) Comma-separated list of member IDs to be added to the group upon creation.

Output

The output JSON structure depends on the operation but for the "Tạo Nhóm" (createGroup) operation specifically:

  • Returns an object representing the newly created group, including its details as provided by the Zalo API.
  • The output is paired with the input item index for traceability.

For other operations (not requested here), outputs may include group info, member lists, status messages, or error details.

No binary data output is involved in this operation.

Dependencies

  • Requires valid Zalo API credentials including cookie, IMEI, and user agent information.
  • Uses the zca-js library to interact with the Zalo API.
  • The node expects these credentials to be configured in n8n beforehand.
  • No additional environment variables are explicitly required beyond credential setup.

Troubleshooting

  • Invalid Credentials: If the node throws "No API instance found," it indicates invalid or missing Zalo API credentials. Ensure that the API key, cookie, IMEI, and user agent are correctly set.
  • Malformed User IDs: Providing an incorrectly formatted user ID list (e.g., missing commas) can cause errors. Make sure user IDs are comma-separated strings.
  • API Rate Limits or Permissions: Operations might fail if the authenticated user lacks permissions or hits rate limits on the Zalo API.
  • Network Issues: Connectivity problems can cause timeouts or failures; verify network access to Zalo services.
  • Use the "Continue On Fail" option to handle errors gracefully during batch processing.

Links and References

Discussion