Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

The Zalo Group node for n8n allows users to manage Zalo chat groups programmatically. Specifically, the Tạo Nhóm (Create Group) operation enables you to create a new group on Zalo and add multiple members at once by specifying their user IDs. This is useful for automating group creation for teams, events, or customer engagement scenarios where you need to quickly set up communication channels.

Example use cases:

  • Automatically creating project groups for new clients or teams.
  • Setting up event-specific chat groups and inviting participants in bulk.
  • Onboarding new employees into company chat groups.

Properties

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

Output

The output json field contains the response from the Zalo API after attempting to create the group. The structure typically includes details about the newly created group, such as its ID, name, and possibly the status of member additions.

Example output:

{
  "group_id": "123456789",
  "name": "Tên Nhóm",
  "members": ["user1", "user2", "user3"],
  // ...other group details as returned by the Zalo API
}

Note: The exact fields depend on the Zalo API's response.

Dependencies

  • External Service: Requires access to the Zalo platform via the zca-js library.
  • Credentials: Needs valid Zalo credentials configured in n8n (zaloApi), including:
    • Cookie
    • IMEI
    • User Agent

These should be set up in n8n's credential management.

Troubleshooting

Common issues:

  • Invalid Credentials: If the provided cookie, IMEI, or user agent are incorrect or expired, the node will throw an error:
    "No API instance found. Please make sure to provide valid credentials."
    Solution: Update your Zalo credentials in n8n.

  • Malformed User IDs: If the Danh Sách ID Thành Viên property is not a properly formatted comma-separated string, some users may not be added.
    Solution: Ensure all user IDs are separated by commas with no extra spaces.

  • API Limitations or Errors: If Zalo API returns an error (e.g., rate limits, invalid group name), the error message will appear in the output if "Continue On Fail" is enabled, or as a node error otherwise.

Links and References

For more information on Zalo group management, refer to Zalo's official documentation or support resources.

Discussion