n8n-nodes-zalovn-vuongnm

Node dành riêng cho n8n này được thiết kế hoạt động hoàn toàn bên trong instance n8n của bạn. Không cần sử dụng API của bên thứ ba hay phụ thuộc ngoại vi nào — chỉ có sự tự động hóa quy trình thuần túy, đảm bảo dữ liệu của bạn luôn được giữ riêng tư và an toàn.

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 tự động hóa liền mạch ngay trong n8n. Đây là dự án mã nguồn mở, mở rộng cơ hội cho cộng đồng cùng đóng góp ý kiến và phát triển thêm các tính năng mới, nhằm xây dựng hệ thống tự động hóa Zalo tiên tiến, hiệu quả và an toàn hơn.

Phiên bản hiện tại

Version 0.6.1 - Cập nhật thư viện xử lý metadata hình ảnh

Các thay đổi quan trọng trong v0.6.1

• Thay thế thư viện xử lý ảnh: Chuyển từ sharp sang image-size để giảm kích thước package và tăng tính tương thích
• Tương thích với ZCA-JS 2.0+: Hỗ trợ đầy đủ yêu cầu imageMetadataGetter của ZCA-JS phiên bản 2.0.0 trở lên
• Tối ưu hiệu năng: Package nhẹ hơn, cài đặt nhanh hơn, không cần compile native code
• Tương thích đa nền tảng: Hoạt động ổn định trên mọi hệ điều hành mà không cần dependencies phức tạp

Yêu cầu hệ thống

• Node.js: Phiên bản 16.x trở lên
• n8n: Phiên bản 0.200.0 trở lên
• ZCA-JS: Phiên bản 2.0.0 trở lên

Buy me a coffee

Nếu node này giúp bạn tiết kiệm thời gian hoặc giải quyết được vấn đề khó nhằn, hãy cân nhắc ủng hộ tôi một ☕ (Buy me a coffee) hoặc đơn giản là nhấn ★ Star cho dự án.

Sự động viên nhỏ ấy sẽ tiếp thêm năng lượng để mình tiếp tục duy trì, cập nhật và phát triển thêm nhiều tính năng hữu ích hơn nữa.

Cám ơn bạn rất nhiều! 💛

Tác giả

• Nguyễn Minh Vượng

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

Cài đặt từ Community Nodes (Khuyến nghị)

Đối với người dùng n8n phiên bản 0.187 trở lên, 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-zalovn-vuongnm
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-zalovn-vuongnm

Sau khi cài đặt, khởi động lại n8n để áp dụng thay đổi.

Các node có sẵn

1. Zalo Account (Login By QR)

Node cho phép đăng nhập vào Zalo thông qua mã QR để xác thực tài khoản.

Tính năng:

• Đăng nhập an toàn bằng mã QR
• Lưu trữ phiên đăng nhập
• Tự động duy trì kết nối

2. Zalo Messaging

Node gửi tin nhắn và nội dung đa phương tiện tới người dùng hoặc nhóm.

Các thao tác:

• sendMessage: Gửi tin nhắn văn bản
• sendSticker: Gửi sticker (hỗ trợ tìm kiếm theo từ khóa)
• sendVideo: Gửi video
• sendVoice: Gửi tin nhắn thoại
• sendLink: Gửi liên kết với preview

Tính năng nổi bật:

• Hỗ trợ gửi tới cả người dùng và nhóm
• Tìm kiếm sticker theo từ khóa thay vì phải nhập ID
• Xử lý metadata hình ảnh tự động với image-size

3. Zalo Group

Node quản lý các hoạt động nhóm với đầy đủ chức năng quản trị và thành viên.

Các thao tác quản lý nhóm:

• createGroup: Tạo nhóm mới với tên và danh sách thành viên
• getGroupInfo: Lấy thông tin chi tiết về nhóm
• getAllGroups: Lấy danh sách tất cả các nhóm
• changeGroupName: Đổi tên nhóm
• changeGroupAvatar: Thay đổi ảnh đại diện nhóm

Quản lý thành viên:

• getGroupMembers: Lấy danh sách thành viên trong nhóm
• addUserToGroup: Thêm thành viên mới vào nhóm
• removeUserFromGroup: Xóa thành viên khỏi nhóm

Quản lý quyền hạn:

• addGroupDeputy: Thêm phó nhóm (deputy admin)
• changeGroupOwner: Chuyển quyền chủ nhóm (owner) cho thành viên khác

Quản lý ghi chú:

• createNote: Tạo ghi chú trong nhóm với tùy chọn ghim (pin)

Quản lý link mời nhóm:

• enableGroupLink: Kích hoạt link mời nhóm
• disableGroupLink: Vô hiệu hóa link mời nhóm
• getGroupLinkDetail: Lấy thông tin chi tiết về link nhóm (trạng thái, thời hạn)
• getGroupLinkInfo: Lấy thông tin nhóm từ link mời (trước khi tham gia)

Tính năng nổi bật:

• Quản lý toàn diện từ tạo nhóm đến quản trị thành viên
• Hỗ trợ chuyển quyền owner và phân quyền admin
• Quản lý link mời với kiểm soát thời hạn và trạng thái
• Tạo và ghim ghi chú quan trọng trong nhóm
• Xử lý batch operations (thêm/xóa nhiều thành viên cùng lúc)

4. Zalo User

Node quản lý người dùng và bạn bè.

Các thao tác:

• 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 tài khoả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

5. Zalo Message Trigger

Node lắng nghe và xử lý các sự kiện tin nhắn theo thời gian thực.

Các sự kiện:

• Tin nhắn mới từ người dùng
• Tin nhắn mới trong nhóm
• Thay đổi trạng thái tin nhắn
• Cập nhật nội dung tin nhắn

6. Zalo Group Event Trigger

Node lắng nghe các sự kiện liên quan đến nhóm.

Các sự kiện:

• Thành viên mới tham gia
• Thành viên rời khỏi nhóm
• Thay đổi thông tin nhóm
• Thay đổi quyền thành viên

7. Zalo User Event Trigger (Friend Request)

Node lắng nghe sự kiện lời mời kết bạn.

Tính năng:

• Nhận thông báo khi có lời mời kết bạn mới
• Tự động xử lý hoặc phản hồi lời mời
• Lấy thông tin người gửi lời mời

Hướng dẫn sử dụng nhanh

Bước 1: Đăng nhập Zalo

1. Thêm node Zalo Account vào workflow
2. Quét mã QR hiển thị để đăng nhập
3. Credentials sẽ được lưu tự động

Bước 2: Gửi tin nhắn

1. Thêm node Zalo Messaging
2. Chọn operation: Send Message
3. Nhập User ID hoặc Group ID
4. Nhập nội dung tin nhắn
5. Thực thi workflow

Bước 3: Lắng nghe tin nhắn

1. Thêm node Zalo Message Trigger
2. Kết nối với các node xử lý logic
3. Kích hoạt workflow
4. Node sẽ tự động nhận tin nhắn mới

Kỹ thuật nâng cao

Xử lý metadata hình ảnh

Package này sử dụng thư viện image-size thay vì sharp để xử lý metadata hình ảnh. Điều này mang lại các lợi ích:

• Nhẹ hơn: Kích thước package giảm đáng kể (~50KB so với ~30MB)
• Nhanh hơn: Không cần compile native code khi cài đặt
• Đơn giản hơn: Hoạt động ổn định trên mọi nền tảng
• Đủ chức năng: Cung cấp đầy đủ thông tin width, height, size cần thiết

Tương thích với ZCA-JS 2.0+

Từ phiên bản 2.0.0, ZCA-JS yêu cầu người dùng cung cấp hàm imageMetadataGetter khi khởi tạo. Package này đã tích hợp sẵn hàm này với image-size, cho phép:

• Gửi hình ảnh theo đường dẫn file
• Gửi GIF động
• Tự động trích xuất kích thước ảnh
• Hỗ trợ nhiều định dạng: JPG, PNG, GIF, WebP, BMP, SVG

Cấu trúc dự án

n8n-nodes-zalovn-vuongnm/
├── nodes/
│   ├── utils/
│   │   └── imageMetadata.ts      # Xử lý metadata hình ảnh
│   ├── ZaloAccount/
│   ├── ZaloMessaging/
│   ├── ZaloGroup/
│   ├── ZaloUser/
│   └── triggers/
├── credentials/
│   └── ZaloAccount.credentials.ts
├── package.json
└── README.md

Changelog

Version 0.6.1 (Hiện tại)

Thay đổi:

• Chuyển từ thư viện sharp sang image-size cho xử lý metadata hình ảnh
• Tối ưu kích thước package
• Cải thiện tốc độ cài đặt
• Tăng tính tương thích đa nền tảng

Sửa lỗi:

• Khắc phục vấn đề compile native code trên một số môi trường
• Cải thiện xử lý lỗi khi đọc file ảnh

Version 0.6.0

Tính năng mới:

• Consolidate ZaloMessage node với 5 operations chính
• Enhanced ZaloUser với friend request triggers
• Improved ZaloGroup management capabilities
• Streamlined node architecture

Cải tiến:

• Backward compatibility với legacy nodes
• Better error handling và output responses
• Enhanced menu organization
• Comprehensive documentation

Cảnh báo quan trọng

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

⚠️ Lưu ý: 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 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 kỹ trước khi sử dụng.

Khuyến nghị sử dụng an toàn:

• Không spam tin nhắn với tần suất cao
• Sử dụng tài khoản phụ để test
• Tuân thủ giới hạn API của Zalo
• Không sử dụng cho mục đích vi phạm chính sách

Đóng góp

Dự án này là mã nguồn mở và chào đón mọi đóng góp từ cộng đồng:

• Báo cáo lỗi: Issues
• Đề xuất tính năng: Feature Requests
• Pull Requests: Luôn được chào đón!

Lời cảm ơn

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

• ZCA-JS - Thư viện nền tảng cho việc tích hợp Zalo
• n8n Community - Hỗ trợ và feedback quý báu
• Contributors - Những người đóng góp cho dự án

Hỗ trợ

Nếu bạn gặp vấn đề hoặc có câu hỏi:

• Tạo Issue trên GitHub
• Tham gia thảo luận trong Discussions
• Email: [[email protected]]

Giấy phép

MIT License

Made with ❤️ for the n8n and Zalo automation community