ZaloGroup Node - Quản lý nhóm Zalo toàn diện trong n8n

Tổng quan

ZaloGroup là node mạnh mẽ nhất để quản lý nhóm Zalo, cung cấp 17 operations được tổ chức thành 5 resources chính.

Use Cases chính

• 👥 Tạo và quản lý nhóm tự động
• ➕ Thêm/xóa thành viên hàng loạt
• 🛡️ Kiểm duyệt và chặn thành viên
• ⚙️ Cài đặt nhóm (tên, avatar, ghi chú)
• 📊 Lấy thông tin nhóm để phân tích

---

Resources & Operations

Node được tổ chức theo 5 resources chính:

Resource	Operations	Mô tả
Nhóm	5	Tạo, lấy thông tin, tham gia, rời nhóm
Thành viên	4	Thêm, xóa, mời, thăng admin
Cài đặt	2	Đổi tên, đổi avatar
Kiểm duyệt	4	Chặn, bỏ chặn, duyệt yêu cầu
Nội dung	1	Tạo ghi chú ghim

Tổng cộng: 17 operations

---

Resource: Nhóm

Quản lý các thao tác liên quan đến nhóm.

1. Tạo Nhóm

Tạo một nhóm mới trên Zalo.

Parameters:

Parameter	Type	Bắt buộc	Mô tả
Tên Nhóm	String	✅	Tên của nhóm mới
Danh Sách ID Thành Viên	String	✅	IDs thành viên, phân cách bằng dấu phẩy

Example:

{
  "tenNhom": "Nhóm Công Việc 2024",
  "danhSachId": "123456789,987654321,555666777"
}

Output:

{
  "response": {
    "groupId": "2449429775282621194",
    "name": "Nhóm Công Việc 2024",
    "totalMember": 4,
    "createdTime": 1759567583350
  }
}

---

2. Lấy Thông Tin

Lấy thông tin chi tiết của một nhóm.

Parameters:

Parameter	Type	Mô tả
ID Nhóm	String	ID của nhóm cần lấy thông tin

Output:

{
  "groupInfo": {
    "groupId": "2449429775282621194",
    "name": "Test zalo",
    "totalMember": 4,
    "maxMember": 1000,
    "creatorId": "4379936484220100668",
    "createdTime": 1759567583350,
    "avatar": "https://...",
    "settings": {
      "joinApproval": true,
      "lockCreatePost": false
    }
  }
}

---

3. Lấy Nhiều Nhóm

Lấy danh sách tất cả các nhóm với thông tin chi tiết.

Parameters:

Parameter	Type	Default	Mô tả
Giới Hạn	Number	50	Số lượng nhóm tối đa

Use case: Export danh sách nhóm để phân tích, backup

---

4. Tham Gia Nhóm

Tham gia nhóm bằng link mời.

Parameters:

Parameter	Type	Mô tả
Link Mời Nhóm	String	Link mời để tham gia nhóm

Example:

{
  "inviteLink": "https://zalo.me/g/abc123"
}

---

5. Rời Nhóm

Rời khỏi một nhóm.

Parameters:

Parameter	Type	Default	Mô tả
ID Nhóm	String	-	ID của nhóm cần rời
Rời Lặng Lẽ	Boolean	false	Rời mà không thông báo

---

Resource: Thành Viên

Quản lý thành viên trong nhóm.

1. Thêm Thành Viên

Thêm một hoặc nhiều thành viên vào nhóm.

Example:

{
  "groupId": "123456789",
  "memberIds": "111222333,444555666,777888999"
}

Use case: Thêm danh sách khách hàng VIP vào nhóm support

---

2. Xóa Thành Viên

Xóa một hoặc nhiều thành viên khỏi nhóm.

⚠️ Yêu cầu quyền: Phó Nhóm hoặc Trưởng Nhóm

Use case: Xóa thành viên vi phạm quy định nhóm

---

3. Mời Vào Nhiều Nhóm

Mời một người dùng vào nhiều nhóm cùng lúc.

Example:

{
  "userId": "123456789",
  "groupIds": "group1,group2,group3"
}

Use case: Thêm nhân viên mới vào tất cả nhóm dự án

---

4. Thêm Phó Nhóm

Thêm một người dùng làm phó nhóm (admin).

⚠️ Yêu cầu quyền: Trưởng Nhóm

---

Resource: Cài Đặt

Quản lý cài đặt nhóm.

1. Đổi Tên Nhóm

⚠️ Yêu cầu quyền: Phó Nhóm hoặc Trưởng Nhóm

Example:

{
  "groupId": "123456789",
  "newName": "Nhóm Marketing Q1 2024"
}

---

2. Đổi Avatar Nhóm

⚠️ Yêu cầu quyền: Phó Nhóm hoặc Trưởng Nhóm

Example:

{
  "groupId": "123456789",
  "avatarUrl": "https://example.com/new-avatar.jpg"
}

---

Resource: Kiểm Duyệt

Quản lý kiểm duyệt và chặn thành viên.

⚠️ Tất cả operations yêu cầu quyền: Phó Nhóm hoặc Trưởng Nhóm

1. Lấy DS Bị Chặn

Lấy danh sách thành viên bị chặn trong nhóm.

2. Chặn Thành Viên

Chặn một hoặc nhiều thành viên trong nhóm.

3. Bỏ Chặn Thành Viên

Bỏ chặn một hoặc nhiều thành viên.

4. Lấy Yêu Cầu Chờ Duyệt

Lấy danh sách yêu cầu tham gia nhóm chờ duyệt.

5. Duyệt Yêu Cầu

Phê duyệt hoặc từ chối yêu cầu tham gia nhóm.

Example (Approve):

{
  "groupId": "123456789",
  "memberIds": "pending_user_1,pending_user_2",
  "action": "approve"
}

Use case: Auto-approve dựa trên điều kiện (email domain, danh sách whitelist)

---

Resource: Nội Dung

Tạo Ghi Chú

Tạo ghi chú trong nhóm (có thể ghim).

Example:

{
  "groupId": "123456789",
  "content": "📌 Quy định nhóm:\n1. Không spam\n2. Không quảng cáo\n3. Tôn trọng thành viên khác",
  "pinNote": true
}

Use case: Tạo quy định nhóm tự động khi tạo nhóm mới

---

Common Use Cases

1. Auto Group Creation Workflow

Scenario: Tạo nhóm dự án tự động khi có deal mới

Trigger: CRM - New Deal
→ Get Team Members (Google Sheets)
→ Create Group (ZaloGroup)
→ Create Pinned Note (ZaloGroup)
→ Send Welcome Message (ZaloSendMessage)

---

2. Member Moderation Bot

Scenario: Tự động kiểm duyệt yêu cầu tham gia nhóm

Trigger: Schedule (every 5 minutes)
→ Lấy yêu cầu chờ duyệt
→ Check user trong whitelist (Google Sheets)
→ Approve nếu có trong whitelist
→ Reject nếu không

---

3. Group Analytics

Scenario: Export thông tin tất cả nhóm để phân tích

Trigger: Daily schedule
→ Get All Groups (ZaloGroup)
→ Save to Google Sheets
→ Send Report via Email

---

Troubleshooting

❌ Lỗi: "Không có quyền thực hiện thao tác"

Nguyên nhân: Tài khoản không phải Phó Nhóm hoặc Trưởng Nhóm

Giải pháp:

1. Kiểm tra quyền trong nhóm
2. Yêu cầu Trưởng Nhóm thăng quyền
3. Sử dụng tài khoản có quyền admin

---

❌ Không thể thêm thành viên

Nguyên nhân:

• ID người dùng không hợp lệ
• Người dùng đã chặn bot
• Nhóm đã đạt giới hạn thành viên

Giải pháp:

• Verify User ID với ZaloUser node
• Check maxMember trong group info
• Đảm bảo người dùng chưa chặn tài khoản bot

---

❌ Lỗi: "ID nhóm không hợp lệ"

Nguyên nhân: Group ID sai hoặc bot chưa tham gia nhóm

Giải pháp:

1. Lấy đúng Group ID từ "Lấy Nhiều Nhóm"
2. Đảm bảo bot đã tham gia nhóm
3. Check format ID (phải là string)

---

Rate Limiting

Zalo có giới hạn cho group operations:

Operation	Giới hạn	Khuyến nghị
Tạo nhóm	~5/giờ	Delay 15 phút
Thêm thành viên	~20/phút	Delay 3s/request
Đổi settings	~10/phút	Delay 6s/request

Best practice: Thêm delay node giữa các operations

---

Advanced Configuration

Batch Add Members

Thêm nhiều members an toàn:

// Function node
const members = $json.memberList; // Array of IDs
const batchSize = 5; // Thêm 5 người mỗi lần

for (let i = 0; i < members.length; i += batchSize) {
  const batch = members.slice(i, i + batchSize);

  // Add batch
  await addMembers(batch);

  // Delay 5 giây
  await new Promise(resolve => setTimeout(resolve, 5000));
}

---

Auto-promote Active Members

Tự động thăng Phó Nhóm cho thành viên tích cực:

Workflow logic:
1. Lấy thống kê tin nhắn (ZaloChatHistory)
2. Tìm top 3 active members
3. Thêm làm Phó Nhóm (ZaloGroup)

---

Tips & Best Practices

---

Bước tiếp theo

Trong bài tiếp theo, chúng ta sẽ tìm hiểu về ZaloChatHistory Node - node lấy lịch sử chat với auto-pagination và time filtering.