n8n-nodes-zalo-custom 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +52 -53
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -1,61 +1,64 @@
1
1
  # n8n-nodes-zalo-custom
2
2
 
3
- Bộ node **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 API của bên thứ ba hay bất kỳ 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**.
3
+ Thư viện n8n nodes chuyên nghiệp, tích hợp tự động hoá Zalo thông qua n8n workflow. Cho phép Expression Zalo Credential phù hợp khi quản nhiều tài khoản Zalo.
4
+
5
+ Hoạt động độc lập trong môi trường **n8n của bạn** — **không** dùng API của bên thứ ba hay bất kỳ 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**.
4
6
 
5
7
  Đây là một dự án **mã nguồn mở**, chúng tôi khuyến khích cộng đồng cùng đóng góp và phát triển thêm các tính năng mới.
8
+
6
9
  ## 📱 Liên hệ & Hỗ trợ
7
10
 
8
11
  **Github:** [codedao12](https://github.com/codedao12)
9
12
  **Email:** codedao12@gmail.com
10
13
  **Nhóm Zalo hỗ trợ:** [Tham gia nhóm Zalo](https://zalo.me/g/uinmin927)
11
14
  Vui lòng liên hệ để yêu cầu tính năng mới hoặc báo lỗi.
12
-
15
+ ---
13
16
 
14
17
  ## ✨ Các Tính Năng Chính
15
18
 
16
- | Trạng thái | Tính Năng |
17
- | :---: |:--------------------------------------------------|
18
- |🔑 | **Xác thực & Kết nối** |
19
- || Đăng nhập bằng Mã QR |
20
- || Chọn Zalo Credential bằng biểu thức |
21
- || Hỗ trợ đăng nhập nhiều tài khoản |
22
- | | Hỗ trợ Proxy |
23
- || Thông báo (QR, lỗi) qua Telegram |
24
- |⚡️ | **Trigger - Lắng nghe sự kiện** |
25
- || Sự kiện tin nhắn mới (lọc theo từ khóa, nhóm) |
26
- || Sự kiện thu hồi tin nhắn, thả cảm xúc |
27
- || Sự kiện về bạn bè (kết bạn, hủy bạn) |
28
- || Sự kiện trong nhóm (tham gia, rời, đổi quyền,...) |
29
- |💬 | **Gửi & Nhận Tin nhắn** |
30
- | | Gửi tin nhắn (Văn bản, Ảnh, Sticker) |
31
- | | Trả lời tin nhắn (Quote) |
32
- | | Gắn thẻ (Tag) thành viên trong nhóm |
33
- || Thả/Gỡ cảm xúc (Reaction) vào tin nhắn |
34
- | | Thu hồi tin nhắn đã gửi |
35
- || phỏng trạng thái "Đang soạn tin..." |
36
- | 👤| **Quản Bạn & Người dùng** |
37
- | | Gửi / Hủy lời mời kết bạn |
38
- || Chấp nhận / Từ chối lời mời kết bạn |
39
- | | Hủy kết bạn (xóa bạn) |
40
- || Lấy danh sách bạn & lời mời đã gửi |
41
- || Tìm người dùng bằng SĐT hoặc User ID |
42
- | | Lấy thông tin chi tiết người dùng |
43
- || Cập nhật thông tin nhân (Tên, Giới tính,...) |
44
- || Chặn / Bỏ chặn người dùng |
45
- | 👥| **Quản lý Nhóm** |
46
- | | Tạo nhóm mới |
47
- || Thêm / Xóa thành viên khỏi nhóm |
48
- | | Giải tán nhóm |
49
- || Thay đổi tên & ảnh đại diện nhóm |
50
- || Bổ nhiệm / Bãi nhiệm quyền Phó nhóm |
51
- | | Chuyển quyền Trưởng nhóm |
52
- || Lấy danh sách tất cả các nhóm đã tham gia |
53
- || Lấy thông tin chi tiết thành viên nhóm |
54
- || Tham gia nhóm bằng link / Rời nhóm |
55
- || Tạo ghi chú (Note) trong nhóm |
56
- | 🎨| **Tính năng khác** |
57
- | | Tạo bình chọn (Poll) trong nhóm |
58
- || Quản thẻ phân loại (Tag) |
19
+ | 💯 | Tính Năng |
20
+ |:----:|:--------------------------------------------------|
21
+ | 🔑 | _Xác thực & Kết nối_ |
22
+ || Đăng nhập bằng Mã QR |
23
+ | ✓✓ | Expression Zalo Credential |
24
+ || Hỗ trợ đăng nhập nhiều tài khoản, proxy |
25
+ | ✓✓ | Đăng nhập, thông báo qua telegram |
26
+ | ⚡️ | _Trigger - Lắng nghe sự kiện_ |
27
+ | ✓ | Sự kiện tin nhắn mới (lọc theo từ khóa, nhóm) |
28
+ || Sự kiện thu hồi tin nhắn, thả cảm xúc |
29
+ || Sự kiện trong nhóm (tham gia, rời, đổi quyền,...) |
30
+ || Sự kiện về bạn bè (kết bạn, hủy bạn) |
31
+ | 💬 | _Gửi & Nhận Tin nhắn_ |
32
+ | ✓ | Gửi tin nhắn (Văn bản, Ảnh, Sticker) |
33
+ | ✓ | Trả lời tin nhắn (Quote) |
34
+ | ✓ | Gắn thẻ (Tag) thành viên trong nhóm |
35
+ | ✓ | Thả/Gỡ cảm xúc (Reaction) vào tin nhắn |
36
+ || Thu hồi tin nhắn đã gửi |
37
+ | ✓ | phỏng trạng thái "Đang soạn tin..." |
38
+ | 👤 | _Quản Bạn & Người dùng_ |
39
+ | ✓ | Gửi / Hủy lời mời kết bạn |
40
+ | ✓ | Chấp nhận / Từ chối lời mời kết bạn |
41
+ || Hủy kết bạn (xóa bạn) |
42
+ | ✓ | Lấy danh sách bạn & lời mời đã gửi |
43
+ || Tìm người dùng bằng SĐT hoặc User ID |
44
+ || Lấy thông tin chi tiết người dùng |
45
+ | ✓ | Cập nhật thông tin nhân (Tên, Giới tính,...) |
46
+ || Chặn / Bỏ chặn người dùng |
47
+ | 👥 | _Quản Nhóm_ |
48
+ | ✓ | Tạo nhóm mới |
49
+ | ✓ | Thêm / Xóa thành viên khỏi nhóm |
50
+ || Giải tán nhóm |
51
+ | ✓ | Thay đổi tên & ảnh đại diện nhóm |
52
+ || Bổ nhiệm quyền Phó nhóm |
53
+ | ✓✓ | Chuyển quyền Trưởng nhóm |
54
+ | ✓ | Lấy danh sách tất cả các nhóm đã tham gia |
55
+ || Lấy thông tin chi tiết thành viên nhóm |
56
+ || Tham gia nhóm bằng link / Rời nhóm |
57
+ || Tạo ghi chú (Note) trong nhóm |
58
+ | 🎨 | _Tính năng khác_ |
59
+ | ✓ | Tạo bình chọn (Poll) trong nhóm |
60
+ | ✓ | Quản thẻ phân loại (Tag) |
61
+ || Tìm kiếm sticker |
59
62
 
60
63
  [//]: # (| Bãi nhiệm quyền Phó nhóm | ✅ |)
61
64
 
@@ -80,11 +83,7 @@ Vui lòng liên hệ để yêu cầu tính năng mới hoặc báo lỗi.
80
83
  Nếu bạn đang tự host n8n, bạn có thể cài đặt bộ node này qua `npm`:
81
84
 
82
85
  ```bash
83
- # Điều hướng đến thư mục cài đặt n8n của bạn
84
- cd ~/.n8n/custom
85
- # Hoặc thư mục khác nếu bạn cấu hình biến môi trường NODE_FUNCTION_PATH
86
-
87
- # Cài đặt package
86
+ cd YOUR_N8N_INSTALLATION_DIRECTORY
88
87
  npm install n8n-nodes-zalo-custom
89
88
  ```
90
89
 
@@ -115,9 +114,9 @@ Node `Zalo Login By QR` cần quyền truy cập API vào n8n instance của b
115
114
  2. Trong node này, chọn `n8n Zalo API Credential` bạn vừa tạo ở bước 1.
116
115
  3. **Chạy (Execute) node**. Một mã QR sẽ được tạo ra.
117
116
  4. Dùng ứng dụng Zalo trên điện thoại để **quét mã QR** này và xác nhận đăng nhập.
118
- 5. Sau khi đăng nhập thành công, một `Zalo API Credential` mới** đã được tạo.
117
+ 5. Sau khi đăng nhập thành công, một `Zalo API Credential` mới đã được tạo.
119
118
 
120
- > - Bạn cần **tải lại trình duyệt** để thấy `Zalo API Credential` mới xuất hiện trong danh sách Credentials.
119
+ > - Bạn cần **tải lại trình duyệt** để thấy `Zalo Credential` mới xuất hiện trong danh sách Credentials.
121
120
  > - Truyền Telegram Bot Token sẽ thông báo QR qua nhóm (phù hợp tự động hoá), lưu vào credential để cảnh báo lỗi.
122
121
 
123
122
  ### Bước 3: Sử dụng các Node Zalo khác
@@ -227,7 +226,7 @@ Khi bạn quản lý nhiều tài khoản Zalo, mỗi tài khoản sẽ có mộ
227
226
  ---
228
227
 
229
228
  ## 🙏 Lời cảm ơn
230
- Dự án tham khảo từ các nodes n8n có sẵn và từ **zca-js** — xin cảm ơn vì đóng góp.
229
+ Dự án tham khảo từ **zca-js** và các nodes n8n có sẵn — xin cảm ơn vì đóng góp.
231
230
 
232
231
  ---
233
232
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "n8n-nodes-zalo-custom",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "n8n nodes for Zalo automation. Send messages, manage groups, friends, and listen to events without third-party services.",
5
5
  "keywords": [
6
6
  "n8n",
@@ -10,17 +10,17 @@
10
10
  "zalo api"
11
11
  ],
12
12
  "license": "MIT",
13
- "homepage": "https://github.com/codedao12/n8n-nodes-zalo#readme",
13
+ "homepage": "https://github.com/codedao12/n8n-nodes-zalo-custom#readme",
14
14
  "author": {
15
15
  "name": "codedao12",
16
16
  "email": "codedao12@gmail.com"
17
17
  },
18
18
  "repository": {
19
19
  "type": "git",
20
- "url": "git+https://github.com/codedao12/n8n-nodes-zalo.git"
20
+ "url": "git+https://github.com/codedao12/n8n-nodes-zalo-custom.git"
21
21
  },
22
22
  "bugs": {
23
- "url": "https://github.com/codedao12/n8n-nodes-zalo/issues"
23
+ "url": "https://github.com/codedao12/n8n-nodes-zalo-custom/issues"
24
24
  },
25
25
  "engines": {
26
26
  "node": ">=18.10",