n8n-nodes-zalo-user-free

Take full control of your Zalo automation with n8n-nodes-zalo-user-free—a dedicated n8n node designed to work entirely within your n8n instance. No third-party APIs, no external dependencies—just pure workflow automation with your data staying private and secure.

This node simulates a browser to interact with Zalo Web, enabling seamless automation directly inside n8n.

⚠️ Warning: This approach may violate Zalo's policies and could lead to account restrictions. Use at your own risk. We take no responsibility for any consequences.

Installation

Follow these instructions to install this node:

Community Nodes (Recommended)

For users on n8n v0.187+, you can install this node directly from the n8n Community Nodes panel in the n8n editor.

1. Open your n8n editor.
2. Go to Settings > Community Nodes.
3. Search for "n8n-nodes-zalo-user-free".
4. Click Install.
5. Reload the editor.

Manual Installation

You can also install this node manually:

cd YOUR_N8N_INSTALLATION_DIRECTORY
npm install n8n-nodes-zalo-user-free

Operations

This node supports the following operations, providing (unofficial) APIs to help you build a Zalo chatbot using your personal account.

Credentials

Disclaimer

This node is not affiliated with Zalo in any way. Using this API could result in your account being locked or banned. We are not responsible for any issues that may arise. Use it at your own risk.

n8n-nodes-zalo-user-free connects to Zalo via the Zalo Web. However, Zalo only allows one active browser session at a time. If you connect n8n-nodes-zalo-user-free and then log into Zalo on another browser (or a similar method), the connection will be interrupted. To reconnect, simply update your credentials and reconnect.

Troubleshooting Zalo User Trigger Node Issues

If the Zalo User Trigger Node stops working, it could be because:

• You logged into Zalo on another browser.
• Zalo detected unusual activity and blocked data transmission.

How to fix it:

✅ If other interactions are still working: Turn the workflow off and back on.
🔄 If everything is disrupted: Reauthorize your credentials → Turn the workflow off → Turn it back on.

Resources

• n8n Community Nodes Documentation
• n8n-nodes-zalo-vn
• zca-js

Hướng dẫn sử dụng node ZaloUserInteract

1. Tổng quan

Node ZaloUserInteract cho phép gửi tin nhắn, quản lý bạn bè, nhóm, bình chọn, tạo TTS (Text-to-Speech) và nhiều thao tác khác trên Zalo thông qua n8n.

2. Các nhóm chức năng & thao tác

A. Message (Tin nhắn)

• Gửi tin nhắn văn bản, sticker, tin nhắn thoại tới người dùng hoặc nhóm.
• Các trường quan trọng: threadId (ID người nhận/nhóm), threadType (User/Group), message, attachmentsUrls, stylesParameter, mentionsParameter, quoteParameter, urgency.

Ví dụ gửi tin nhắn văn bản:

• Resource: Message
• Operation: Send Message
• threadId: 1234567890
• threadType: User
• message: Xin chào từ n8n!
• attachmentsUrls: /files/anh.png,https://example.com/file.pdf (tùy chọn)
• stylesParameter: Bold, Italic (tùy chọn)
• mentionsParameter: [{"userId":"9876543210","offset":0,"length":5}] (tùy chọn)

Ví dụ gửi sticker:

• Resource: Message
• Operation: Send Sticker Message
• threadId: 9876543210
• threadType: Group
• stickerKeywords: cute

B. Friend (Bạn bè)

• Gửi lời mời kết bạn, chấp nhận, hủy lời mời, tìm bạn qua số điện thoại hoặc userId.

Ví dụ gửi lời mời kết bạn qua số điện thoại:

• Resource: Friend
• Operation: Send Friend Request With Phone Number
• phoneNumber: 0987654321

C. Group (Nhóm)

• Thêm/xóa thành viên, đổi tên nhóm, tạo nhóm, giải tán nhóm, thêm/xóa phó nhóm, tạo bình chọn, khóa bình chọn, lấy chi tiết bình chọn.

Ví dụ thêm thành viên vào nhóm bằng số điện thoại:

• Resource: Group
• Operation: Add User To Group With Phone Number
• groupId: 1234567890
• phoneNumber: 0987654321

Ví dụ tạo bình chọn trong nhóm:

• Resource: Group
• Operation: Create Poll
• groupId: 1234567890
• pollQuestion: Họp ở đâu?
• pollOptions: Cafe,Office,Online
• pollAllowMultiChoices: true
• pollIsAnonymous: false

D. Get (Lấy thông tin)

• Lấy danh sách bạn bè, nhóm, thông tin nhóm/người dùng, tìm người dùng, lấy thông tin tài khoản, context.

Ví dụ lấy danh sách bạn bè:

• Resource: Get
• Operation: Get All Friends

E. Tool (Công cụ)

• Tạo file âm thanh từ văn bản (TTS).

Ví dụ tạo TTS:

• Resource: Tool
• Operation: Create TTS
• text: Xin chào, đây là tin nhắn từ n8n!
• voice: vi-VN-NamMinhNeural
• rate: 0%
• volume: 0%
• pitch: 0Hz

3. Giải thích các trường cấu hình

• Resource: Nhóm chức năng (Message, Friend, Group, Get, Tool)
• Operation: Thao tác cụ thể trong nhóm chức năng
• threadId: ID người nhận hoặc nhóm
• threadType: User hoặc Group
• message: Nội dung tin nhắn
• attachmentsUrls: Đường dẫn file đính kèm (cách nhau bằng dấu phẩy)
• stylesParameter: Định dạng văn bản (Bold, Italic, v.v.)
• mentionsParameter: Đề cập người dùng trong tin nhắn (dạng JSON)
• quoteParameter: Trích dẫn tin nhắn trước (dạng JSON)
• urgency: Độ ưu tiên tin nhắn (Default, Important, Urgent)
• userId, groupId, phoneNumber: ID hoặc số điện thoại
• members: Danh sách userId thêm vào nhóm (cách nhau bằng dấu phẩy)
• pollQuestion, pollOptions: Câu hỏi và các lựa chọn bình chọn (cách nhau bằng dấu phẩy)
• voiceUrl: Đường dẫn file âm thanh
• text, voice, rate, volume, pitch: Tham số TTS

4. Lưu ý

• Một số chức năng yêu cầu tài khoản Premium.
• File đính kèm có thể là đường dẫn local hoặc URL.
• Các trường nhiều giá trị dùng dấu phẩy để phân tách.
• Nếu gặp lỗi, kiểm tra log của n8n để biết chi tiết.

5. Hỗ trợ

Nếu cần thêm ví dụ hoặc giải thích chi tiết về trường nào, hãy liên hệ người phát triển node.