ZaloUser Node - Quản lý thông tin người dùng Zalo trong n8n

Tổng quan

ZaloUser là node quản lý thông tin người dùng toàn diện với 24 operations, cho phép bạn tương tác với hồ sơ cá nhân, danh sách bạn bè, lời mời kết bạn và quản lý alias (tên gợi nhớ).

Use Cases chính

• 👤 Lấy thông tin chi tiết người dùng
• 🤝 Quản lý danh sách bạn bè (thêm, xóa, chặn)
• 📩 Tự động chấp nhận/từ chối lời mời kết bạn
• 🏷️ Đặt tên gợi nhớ (alias) để dễ quản lý
• ⚙️ Cài đặt quyền riêng tư

---

Resources & Operations

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

Resource	Operations	Mô tả
Thông tin	3	Lấy profile, UID, avatar
Bạn bè	6	Lấy danh sách, hủy kết bạn, chặn/bỏ chặn
Lời mời	4	Gửi, thu hồi, chấp nhận, từ chối
Alias	3	Đặt, xóa tên gợi nhớ
Cài đặt	8	Quyền riêng tư, nhật ký, thông báo

Tổng cộng: 24 operations

---

Resource: Thông tin User

1. Lấy Thông Tin

Lấy thông tin chi tiết của một người dùng Zalo.

Parameters:

Parameter	Type	Mô tả
User ID	String	ID người dùng cần lấy thông tin

Output:

{
  "userId": "123456789",
  "displayName": "Nguyễn Văn A",
  "avatar": "https://s120.avatar.talk.zdn.vn/...",
  "gender": 1, // 1: Nam, 0: Nữ
  "dob": "1990-01-01",
  "phone": "0912xxx", // Chỉ hiện nếu user public
  "alias": "Khách hàng VIP"
}

2. Tìm User ID từ Phone

Tìm Zalo User ID từ số điện thoại (nếu số đó đăng ký Zalo và cho phép tìm kiếm).

Parameters:

Parameter	Type	Mô tả
Phone Number	String	Số điện thoại (format: 849xxx or 09xxx)

Example:

{
  "phone": "0912345678"
}

---

Resource: Bạn bè

1. Lấy Danh Sách Bạn Bè

Lấy danh sách tất cả bạn bè hiện tại.

Parameters:

Parameter	Type	Default	Mô tả
Limit	Number	50	Số lượng tối đa
Offset	Number	0	Vị trí bắt đầu

Use case: Sync danh sách bạn bè vào CRM.

2. Hủy Kết Bạn

Xóa một người khỏi danh sách bạn bè.

Parameters:

Parameter	Type	Mô tả
User ID	String	ID người cần hủy kết bạn

3. Chặn/Bỏ Chặn

Chặn tin nhắn hoặc nhật ký của người dùng.

Parameters:

Parameter	Type	Mô tả
User ID	String	ID người dùng
Loại Chặn	Dropdown	Tin nhắn / Nhật ký / Cả hai
Hành Động	Dropdown	Chặn / Bỏ chặn

---

Resource: Lời mời kết bạn

1. Gửi Lời Mời

Gửi lời mời kết bạn kèm tin nhắn chào mừng.

Parameters:

Parameter	Type	Mô tả
User ID	String	ID người muốn kết bạn
Message	String	Tin nhắn chào (Optional)

Example:

{
  "userId": "987654321",
  "message": "Chào bạn, mình là Support từ Diginno!"
}

2. Lấy Danh Sách Lời Mời

Lấy danh sách các lời mời kết bạn đã nhận.

Output:

{
  "requests": [
    {
      "userId": "123...",
      "displayName": "User B",
      "message": "Kết bạn nhé!",
      "time": 1704067200000
    }
  ]
}

3. Chấp Nhận/Từ Chối

Xử lý lời mời kết bạn.

Parameters:

Parameter	Type	Mô tả
User ID	String	ID người gửi lời mời
Hành Động	Dropdown	Chấp nhận / Từ chối

---

Resource: Alias (Tên gợi nhớ)

Đặt tên gợi nhớ cho người dùng để dễ quản lý (chỉ mình bạn thấy).

1. Đặt Alias

Example:

{
  "userId": "123456789",
  "alias": "KH VIP - Anh Nam"
}

2. Xóa Alias

Xóa tên gợi nhớ, quay về tên hiển thị gốc của người dùng.

---

Common Use Cases

1. Auto-accept Friend Requests

Tự động chấp nhận kết bạn dựa trên tin nhắn chào:

Trigger: Schedule (15 mins)
→ ZaloUser: Lấy danh sách lời mời
→ Filter: Message contains "khách hàng" or "mua hàng"
→ ZaloUser: Chấp nhận kết bạn
→ ZaloSendMessage: Gửi tin nhắn chào mừng

2. CRM Enrichment

Cập nhật thông tin khách hàng vào CRM:

Trigger: New Lead in CRM (Phone number)
→ ZaloUser: Tìm ID từ Phone
→ ZaloUser: Lấy thông tin chi tiết (Avatar, Gender, DOB)
→ Update CRM: Lưu Zalo ID và thông tin bổ sung

3. Friend List Backup

Backup danh sách bạn bè định kỳ:

Trigger: Monthly Schedule
→ ZaloUser: Lấy tất cả bạn bè
→ Google Sheets: Xóa sheet cũ
→ Google Sheets: Thêm danh sách mới

---

Troubleshooting

❌ Lỗi: "User not found"

Nguyên nhân:

• User ID sai
• Người dùng đã xóa tài khoản
• Người dùng chặn tìm kiếm

Giải pháp:

• Kiểm tra lại ID
• Thử tìm bằng số điện thoại khác

❌ Lỗi: "Cannot send friend request"

Nguyên nhân:

• Đã là bạn bè
• Đã gửi lời mời trước đó
• Người dùng chặn nhận lời mời từ người lạ
• Danh sách bạn bè đầy (limit 2000-3000)

Giải pháp:

• Kiểm tra trạng thái bạn bè trước khi gửi
• Dọn dẹp danh sách bạn bè nếu đầy

---

Tips & Best Practices

---

Bước tiếp theo

Trong bài tiếp theo, chúng ta sẽ tìm hiểu về ZaloMessageTrigger Node - node quan trọng để lắng nghe các sự kiện real-time như tin nhắn mới, cảm xúc, và tương tác nhóm.