ZaloTag Node - Quản lý phân loại bạn bè và tin nhắn Zalo trong n8n

Tổng quan

ZaloTag (hay còn gọi là Labels) là tính năng giúp bạn phân loại bạn bè và tin nhắn để dễ dàng quản lý. ZaloTag Node trong n8n cho phép bạn tự động hóa việc này, biến Zalo thành một mini-CRM ngay trong workflow của bạn.

Use Cases chính

• 🏷️ Phân loại khách hàng (VIP, Mới, Tiềm năng)
• 📂 Quản lý trạng thái đơn hàng (Đã chốt, Chờ thanh toán)
• 🔍 Lọc tin nhắn theo chủ đề
• 🤖 Tự động gán tag khi khách hàng tương tác
• 📊 Thống kê số lượng khách hàng theo tag

---

Operations

Node hỗ trợ 2 nhóm operations chính:

Resource	Operations	Mô tả
Tag	Tạo, Xóa, Lấy DS	Quản lý danh sách các thẻ phân loại
Gán Tag	Gán, Gỡ	Gán thẻ cho người dùng hoặc tin nhắn

---

Resource: Tag (Quản lý thẻ)

1. Lấy Danh Sách Tag

Lấy tất cả các tags hiện có trên tài khoản.

Output:

{
  "tags": [
    {
      "id": "tag_1",
      "name": "Khách hàng VIP",
      "color": "#FF0000"
    },
    {
      "id": "tag_2",
      "name": "Chờ thanh toán",
      "color": "#00FF00"
    }
  ]
}

2. Tạo Tag Mới

Tạo một label mới để phân loại.

Parameters:

Parameter	Type	Bắt buộc	Mô tả
Tên Tag	String	✅	Tên hiển thị của tag
Màu Sắc	Color	❌	Màu của tag (Hex code)

Example:

{
  "name": "Lead Tháng 1",
  "color": "#3366FF"
}

3. Xóa Tag

Xóa một tag vĩnh viễn.

Parameters:

Parameter	Type	Mô tả
Tag ID	String	ID của tag cần xóa

---

Resource: Gán Tag (Phân loại)

1. Gán Tag cho User

Gán một hoặc nhiều tag cho một người dùng.

Parameters:

Parameter	Type	Mô tả
User ID	String	ID người dùng
Tag IDs	String[]	Danh sách ID tag cần gán

Example:

{
  "userId": "123456789",
  "tagIds": ["tag_vip", "tag_new"]
}

2. Gỡ Tag khỏi User

Xóa tag khỏi người dùng.

Parameters:

Parameter	Type	Mô tả
User ID	String	ID người dùng
Tag IDs	String[]	Danh sách ID tag cần gỡ

---

Common Use Cases

1. Auto-tagging New Leads

Tự động gán tag "Khách hàng mới" khi có người lạ nhắn tin:

Workflow:

1. Trigger: ZaloMessageTrigger (Incoming Message)
2. IF: Is Friend? = False
3. ZaloTag: Gán tag "New Lead"
4. ZaloSendMessage: Gửi tin nhắn chào mừng & xin thông tin

2. CRM Sync & Segmentation

Đồng bộ tag từ CRM sang Zalo:

Workflow:

1. Trigger: CRM Updated (Hubspot/Salesforce)
2. IF: Deal Stage = "Closed Won"
3. ZaloUser: Tìm Zalo ID từ số điện thoại
4. ZaloTag:
   • Gỡ tag "Tiềm năng"
   • Gán tag "Khách hàng VIP"

3. Campaign Targeting

Gửi tin nhắn theo tag (Broadcast):

Workflow:

1. Trigger: Manual / Schedule
2. ZaloUser: Lấy danh sách bạn bè
3. Filter: Lọc user có tag "Quan tâm Bất động sản"
4. ZaloSendMessage: Gửi thông tin dự án mới

---

Troubleshooting

❌ Lỗi: "Tag limit reached"

Nguyên nhân: Zalo giới hạn số lượng tag tối đa (thường khoảng 50-100 tags tùy loại tài khoản).

Giải pháp:

• Kiểm tra số lượng tag hiện có
• Xóa các tag không còn sử dụng
• Gộp các tag tương tự nhau

❌ Lỗi: "User not found"

Nguyên nhân: User ID sai hoặc người dùng đã chặn/xóa tài khoản.

Giải pháp:

• Verify User ID với ZaloUser node
• Đảm bảo người dùng vẫn active

---

Tips & Best Practices

---

Bước tiếp theo

Trong bài tiếp theo, chúng ta sẽ tìm hiểu về ZaloReminder Node - công cụ tạo và quản lý lịch hẹn, nhắc nhở thông minh ngay trong đoạn chat.