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, manage group members and deputies, change group details like name and avatar, and create notes within groups.

A common use case is automating group management tasks in Zalo for businesses or communities that use Zalo as a communication platform. For example, you can automatically create a group with specified members when onboarding a new project team, or update group information dynamically based on external triggers.

Specifically, the "Tạo Nhóm" (Create Group) operation creates a new Zalo group with a given name and a list of member user IDs.

Properties

Name Meaning
Tên Nhóm 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) A comma-separated list of user IDs to be added as members of the new group.

Output

The output JSON contains the response from the Zalo API after creating the group. This typically includes details about the newly created group such as its ID, name, members, and other metadata returned by the API.

Example output structure:

{
  "groupId": "string",
  "name": "string",
  "members": ["userId1", "userId2", "..."],
  // other group-related fields depending on API response
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential to authenticate with the Zalo API.
  • The node uses stored credentials including cookie, IMEI, and user agent strings to establish a session with Zalo.
  • The zca-js library is used internally to interact with the Zalo API.

Troubleshooting

  • Invalid Credentials: If the provided API credentials (cookie, IMEI, user agent) are invalid or expired, the node will fail to create a session and throw an error indicating no API instance was found. Ensure credentials are up-to-date and valid.
  • 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: The Zalo API might restrict group creation frequency or require specific permissions. Check your API quota and permissions if requests fail.
  • Error Handling: If the node is set to continue on failure, errors for individual items will be included in the output JSON under an error field.

Links and References

Discussion