n8n-nodes-zalo-integration

Node n8n này được thiết kế hoạt động hoàn toàn bên trong instance của bạn — không cần API bên thứ ba hoặc phụ thuộc ngoại vi nào.
✅ Dữ liệu của bạn luôn được giữ riêng tư và an toàn.

📱 Liên hệ hỗ trợ & phát triển

Người viết: Takayama
SĐT báo bug: 0898299020
Liên hệ để phát triển thêm tính năng

🔐 QR Code đăng nhập

Để sử dụng các node Zalo, bạn cần đăng nhập qua QR Code:

1. Sử dụng node "Zalo Login By QR"
2. Quét mã QR bằng ứng dụng Zalo trên điện thoại
3. Xác nhận đăng nhập trên điện thoại
4. Nhận thông tin đăng nhập và sử dụng các node khác

💡 Lưu ý: QR Code sẽ tự động được tạo khi bạn chạy node "Zalo Login By QR"

Node này mô phỏng trình duyệt để tương tác trực tiếp với Zalo Web, cho phép bạn tự động hóa liền mạch trong n8n.
Đây là dự án mã nguồn mở, khuyến khích cộng đồng đóng góp và phát triển thêm tính năng.

🚀 Hướng dẫn cài đặt

1. Cài qua Community Nodes (Khuyến nghị)

Áp dụng cho n8n v0.187+

1. Mở n8n Editor.
2. Vào Settings → Community Nodes.
3. Tìm kiếm: n8n-nodes-taz-ai.
4. Nhấn Install.
5. Reload lại trình soạn thảo.

2. Cài thủ công

cd YOUR_N8N_INSTALLATION_DIRECTORY
npm install n8n-nodes-zalo-cloudbot

📦 Các Node có sẵn

1. Zalo Login By QR

• Đăng nhập vào Zalo bằng mã QR.
• 🆕 Webhook Integration: Gửi thông báo real-time về các sự kiện đăng nhập đến endpoint webhook tùy chỉnh.
  • Hỗ trợ các sự kiện: QR generated, expired, scanned, declined, login success, connection events
  • Có thể tùy chỉnh URL và bật/tắt webhook

2. Zalo Group

Quản lý nhóm:

• createGroup – Tạo nhóm mới.
• getGroupInfo – Lấy thông tin nhóm.
• addGroupDeputy – Thêm phó nhóm.
• addUserToGroup – Thêm thành viên.
• changeGroupAvatar – Đổi avatar nhóm.
• changeGroupName – Đổi tên nhóm.
• getGroupMembers – Lấy danh sách thành viên.
• getAllGroups – Lấy tất cả nhóm.
• removeUserFromGroup – Xóa thành viên.

3. Zalo User

Quản lý người dùng & bạn bè:

• acceptFriendRequest – Chấp nhận lời mời kết bạn.
• sendFriendRequest – Gửi lời mời kết bạn.
• blockUser – Chặn người dùng.
• unblockUser – Bỏ chặn người dùng.
• changeAccountAvatar – Đổi ảnh đại diện.
• changeAccountSetting – Thay đổi cài đặt tài khoản.
• getUserInfo – Lấy thông tin người dùng.
• getAllFriends – Lấy danh sách bạn bè.
• findUser – Tìm kiếm qua số điện thoại.
• changeAliasName – Đổi tên gợi nhớ của bạn bè.
• undoMessage – Thu hồi tin nhắn.
• markMessageAsRead – Đánh dấu tin nhắn đã đọc.
• markMessageAsUnread – Đánh dấu tin nhắn chưa đọc.

4. Zalo Send Message

• Gửi tin nhắn văn bản tới người dùng hoặc nhóm.

Text Styles (UI Builder)

• Dễ dàng định dạng nội dung mà không cần nhập JSON.
• Hai chế độ cấu hình:
  • Entire Message: áp dụng style cho toàn bộ chuỗi Message.
  • Advanced Ranges: thêm nhiều đoạn start/len/st nâng cao.

Fields (Entire Message):

• Bold, Italic, Underline, Strike
• Color: Red, Orange, Yellow, Green
• Font Size: Small, Big (bỏ trống = mặc định)
• List: Unordered, Ordered
• Indent Size: số bậc thụt lề (0 = không dùng)

Fields (Advanced Ranges):

• Start, Length, Style (b, i, u, s, c_db342e, c_f27806, c_f7b503, c_15a85f, f_13, f_18, lst_1, lst_2, ind_$)
• Indent Size (chỉ khi Style = ind_$)

Range Helpers (tự động tính Start/Length):

• Add Range Helper → điền "Find Text" và chọn Style (mặc định Bold).
• Tuỳ chọn: Case Sensitive, Trim Text, Occurrence (First/All), Indent Size (nếu ind_$).
• Node sẽ dùng indexOf + Array.from(text).length để tính chính xác kể cả có dấu/emoji.

Lưu ý:

• start và len tính theo độ dài của trường Message.
• Khi dùng Indent (ind_$), có thể kèm indentSize; thư viện sẽ tự xử lý định dạng nội bộ.

5. Zalo Message Trigger

Lắng nghe sự kiện:

• Tin nhắn mới.
• Tin nhắn nhóm.
• Thay đổi trạng thái tin nhắn.

Cấu hình Deduplicate

• De-duplicate Window (ms): Trong khoảng thời gian cấu hình, các tin nhắn trùng nhau sẽ bị bỏ qua.
  • Cách xác định “trùng”: ưu tiên message.id/message.messageId; nếu không có, dùng khóa threadId|text.
  • Ví dụ: đặt 10000 (10 giây), gửi 2 tin giống nhau trong 10 giây ⇒ chỉ 1 tin được đẩy ra trigger.

Group Message Filter

• Group Message Filter: lọc riêng cho tin nhắn nhóm, gồm 4 chế độ:
  • Any: Tất cả tin nhắn trong nhóm đều qua.
  • Mention All: Chỉ qua khi có mention @all.
  • Mention Me: Chỉ qua khi tin nhắn mention chính bạn (cần điền "My Zalo ID" nếu SDK không có ID tài khoản).
  • Mention ID: Chỉ qua khi mention đúng "Target ID" chỉ định.

⚠️ Lưu ý quan trọng

Việc sử dụng thư viện này có thể vi phạm chính sách của Zalo và dẫn đến việc tài khoản bị vô hiệu hóa.
Chúng tôi không chịu trách nhiệm nếu điều đó xảy ra. Vui lòng cân nhắc trước khi sử dụng.

🙏 Lời cảm ơn

Dự án tham khảo từ ZCA-JS — xin cảm ơn vì đóng góp.

📄 License

☕ Đóng góp & Ủng hộ

Nếu dự án này hữu ích với bạn, hãy ủng hộ tác giả một ly cafe để tiếp tục phát triển:

💳 QR Code thanh toán:

Hỗ trợ các nền tảng:

• 🟣 MoMo - Thanh toán nhanh qua ví MoMo
• 🔴 VIETQR - Quét mã QR ngân hàng
• 🔵 NAPAS 247 - Hệ thống thanh toán liên ngân hàng

Thông tin người nhận: HOÀNG PHƯỚC GIA NGUYÊN
Số điện thoại: 0852040256

💝 Cảm ơn sự ủng hộ của bạn! Mỗi ly cafe sẽ giúp tác giả có thêm động lực phát triển dự án.