n8n-nodes-ultimate 1.1.3 → 1.1.4
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.
- package/README.md +90 -79
- package/dist/nodes/MessageDebouncer/MessageDebouncer.node.js +1 -1
- package/dist/nodes/ZaloUser/ZaloCommunication/ZaloCommunication.node.js +1 -1
- package/dist/nodes/ZaloUser/ZaloLoginByQr/ZaloLoginByQr.node.js +1 -1
- package/dist/nodes/ZaloUser/ZaloSendMessage/ZaloSendMessage.node.js +1 -1
- package/dist/nodes/ZaloUser/ZaloTrigger/ZaloTrigger.node.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,14 +3,17 @@
|
|
|
3
3
|
 
|
|
4
4
|
|
|
5
5
|
|
|
6
|
-
# 👨🔧 Tác
|
|
6
|
+
# 👨🔧 Tác Giả & Hỗ Trợ
|
|
7
7
|
|
|
8
8
|
**Github:** [codedao12](https://github.com/codedao12)
|
|
9
9
|
**Video hướng dẫn:** [xem video](https://youtu.be/DPcGiIKUm1Q)
|
|
10
10
|
**Nhóm Zalo hỗ trợ:** [truy cập nhóm](https://zalo.me/g/uinmin927)
|
|
11
|
-
Vui lòng liên hệ để
|
|
11
|
+
Vui lòng liên hệ để hỗ trợ hoặc báo lỗi.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
<br>
|
|
14
|
+
|
|
15
|
+
## 📋 Giới Thiệu
|
|
16
|
+
_Đây là bản thay thế **n8n-nodes-zalo-custom**_.
|
|
14
17
|
|
|
15
18
|
**Zalo Cá Nhân**:
|
|
16
19
|
- **Hơn +80** tính năng tự động hoá Zalo với n8n.
|
|
@@ -19,71 +22,73 @@ Vui lòng liên hệ để yêu cầu tính năng mới hoặc báo lỗi.
|
|
|
19
22
|
- Tổng hợp sự kiện `Media Group` thành 1 output duy nhất.
|
|
20
23
|
- Tham số `filter` trong trigger giúp dễ dàng phần luồng messageType.
|
|
21
24
|
- Không dùng API của bên thứ ba, chạy trong môi trường **n8n của bạn**, đảm bảo **riêng tư và an toàn**.
|
|
22
|
-
|
|
25
|
+
|
|
23
26
|
|
|
24
27
|
**Node Gôm Tin Nhắn**:
|
|
25
28
|
- `Message Debouncer`: Chờ **gôm tin nhắn** tối ưu trải nghiệm chatbot.
|
|
26
29
|
- Phù hợp tuỳ chỉnh cho mọi nền tảng khác fb, telegram, tiktok..
|
|
27
30
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
|
|
|
39
|
-
|
|
|
40
|
-
|
|
|
41
|
-
|
|
|
42
|
-
|
|
|
43
|
-
|
|
|
44
|
-
|
|
|
45
|
-
|
|
|
46
|
-
|
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
|
|
|
67
|
-
|
|
|
68
|
-
|
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
|
73
|
-
|
|
|
74
|
-
|
|
|
75
|
-
|
|
|
76
|
-
|
|
|
77
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
|
|
31
|
+
<br>
|
|
32
|
+
|
|
33
|
+
## ✨ Các Tính Năng Chính `Zalo`
|
|
34
|
+
|
|
35
|
+
| Cơ bản | Nâng cao | - |
|
|
36
|
+
|:------:|:--------:|:----------------------------------------------------|
|
|
37
|
+
| - | - | 🔑 **_XÁC THỰC & KẾT NỐI_** |
|
|
38
|
+
| ☑️ | | Đăng nhập bằng Mã QR |
|
|
39
|
+
| ☑️ | | Hỗ trợ đăng nhập nhiều tài khoản, proxy |
|
|
40
|
+
| ️ | ✅ | **Expression** Zalo Credential |
|
|
41
|
+
| ️ | ✅ | Tự động **cập nhật lại Credential** khi login lần 2 |
|
|
42
|
+
| | ✅ | Thông báo QR, lỗi qua telegram |
|
|
43
|
+
| - | - | ⚡ **_TRIGGER_** |
|
|
44
|
+
| ☑️ | | Sự kiện tin nhắn mới (lọc theo từ khóa, nhóm) |
|
|
45
|
+
| ☑️ | | Sự kiện thu hồi tin nhắn, thả cảm xúc |
|
|
46
|
+
| ☑️ | | Sự kiện trong nhóm (tham gia, rời, đổi quyền,...) |
|
|
47
|
+
| ☑️ | | Sự kiện về bạn bè (kết bạn, hủy bạn) |
|
|
48
|
+
| ☑️ | | Sự kiện đã xem, thu hồi, đang soạn tin, thả tim |
|
|
49
|
+
| | ✅ | Tham số `filter` giúp output thân thiện hơn |
|
|
50
|
+
| | ✅ | Gôm nhóm media thành 1 sự kiện duy nhất |
|
|
51
|
+
| - | - | 💬 **_NHẮN TIN_** |
|
|
52
|
+
| ☑️ | | Gửi tin nhắn (Văn bản, Ảnh, Sticker) |
|
|
53
|
+
| ☑️ | | Trả lời tin nhắn (Quote) |
|
|
54
|
+
| ☑️ | | Tag @All hoặc thành viên trong nhóm |
|
|
55
|
+
| ☑️ | | Mô phỏng trạng thái "Đang soạn tin..." |
|
|
56
|
+
| | ✅ | Thả/Gỡ cảm xúc (Reaction) vào tin nhắn |
|
|
57
|
+
| | ✅ | Gửi multi Image, Video, PDF, Voice |
|
|
58
|
+
| | ✅ | Gửi Danh thiếp, thẻ ngân hàng |
|
|
59
|
+
| - | - | 👤 **_QUẢN LÝ TÀI KHOẢN & BẠN BÈ_** |
|
|
60
|
+
| ☑️ | | Gửi / Hủy lời mời kết bạn |
|
|
61
|
+
| ☑️ | | Chấp nhận / Từ chối lời mời kết bạn |
|
|
62
|
+
| ☑️ | | Hủy kết bạn (xóa bạn) |
|
|
63
|
+
| ☑️ | | Lấy danh sách bạn bè & lời mời đã gửi |
|
|
64
|
+
| ☑️ | | Cập nhật thông tin cá nhân (name, gender, avatar..) |
|
|
65
|
+
| ☑️ | | Tìm người dùng bằng SĐT hoặc User ID |
|
|
66
|
+
| ☑️ | | Lấy thông tin chi tiết người dùng |
|
|
67
|
+
| ☑️ | | Chặn / Bỏ chặn người dùng |
|
|
68
|
+
| ☑️ | | Thu hồi tin nhắn đã gửi |
|
|
69
|
+
| | ✅ | Tạo nhắc hẹn (reminder) |
|
|
70
|
+
| | ✅ | Lấy danh sách tin nhắn cũ |
|
|
71
|
+
| | ✅ | Xóa tin nhắn của User/Group |
|
|
72
|
+
| | ✅ | Tắt mở thông báo User/Group |
|
|
73
|
+
| | ✅ | Cập nhật quyền riêng tư |
|
|
74
|
+
| - | - | 👥 **_QUẢN LÝ NHÓM_** |
|
|
75
|
+
| ☑️ | | Tạo nhóm, giải tán, rời nhóm |
|
|
76
|
+
| ☑️ | | Bổ nhiệm/Xoá quyền Phó nhóm |
|
|
77
|
+
| ☑️ | | Lấy danh sách tất cả các nhóm đã tham gia |
|
|
78
|
+
| ☑️ | | Lấy thông tin nhóm (từ ID hoặc link) |
|
|
79
|
+
| ☑️ | | Tham gia nhóm bằng link / Rời nhóm |
|
|
80
|
+
| ☑️ | | Tạo/Chỉnh sửa ghi chú (Note) trong nhóm |
|
|
81
|
+
| ☑️ | | Cập nhật tên & ảnh đại diện nhóm |
|
|
82
|
+
| ☑️ | | Thêm / Xóa thành viên khỏi nhóm |
|
|
83
|
+
| | ✅ | Chấp nhận/Từ chối thành viên vào nhóm |
|
|
84
|
+
| | ✅ | Chuyển quyền Trưởng nhóm |
|
|
85
|
+
| | ✅ | Cập nhật cài đặt nhóm |
|
|
86
|
+
| - | - | 🎨 **_KHÁC_** |
|
|
87
|
+
| ☑️ | | Tạo bình chọn (Poll) trong nhóm |
|
|
88
|
+
| ☑️ | | Quản lý thẻ phân loại (Tag) |
|
|
89
|
+
| ☑️ | | Tìm kiếm sticker |
|
|
90
|
+
|
|
91
|
+
<br>
|
|
87
92
|
|
|
88
93
|
## 🚀 Hướng Dẫn Cài Đặt
|
|
89
94
|
|
|
@@ -95,7 +100,7 @@ Vui lòng liên hệ để yêu cầu tính năng mới hoặc báo lỗi.
|
|
|
95
100
|
2. Đi đến **Settings → Community Nodes**.
|
|
96
101
|
3. Chọn **Install** và tìm kiếm `n8n-nodes-ultimate`.
|
|
97
102
|
4. Nhấn nút **Install** để cài đặt.
|
|
98
|
-
5.
|
|
103
|
+
5. Tìm kiếm `codedao12` trong danh sách node để sử dụng.
|
|
99
104
|
|
|
100
105
|
---
|
|
101
106
|
|
|
@@ -108,8 +113,9 @@ cd YOUR_N8N_DIRECTORY
|
|
|
108
113
|
npm install n8n-nodes-ultimate
|
|
109
114
|
```
|
|
110
115
|
|
|
116
|
+
<br>
|
|
111
117
|
|
|
112
|
-
## 💡 Hướng Dẫn Sử Dụng
|
|
118
|
+
## 💡 Hướng Dẫn Sử Dụng `Zalo`
|
|
113
119
|
|
|
114
120
|
Để tự động hóa Zalo, bạn cần thực hiện các bước sau để đăng nhập và lấy `Credential` cho các node khác sử dụng.
|
|
115
121
|
|
|
@@ -130,14 +136,15 @@ Node `Zalo Login By QR` cần quyền truy cập API vào n8n instance của b
|
|
|
130
136
|
|
|
131
137
|
### Bước 2: Đăng nhập Zalo bằng QR Code
|
|
132
138
|
|
|
133
|
-
1.
|
|
134
|
-
2.
|
|
135
|
-
3.
|
|
136
|
-
4. Dùng
|
|
137
|
-
5.
|
|
139
|
+
1. Tìm `codedao12` và thêm node **Zalo Login By QR**.
|
|
140
|
+
2. Chọn `n8n Zalo API Credential` bạn vừa tạo ở bước 1.
|
|
141
|
+
3. Chạy **Execute node** và QR sẽ được tạo ra.
|
|
142
|
+
4. Dùng Zalo trên điện thoại **quét mã QR** để đăng nhập.
|
|
143
|
+
5. Bạn sẽ không nhận được cảnh báo nào từ n8n, hãy F5 lại trình duyệt để nhận thấy `Zalo API Credential` đã được tạo.
|
|
138
144
|
|
|
139
|
-
> -
|
|
140
|
-
> - Truyền Telegram Bot Token sẽ
|
|
145
|
+
> - Hãy sử dụng nút `Zalo` bất kì để xem Credential có chưa.
|
|
146
|
+
> - Truyền Telegram Bot Token sẽ giúp bạn nhận được QR, báo login và lỗi trigger (phù hợp tự động hoá).
|
|
147
|
+
> - Tự động kiểm tra các Credential cũ có cùng UserId với tài khoản mới và **cập nhật lại credential**.
|
|
141
148
|
|
|
142
149
|
### Bước 3: Sử dụng các Node Zalo khác
|
|
143
150
|
|
|
@@ -149,15 +156,16 @@ Bây giờ bạn đã có thể sử dụng các node khác như `Zalo Trigger`,
|
|
|
149
156
|
|
|
150
157
|
### ✨ Chọn Zalo Credential bằng Biểu thức (Expression)
|
|
151
158
|
|
|
152
|
-
Khi bạn quản lý nhiều tài khoản Zalo, mỗi tài khoản sẽ có một `Zalo API Credential` riêng.
|
|
159
|
+
Khi bạn quản lý nhiều tài khoản Zalo, mỗi tài khoản sẽ có một `Zalo API Credential` riêng. Việc có thể Expresstion rất có ích và nhẹ kịch bản.
|
|
153
160
|
|
|
154
|
-
1. Trong một node Zalo
|
|
155
|
-
2.
|
|
161
|
+
1. Trong một node Zalo bật `Select a custom credential from ID`.
|
|
162
|
+
2. Chọn tài khoản trong danh sách đã lưu (credential mặc định sẽ không được sử dụng).
|
|
156
163
|
|
|
157
164
|
Điều này rất hữu ích để xây dựng các kịch bản tự động hóa phức tạp, ví dụ như gửi tin nhắn lần lượt từ nhiều tài khoản Zalo khác nhau trong cùng một workflow.
|
|
158
165
|
|
|
166
|
+
<br>
|
|
159
167
|
|
|
160
|
-
## 📦 Node
|
|
168
|
+
## 📦 Node Gôm Tin Nhắn
|
|
161
169
|
|
|
162
170
|
### 🕗 Message Debouncer
|
|
163
171
|
<details>
|
|
@@ -168,7 +176,9 @@ Khi bạn quản lý nhiều tài khoản Zalo, mỗi tài khoản sẽ có mộ
|
|
|
168
176
|
- Node được thiết kế phù hợp với nhiều nền tảng chatbot như Facebook, Telegram..
|
|
169
177
|
</details>
|
|
170
178
|
|
|
171
|
-
|
|
179
|
+
<br>
|
|
180
|
+
|
|
181
|
+
## 📦 Zalo Cá Nhân
|
|
172
182
|
|
|
173
183
|
### 1. 🔑 Zalo Login By QR
|
|
174
184
|
<details>
|
|
@@ -217,6 +227,7 @@ Khi bạn quản lý nhiều tài khoản Zalo, mỗi tài khoản sẽ có mộ
|
|
|
217
227
|
- **Tiện ích khác:** Tạo bình chọn (Poll), quản lý thẻ phân loại (Tag), tìm kiếm Sticker.
|
|
218
228
|
</details>
|
|
219
229
|
|
|
230
|
+
<br>
|
|
220
231
|
|
|
221
232
|
## ⚠️ Lưu ý quan trọng (Đọc kỹ trước khi dùng)
|
|
222
233
|
|
|
@@ -229,12 +240,12 @@ Khi bạn quản lý nhiều tài khoản Zalo, mỗi tài khoản sẽ có mộ
|
|
|
229
240
|
- Sử dụng tài khoản test, không dùng tài khoản chính.
|
|
230
241
|
- Tuân thủ giới hạn rate limit của Zalo, có trách nhiệm và không spam
|
|
231
242
|
|
|
232
|
-
|
|
243
|
+
<br>
|
|
233
244
|
|
|
234
245
|
## 🙏 Lời cảm ơn
|
|
235
246
|
Dự án tham khảo từ **zca-js** và các nodes n8n có sẵn — xin cảm ơn vì đóng góp.
|
|
236
247
|
|
|
237
|
-
|
|
248
|
+
<br>
|
|
238
249
|
|
|
239
250
|
## 📄 License
|
|
240
251
|
[MIT](https://github.com/n8n-io/n8n-nodes-starter/blob/master/LICENSE.md)
|