🚀 n8n-nodes-hbao-zalo

🚀 Community nodes package cho n8n - Tự động hóa Zalo hoàn chỉnh với workflow automation

Thư viện n8n nodes chuyên nghiệp để tích hợp và tự động hóa Zalo thông qua n8n workflow. Sử dụng [email protected] mới nhất để đảm bảo tính ổn định và hiệu suất cao.

✨ Điểm mới trong phiên bản này

• ✅ Updated [email protected] - Phiên bản mới nhất, ổn định hơn
• ✅ Fixed QR Login - Sửa lỗi không trả về credential sau khi đăng nhập
• ✅ Improved Error Handling - Xử lý lỗi tốt hơn, logs rõ ràng hơn
• ✅ Better TypeScript Support - Fix compile errors, type-safe
• ✅ Auto Credential Creation - Tự động tạo credential sau khi login thành công

📖 Tài liệu hướng dẫn chi tiết

📝 Xem file TESTING.md để biết cách test và sử dụng

🎯 Dành cho ai?

• 🔄 N8N Users muốn tự động hóa workflow Zalo
• 🏢 Doanh nghiệp cần automation marketing qua Zalo
• 🤖 Developer xây dựng chatbot và hệ thống CRM
• 📱 Marketer tự động hóa chiến dịch qua Zalo
• 🛒 Bán hàng online quản lý khách hàng tự động
• 🔔 System Admin thiết lập notification system

✨ Tính năng chính

🎯 8 Nodes chuyên nghiệp cho n8n automation:

• 🔐 Zalo Login Via QR Code - Đăng nhập Zalo bằng QR code tự động
• 💬 Zalo Send Message - Gửi tin nhắn tự động đến cá nhân/nhóm
• 👤 Zalo User - Quản lý thông tin người dùng, cập nhật profile
• 👥 Zalo Group - Quản lý nhóm, tạo ghi chú, thêm thành viên
• 📨 Zalo Message Trigger - Webhook lắng nghe tin nhắn đến
• 🤝 Zalo Friend Trigger - Webhook lắng nghe sự kiện kết bạn
• 📊 Zalo Poll - Tạo và quản lý poll trong nhóm
• 🏷️ Zalo Tag - Quản lý tag, phân loại liên hệ

🎯 Ứng dụng thực tế:

• 🤖 Chatbot automation - Tự động trả lời tin nhắn
• 📈 Marketing automation - Gửi tin nhắn marketing hàng loạt
• 🔔 Notification system - Thông báo tự động từ hệ thống
• 📊 CRM integration - Tích hợp với hệ thống CRM
• 📋 Lead management - Quản lý khách hàng tiềm năng
• 📈 Sales automation - Tự động hóa quy trình bán hàng

📦 Cài đặt

🎯 Community Nodes (Khuyến nghị)

Đối với người dùng n8n v0.187+, bạn có thể cài đặt node này trực tiếp từ bảng Community Nodes trong trình soạn thảo n8n.

1. Mở trình soạn thảo n8n của bạn
2. Vào Settings > Community Nodes
3. Tìm kiếm n8n-nodes-hbao-zalo
4. Nhấp vào Install
5. Tải lại trình soạn thảo

📋 Cài đặt thủ công

Bạn cũng có thể cài đặt node này theo cách thủ công:

cd YOUR_N8N_INSTALLATION_DIRECTORY
npm install n8n-nodes-hbao-zalo

🚀 Quick Start

1. Tạo n8n API Key

• Vào n8n Settings > API
• Create API Key
• Copy key

2. Tạo n8n Zalo Account Credential

• Vào Credentials > Add Credential
• Chọn "n8n Zalo Account Credential"
• Nhập API Key và URL (http://localhost:5678)

3. Login với QR Code

• Tạo workflow mới
• Thêm node "Zalo CN Login Via QR Code"
• Chọn credential vừa tạo
• Execute node
• Quét QR code bằng Zalo app
• Credential sẽ được tạo tự động!

🎯 Available Nodes

1. 🔐 Zalo Login By QR

Node cho phép đăng nhập vào Zalo thông qua mã QR code tự động.

2. 👥 Zalo Group

Node quản lý các hoạt động nhóm với đầy đủ operations:

• 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

Node quản lý người dùng và bạn bè với các operations:

• 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 người dùng qua số điện thoại

4. Zalo Send Message

Node gửi tin nhắn tới người dùng hoặc nhóm với features:

• Gửi tin nhắn văn bản, hình ảnh, video
• Gửi sticker, emoji, link preview
• Forward tin nhắn
• Gửi với urgency levels

5. 📨 Zalo Message Trigger

Node lắng nghe và xử lý các sự kiện tin nhắn real-time:

• Tin nhắn mới từ cá nhân
• Tin nhắn nhóm
• Thay đổi trạng thái tin nhắn

6. 🤝 Zalo Friend Trigger

Node webhook lắng nghe sự kiện kết bạn:

• Lời mời kết bạn mới
• Chấp nhận/từ chối kết bạn
• Thay đổi trạng thái bạn bè

7. 📊 Zalo Poll

Node tạo và quản lý poll trong nhóm:

• Tạo poll với nhiều lựa chọn
• Theo dõi kết quả vote
• Quản lý thời gian poll

8. 🏷️ Zalo Tag

Node quản lý tag và phân loại liên hệ:

• Tạo/xóa tag
• Gán tag cho liên hệ
• Tìm kiếm theo tag

☕ Ủng hộ dự án

Nếu package này giúp bạn tiết kiệm thời gian hoặc giải quyết được vấn đề, hãy cân nhắc ủng hộ tác giả một ☕ để duy trì và phát triển thêm tính năng mới!

📱 Quét QR Code để mời cafe:

VietinBank - 100884532014 - NGUYEN THI HIEN

🔧 Cấu hình

📝 Credentials cần thiết:

• Cookie - Cookie từ phiên đăng nhập Zalo
• IMEI - IMEI identifier từ Zalo
• User Agent - User Agent từ browser

🚀 Sử dụng:

Sau khi cài đặt, bạn sẽ tìm thấy các Zalo nodes trong node palette thuộc danh mục "Zalo".

🛠 Công nghệ

• ✅ [email protected] - Thư viện Zalo API mới nhất, ổn định
• ✅ TypeScript 5.5+ - Type-safe, modern JavaScript
• ✅ n8n workflow - Visual automation platform

📝 Changelog

Version 1.0.0 (2025-01-09)

• ✅ Fixed ZaloLoginByQr not returning credentials after successful login
• ✅ Updated zalo-api-final to 2.1.1
• ✅ Improved error handling and logging
• ✅ Fixed TypeScript compilation errors
• ✅ Better credential auto-creation flow
• ✅ Renamed package to n8n-nodes-hbao-zalo

⚠️ Lưu ý quan trọng

Vui lòng đọc kỹ trước khi sử dụng Zalo nodes:

⚠️ Cảnh báo: Việc sử dụng thư viện này đồng nghĩa với việc bạn đang làm trái với chính sách của Zalo và nó có thể khiến cho tài khoản của bạn bị vô hiệu hóa. Chúng tôi sẽ không chịu trách nhiệm nếu điều đó xảy ra, vậy nên hãy cân nhắc trước khi sử dụng.

📝 Khuyến nghị:

• Sử dụng tài khoản test, không dùng tài khoản chính
• Tuân thủ giới hạn rate limit của Zalo
• Sử dụng có trách nhiệm và không spam

🙏 Cảm ơn

Chúng tôi xin chân thành cảm ơn:

• hiennguyen270995 cho thư viện zalo-api-final
• AloneSky Team cho repo gốc n8n-nodes-zalo-ca-nhan
• n8n Community đã tạo ra nền tảng automation tuyệt vời

📄 License

MIT

👨‍💻 Tác giả

HBao

• Package: n8n-nodes-hbao-zalo
• Based on: n8n-nodes-zalo-ca-nhan by hiennguyen270995

🌟 Nếu thấy hữu ích, hãy cho repo một ⭐ star để ủng hộ!

💡 Có ý tưởng node mới cho n8n? Hãy tạo issue để thảo luận!