Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups by interacting with the Zalo API. It allows users to create new groups, retrieve group information, add or remove members, change group names or avatars, and list all groups. This is useful for automating group management tasks in Zalo, such as setting up new discussion groups with specific members or updating group details programmatically.

A practical example is creating a new Zalo group with a given name and a list of member IDs, which can be used to quickly organize team chats or customer support groups without manual setup in the Zalo app.

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) A comma-separated list of member IDs to be added to the group upon creation.

Output

The output JSON structure after creating a group contains the response from the Zalo API's createGroup method. This typically includes details about the newly created group such as its ID, name, and member list.

Example output JSON snippet:

{
  "id": "123456789",
  "name": "My New Group",
  "members": ["userId1", "userId2", "userId3"]
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential to authenticate with the Zalo API.
  • Uses the zca-js library internally to interact with Zalo services.
  • The node expects valid credentials including cookie, IMEI, and user agent strings either from the credential or input data.
  • Proper configuration of the Zalo API credential in n8n is necessary.

Troubleshooting

  • Invalid Credentials: If the node throws "No API instance found," it means the provided credentials are invalid or incomplete. Ensure that the API key credential includes valid cookie, IMEI, and user agent values.
  • Malformed User IDs: The user IDs must be provided as a comma-separated string without extra spaces or invalid characters. Incorrect formatting may cause API errors.
  • API Rate Limits or Permissions: If the Zalo API rejects requests due to rate limits or insufficient permissions, verify your account's API access rights.
  • Continue on Fail: If enabled, the node will continue processing other items even if one fails, returning error messages in the output JSON under the error field.

Links and References

Discussion