ZaloLoginByQr Node - Tự động hóa đăng nhập Zalo trong n8n

Tổng quan

ZaloLoginByQr là node đặc biệt nhất trong bộ n8n-nodes-zalo-nnt. Nó giải quyết bài toán khó khăn nhất khi làm việc với Zalo không chính chủ: Xác thực (Authentication).

Thay vì phải F12 lấy cookie thủ công (vừa khó, vừa nhanh hết hạn), node này tạo ra một quy trình đăng nhập chuẩn như Zalo Web: Hiện QR Code -> Scan -> Tự động lấy Cookie -> Lưu Credential.

Use Cases chính

• 🔐 Đăng nhập lần đầu dễ dàng
• 🔄 Re-login khi cookie hết hạn
• 🤖 Tự động hóa quy trình cấp lại quyền truy cập
• 🏢 Quản lý nhiều tài khoản Zalo trên cùng một n8n instance

---

Operations

Node chỉ có 1 operation duy nhất nhưng rất mạnh mẽ:

Operation	Mô tả
Get QR Code	Tạo QR code và lắng nghe trạng thái đăng nhập

---

Configuration

Parameters

Parameter	Type	Bắt buộc	Mô tả
Credential	Credential	✅	Chọn n8n API for Zalo API (để node có quyền tạo credential mới)
Credential Name	String	✅	Tên credential sẽ được tạo/update (VD: Zalo Account 1)
Proxy	String	❌	URL Proxy nếu cần (http/socks5)

Yêu cầu tiên quyết

Để node này hoạt động, bạn cần cấu hình n8n API for Zalo API trước. Xem chi tiết tại bài viết Xác thực và đăng nhập Zalo↗.

---

Quy trình hoạt động

1. Execute Node: Khi bạn chạy node, nó sẽ gọi API Zalo để lấy QR Code.
2. Output QR: Node trả về hình ảnh QR Code (base64/url) trong output panel.
3. Wait: Node chuyển sang trạng thái chờ (Waiting) - tương tự như node Wait.
4. Scan: Bạn dùng điện thoại scan QR code và xác nhận đăng nhập.
5. Authen Success: Zalo server báo về node là đăng nhập thành công.
6. Create Credential: Node tự động lấy cookie, IMEI, User Agent... và tạo/update credential trong n8n.
7. Finish: Workflow tiếp tục chạy (nếu có các node sau).

---

Automation Workflow

Bạn có thể xây dựng một workflow tự động gửi QR code qua email/telegram khi cookie hết hạn:

Workflow: Auto Re-login Request

1. Trigger: Error Trigger (khi workflow chính lỗi "Invalid Cookie")
2. ZaloLoginByQr: Tạo QR Code mới
3. HTTP Request: Gửi ảnh QR Code qua Telegram/Slack cho Admin
4. Admin: Mở Telegram, scan QR code
5. ZaloLoginByQr: Nhận tín hiệu thành công -> Update credential
6. Retry: Chạy lại workflow chính

--> Kết quả: Hệ thống tự phục hồi (Self-healing) mà không cần can thiệp kỹ thuật sâu.

---

Troubleshooting

❌ Node bị timeout

Nguyên nhân: QR code chỉ có hiệu lực trong khoảng 1-2 phút. Nếu không scan kịp, node sẽ timeout.

Giải pháp:

• Tăng Execution Timeout trong Settings của workflow nếu cần.
• Scan nhanh hơn ngay khi thấy QR.

❌ Lỗi: "Cannot create credential"

Nguyên nhân:

• n8n API Key sai hoặc không có quyền.
• Credential Name trùng với một credential loại khác.

Giải pháp:

• Kiểm tra lại credential n8n API for Zalo API.
• Đảm bảo tên credential là duy nhất.

❌ Proxy không hoạt động

Nguyên nhân: Format proxy sai hoặc proxy chết.

Giải pháp:

• Check format: http://user:pass@host:port
• Test proxy bằng curl trước.

---

Tips & Best Practices

---

Bước tiếp theo

Bạn đã đi qua tất cả các nodes quan trọng trong bộ n8n-nodes-zalo-nnt. Để áp dụng kiến thức vào thực tế, hãy xem các bài viết về Use Cases & Workflow Templates trong phần tiếp theo của series.