n8n-nodes-zalo-custom 1.0.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2022 n8n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,235 @@
+# n8n-nodes-zalo-custom
+
+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**.
+
+Đâ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.
+## 📱 Liên hệ & Hỗ trợ
+
+**Github:** [codedao12](https://github.com/codedao12)  
+**Email:** codedao12@gmail.com  
+**Nhóm Zalo hỗ trợ:** [Tham gia nhóm Zalo](https://zalo.me/g/uinmin927)  
+Vui lòng liên hệ để yêu cầu tính năng mới hoặc báo lỗi.
+
+
+## ✨ Các Tính Năng Chính
+
+| Trạng thái | Tính Năng                                         |
+ | :---: |:--------------------------------------------------|
+|🔑 | **Xác thực & Kết nối**                            |
+| ✅ | Đăng nhập bằng Mã QR                              |
+| ✅ | Chọn Zalo Credential bằng biểu thức               |
+| ✅ | Hỗ trợ đăng nhập nhiều tài khoản                  |
+| ✅ | Hỗ trợ Proxy                                      |
+| ✅ | Thông báo (QR, lỗi) qua Telegram                  |
+|⚡️ | **Trigger - Lắng nghe sự kiện**                   |
+| ✅ | Sự kiện tin nhắn mới (lọc theo từ khóa, nhóm)     |
+| ✅ | Sự kiện thu hồi tin nhắn, thả cảm xúc             |
+| ✅ | Sự kiện về bạn bè (kết bạn, hủy bạn)              |
+| ✅ | Sự kiện trong nhóm (tham gia, rời, đổi quyền,...) |
+|💬 | **Gửi & Nhận Tin nhắn**                           |
+| ✅ | Gửi tin nhắn (Văn bản, Ảnh, Sticker)              |
+| ✅ | Trả lời tin nhắn (Quote)                          |
+| ✅ | Gắn thẻ (Tag) thành viên trong nhóm               |
+| ✅ | Thả/Gỡ cảm xúc (Reaction) vào tin nhắn            |
+| ✅ | Thu hồi tin nhắn đã gửi                           |
+| ✅ | Mô phỏng trạng thái "Đang soạn tin..."            |
+| 👤| **Quản lý Bạn bè & Người dùng**                   |
+| ✅ | Gửi / Hủy lời mời kết bạn                         |
+| ✅ | Chấp nhận / Từ chối lời mời kết bạn               |
+| ✅ | Hủy kết bạn (xóa bạn)                             |
+| ✅ | Lấy danh sách bạn bè & lời mời đã gửi             |
+| ✅ | Tìm người dùng bằng SĐT hoặc User ID              |
+| ✅ | Lấy thông tin chi tiết người dùng                 |
+| ✅ | Cập nhật thông tin cá nhân (Tên, Giới tính,...)   |
+| ✅ | Chặn / Bỏ chặn người dùng                         |
+| 👥| **Quản lý Nhóm**                                  |
+| ✅ | Tạo nhóm mới                                      |
+| ✅ | Thêm / Xóa thành viên khỏi nhóm                   |
+| ✅ | Giải tán nhóm                                     |
+| ✅ | Thay đổi tên & ảnh đại diện nhóm                  |
+| ✅ | Bổ nhiệm / Bãi nhiệm quyền Phó nhóm               |
+| ✅ | Chuyển quyền Trưởng nhóm                          |
+| ✅ | Lấy danh sách tất cả các nhóm đã tham gia         |
+| ✅ | Lấy thông tin chi tiết và thành viên nhóm         |
+| ✅ | Tham gia nhóm bằng link / Rời nhóm                |
+| ✅ | Tạo ghi chú (Note) trong nhóm                     |
+| 🎨| **Tính năng khác**                                |
+| ✅ | Tạo bình chọn (Poll) trong nhóm                   |
+| ✅ | Quản lý thẻ phân loại (Tag)                       |
+
+[//]: # (| Bãi nhiệm quyền Phó nhóm | ✅ |)
+
+---
+
+## 🚀 Hướng Dẫn Cài Đặt
+
+### 1. Cài qua **Community Nodes** _(Khuyến nghị)_
+
+> Yêu cầu phiên bản n8n v0.187 trở lên.
+
+1.  Mở **n8n Editor**.
+2.  Đi đến **Settings → Community Nodes**.
+3.  Chọn tab **Install** và tìm kiếm `n8n-nodes-zalo-custom`.
+4.  Nhấn nút **Install** để cài đặt.
+5.  Sau khi cài đặt thành công, n8n sẽ tự động tải lại và các node Zalo sẽ xuất hiện trong danh sách node.
+
+---
+
+### 2. Cài thủ công
+
+Nếu bạn đang tự host n8n, bạn có thể cài đặt bộ node này qua `npm`:
+
+```bash
+# Điều hướng đến thư mục cài đặt n8n của bạn
+cd ~/.n8n/custom
+# Hoặc thư mục khác nếu bạn cấu hình biến môi trường NODE_FUNCTION_PATH
+
+# Cài đặt package
+npm install n8n-nodes-zalo-custom
+```
+
+---
+
+## 💡 Hướng Dẫn Sử Dụng
+
+Để 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.
+
+### Bước 1: Tạo n8n API Credential
+
+Node `Zalo Login By QR` cần quyền truy cập API vào n8n instance của bạn để có thể **tự động tạo ra Zalo Credential** sau khi bạn đăng nhập thành công.
+
+1.  **Lấy API Key của n8n:**
+    *   Trong giao diện n8n, đi đến **Settings → API**.
+    *   Nhấn **Add API key** để tạo một API key mới và sao chép nó (đổi tên API Zalo để gợi nhớ).
+
+2.  **Tạo `n8n Zalo API Credential`:**
+    *   Trong giao diện n8n, đi đến **Credentials → Add credential**.
+    *   Tìm và chọn **n8n Zalo API Credential**.
+    *   **API Key**: Dán API key bạn vừa tạo.
+    *   **URL**: Nhập URL của n8n instance của bạn (ví dụ: `http://127.0.0.1:5678` hoặc `https://n8n.yourdomain.com`).
+    *   Nhấn **Save**.
+
+### Bước 2: Đăng nhập Zalo bằng QR Code
+
+1.  Tạo một workflow mới và thêm node **Zalo Login By QR**.
+2.  Trong node này, chọn `n8n Zalo API Credential` bạn vừa tạo ở bước 1.
+3.  **Chạy (Execute) node**. Một mã QR sẽ được tạo ra.
+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.
+5.  Sau khi đăng nhập thành công, một `Zalo API Credential` mới** đã được tạo.
+
+> - 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.  
+> - 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.
+
+### Bước 3: Sử dụng các Node Zalo khác
+
+Bây giờ bạn đã có thể sử dụng các node khác như `Zalo Trigger`, `Zalo Send Message`, `Zalo User`...
+
+1.  Thêm node `Zalo Trigger` hoặc `Zalo Send Message` vào workflow.
+2.  Trong phần **Credential to connect with**, chọn `Zalo API Credential` vừa được tạo tự động ở bước 2.
+3.  Cấu hình các tham số khác và chạy workflow.
+
+### ✨ Chọn Zalo Credential bằng Biểu thức (Expression)
+
+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. Các node (như `Zalo Send Message`, `Zalo User`, `Zalo Group`) cho phép bạn chọn credential một cách linh hoạt bằng cách sử dụng Biểu thức (Expression).
+
+1.  Trong một node Zalo (ví dụ: `Zalo Send Message`), bên dưới Credential, chọn `Select a custom credential from ID`.
+2.  Bạn có thể truyền **User ID** hoặc **Phone** (credential mặc định sẽ không được sử dụng).
+
+Đ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.
+
+
+---
+
+## 📦 Các Node Có Sẵn
+
+### 🔑 Zalo Login By QR
+<details>
+<summary><b>tạo mã QR để đăng nhập Zalo</b></summary>
+
+- Đăng nhập vào Zalo bằng mã QR (hỗ trợ proxy).
+- Hỗ trợ đăng nhập nhiều tài khoản.
+- Thông báo và gửi QR qua telegram.
+- Lưu thông tin đăng nhập để thay thế credential.
+</details>
+
+---
+
+### ⚡️ Zalo Trigger
+<details>
+<summary><b>nhận sự kiện từ Zalo để phản hồi</b></summary>
+
+- **Lắng nghe sự kiện**: tin nhắn người dùng/nhóm, thả tim, thu hồi tin nhắn, lời mời kết bạn.
+- **Cấu hình**:
+  - Chấp nhận hoặc loại trừ các ID nhóm khi nhận sự kiện tin nhắn.
+  - Chỉ nhận theo từ khoá hoặc loại trừ khi nhận sự kiện tin nhắn.
+  - Lắng nghe sự kiện của chính bạn.
+  - Nhận thông báo qua telegram nếu Zalo lỗi đăng nhập.
+</details>
+
+---
+
+### 💬 Zalo Send Message
+<details>
+<summary><b>gửi tin nhắn</b></summary>
+
+- Gửi tin nhắn văn bản (hỗ trợ HTML), hình ảnh, sticker.
+- Trả lời tin nhắn (quote), thả biểu tượng cảm xúc (reaction), tag thành viên.
+- Mô phỏng hành động "Đang soạn tin...".
+</details>
+
+---
+
+### 4. 👥 Zalo Group
+<details>
+<summary><b>quản lý nhóm</b></summary>
+
+- **Quản lý nhóm:** Tạo nhóm, đổi tên & ảnh đại diện, lấy link mời, tham gia/rời nhóm, giải tán nhóm.
+- **Quản lý thành viên:** Thêm/xóa thành viên, bổ nhiệm/bãi nhiệm phó nhóm, chuyển quyền trưởng nhóm.
+- **Lấy thông tin:** Lấy danh sách tất cả các nhóm đã tham gia, lấy thông tin chi tiết và thành viên của một nhóm.
+- **Tương tác khác:** Tạo ghi chú (note) mới trong nhóm.
+</details>
+
+---
+
+### 5. 👤 Zalo User
+<details>
+<summary><b>quản lý tài khoản và bạn bè</b></summary>
+
+- **Quản lý bạn bè:** Gửi/hủy lời mời kết bạn, chấp nhận/từ chối lời mời, hủy kết bạn.
+- **Tương tác với người dùng:** Thu hồi tin nhắn, chặn/bỏ chặn, đổi tên gợi nhớ, đánh dấu đã đọc/chưa đọc.
+- **Lấy thông tin:** Lấy danh sách bạn bè, gợi ý kết bạn, thông tin chi tiết người dùng (qua User ID/SĐT), lấy mã QR.
+- **Cập nhật hồ sơ:** Thay đổi thông tin cá nhân của bạn (tên, ngày sinh, giới tính).
+</details>
+
+---
+### 6. 🎨 Zalo Communication
+<details>
+<summary><b>thẻ phân loại và bình chọn nhóm</b></summary>
+
+- **Sticker (Nhãn dán):** Gửi, tìm kiếm, và lấy danh sách các bộ sticker đã cài.
+- **Poll (Bình chọn):** Tạo, lấy thông tin, hoặc khóa một bình chọn trong nhóm.
+- **Tag (Thẻ phân loại):** Quản lý các thẻ phân loại cho cuộc trò chuyện (tạo, sửa, xóa, gán/gỡ thẻ).
+</details>
+
+---
+
+## ⚠️ Lưu ý quan trọng (Đọc kỹ trước khi dù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, có trách nhiệm và không spam
+
+---
+
+## 🙏 Lời cảm ơn
+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.
+
+---
+
+## 📄 License
+[MIT](https://github.com/n8n-io/n8n-nodes-starter/blob/master/LICENSE.md)

package/credentials/N8nZaloApi.credentials.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N8nZaloApi = void 0;
+class N8nZaloApi {
+    constructor() {
+        this.name = 'n8nZaloApi';
+        this.displayName = 'n8n Zalo API Credential';
+        this.documentationUrl = 'n8n-n8n-api';
+        this.icon = 'file:shared/n8n.png';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                default: '',
+                description: 'The API key used to authenticate with the n8n API.',
+                required: true,
+                typeOptions: {
+                    password: true,
+                },
+            },
+            {
+                displayName: 'URL',
+                name: 'url',
+                type: 'string',
+                default: 'http://127.0.0.1:5678',
+                description: 'The URL of the n8n instance. Example: "http://127.0.0.1:5678" or "https://domain.vn"',
+                required: true,
+            }
+        ];
+    }
+}
+exports.N8nZaloApi = N8nZaloApi;

package/credentials/ZaloApi.credentials.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZaloApi = void 0;
+class ZaloApi {
+    constructor() {
+        this.name = 'zaloApi';
+        this.displayName = 'Zalo API';
+        this.documentationUrl = 'https://developers.zalo.me/docs';
+        this.icon = 'file:shared/zalo.svg';
+        this.properties = [
+            {
+                displayName: 'Name Account',
+                name: 'nameAccount',
+                type: 'string',
+                default: '',
+                description: 'Zalo user id',
+            },
+            {
+                displayName: 'User ID',
+                name: 'userId',
+                type: 'string',
+                default: '',
+                description: 'Zalo user id',
+            },
+            {
+                displayName: 'Phone Number',
+                name: 'phoneNumber',
+                type: 'string',
+                default: '',
+                description: 'Zalo Phone Number',
+            },
+            {
+                displayName: 'Proxy',
+                name: 'proxy',
+                type: 'string',
+                default: '',
+                placeholder: 'http(s)://user:pass@host:port',
+                description: 'HTTP proxy to use for Zalo API requests',
+            },
+            {
+                displayName: 'Telegram Bot Token',
+                name: 'telegramToken',
+                type: 'string',
+                default: '',
+                typeOptions: {
+                    password: true,
+                },
+                description: 'Telegram bot token',
+            },
+            {
+                displayName: 'Telegram Chat ID',
+                name: 'telegramChatId',
+                type: 'string',
+                default: '',
+                description: 'Telegram chat_id to send notifications to',
+            },
+            {
+                displayName: 'Cookie',
+                name: 'cookie',
+                type: 'string',
+                default: '',
+                typeOptions: {
+                    password: true,
+                },
+                description: 'Cookie from Zalo login session',
+            },
+            {
+                displayName: 'IMEI',
+                name: 'imei',
+                type: 'string',
+                default: '',
+                typeOptions: {
+                    password: true,
+                },
+                description: 'IMEI identifier from Zalo login session',
+            },
+            {
+                displayName: 'User Agent',
+                name: 'userAgent',
+                type: 'string',
+                default: '',
+                description: 'User Agent from Zalo login session',
+                typeOptions: {
+                    password: true,
+                },
+            },
+            {
+                displayName: 'Support Code',
+                name: 'supportCode',
+                type: 'string',
+                default: '',
+                description: 'Support code for Zalo API',
+            },
+            {
+                displayName: 'License Key',
+                name: 'licenseKey',
+                type: 'string',
+                default: '',
+                description: 'License key for Zalo API',
+                typeOptions: {
+                    password: true,
+                },
+            },
+        ];
+    }
+}
+exports.ZaloApi = ZaloApi;

package/credentials/shared/zalo.svg

@@ -0,0 +1,10 @@
+<svg width="50" height="50" viewBox="0 0 50 50" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M22.782 0.166016H27.199C33.2653 0.166016 36.8103 1.05701 39.9572 2.74421C43.1041 4.4314 45.5875 6.89585 47.2557 10.0428C48.9429 13.1897 49.8339 16.7347 49.8339 22.801V27.1991C49.8339 33.2654 48.9429 36.8104 47.2557 39.9573C45.5685 43.1042 43.1041 45.5877 39.9572 47.2559C36.8103 48.9431 33.2653 49.8341 27.199 49.8341H22.8009C16.7346 49.8341 13.1896 48.9431 10.0427 47.2559C6.89583 45.5687 4.41243 43.1042 2.7442 39.9573C1.057 36.8104 0.166016 33.2654 0.166016 27.1991V22.801C0.166016 16.7347 1.057 13.1897 2.7442 10.0428C4.43139 6.89585 6.89583 4.41245 10.0427 2.74421C13.1707 1.05701 16.7346 0.166016 22.782 0.166016Z" fill="#0068FF"/>
+<path opacity="0.12" fill-rule="evenodd" clip-rule="evenodd" d="M49.8336 26.4736V27.1994C49.8336 33.2657 48.9427 36.8107 47.2555 39.9576C45.5683 43.1045 43.1038 45.5879 39.9569 47.2562C36.81 48.9434 33.265 49.8344 27.1987 49.8344H22.8007C17.8369 49.8344 14.5612 49.2378 11.8104 48.0966L7.27539 43.4267L49.8336 26.4736Z" fill="#001A33"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M7.779 43.5892C10.1019 43.846 13.0061 43.1836 15.0682 42.1825C24.0225 47.1318 38.0197 46.8954 46.4923 41.4732C46.8209 40.9803 47.1279 40.4677 47.4128 39.9363C49.1062 36.7779 50.0004 33.22 50.0004 27.1316V22.7175C50.0004 16.629 49.1062 13.0711 47.4128 9.91273C45.7385 6.75436 43.2461 4.28093 40.0877 2.58758C36.9293 0.894239 33.3714 0 27.283 0H22.8499C17.6644 0 14.2982 0.652754 11.4699 1.89893C11.3153 2.03737 11.1636 2.17818 11.0151 2.32135C2.71734 10.3203 2.08658 27.6593 9.12279 37.0782C9.13064 37.0921 9.13933 37.1061 9.14889 37.1203C10.2334 38.7185 9.18694 41.5154 7.55068 43.1516C7.28431 43.399 7.37944 43.5512 7.779 43.5892Z" fill="white"/>
+<path d="M20.5632 17H10.8382V19.0853H17.5869L10.9329 27.3317C10.7244 27.635 10.5728 27.9194 10.5728 28.5639V29.0947H19.748C20.203 29.0947 20.5822 28.7156 20.5822 28.2606V27.1421H13.4922L19.748 19.2938C19.8428 19.1801 20.0134 18.9716 20.0893 18.8768L20.1272 18.8199C20.4874 18.2891 20.5632 17.8341 20.5632 17.2844V17Z" fill="#0068FF"/>
+<path d="M32.9416 29.0947H34.3255V17H32.2402V28.3933C32.2402 28.7725 32.5435 29.0947 32.9416 29.0947Z" fill="#0068FF"/>
+<path d="M25.814 19.6924C23.1979 19.6924 21.0747 21.8156 21.0747 24.4317C21.0747 27.0478 23.1979 29.171 25.814 29.171C28.4301 29.171 30.5533 27.0478 30.5533 24.4317C30.5723 21.8156 28.4491 19.6924 25.814 19.6924ZM25.814 27.2184C24.2785 27.2184 23.0273 25.9672 23.0273 24.4317C23.0273 22.8962 24.2785 21.645 25.814 21.645C27.3495 21.645 28.6007 22.8962 28.6007 24.4317C28.6007 25.9672 27.3685 27.2184 25.814 27.2184Z" fill="#0068FF"/>
+<path d="M40.4867 19.6162C37.8516 19.6162 35.7095 21.7584 35.7095 24.3934C35.7095 27.0285 37.8516 29.1707 40.4867 29.1707C43.1217 29.1707 45.2639 27.0285 45.2639 24.3934C45.2639 21.7584 43.1217 19.6162 40.4867 19.6162ZM40.4867 27.2181C38.9322 27.2181 37.681 25.9669 37.681 24.4124C37.681 22.8579 38.9322 21.6067 40.4867 21.6067C42.0412 21.6067 43.2924 22.8579 43.2924 24.4124C43.2924 25.9669 42.0412 27.2181 40.4867 27.2181Z" fill="#0068FF"/>
+<path d="M29.4562 29.0944H30.5747V19.957H28.6221V28.2793C28.6221 28.7153 29.0012 29.0944 29.4562 29.0944Z" fill="#0068FF"/>
+</svg>