n8n chưa có node Zalo trong danh sách tích hợp chính thức (kiểm 09/11/2026), nên nối n8n với Zalo OA bằng các node lõi: Webhook nhận tin khách, Switch phân loại, HTTP Request gọi API gửi tin và API của CRM, Schedule Trigger làm mới token, Error Trigger báo lỗi. OA cần gói Tăng trưởng trở lên.
Bài Zalo OA API: lấy token, gửi tin và webhook đã nói phần API cho người lập trình: OAuth v4, PKCE, endpoint gửi tin, cấu trúc sự kiện webhook. Bài này không nhắc lại phần đó. Tôi đi vào một việc: dựng luồng trên n8n để tin khách nhắn vào OA được nhận, trả lời và ghi vào CRM, không viết ứng dụng riêng. Thứ tự: luồng tổng quan, chuẩn bị, bốn bước của luồng chính, hai luồng phụ (token và lỗi), rồi điểm bất lợi. Tên node và tham số lấy từ docs.n8n.io, endpoint lấy từ tài liệu Zalo for Developers, kiểm ngày 09/11/2026.
Luồng tổng quan: tin khách đi từ Zalo OA qua n8n vào CRM
Tôi tách việc nối Zalo thành ba workflow, mỗi workflow một việc. Gộp chung thì khi hỏng khó biết phần nào hỏng.

| Workflow | Việc | Node chính trong n8n |
|---|---|---|
| Luồng chính | Nhận tin, kiểm chữ ký, bỏ trùng, phân loại, trả lời, ghi CRM | Webhook, Crypto, If, Remove Duplicates, Switch, HTTP Request, Google Sheets |
| Luồng token | Làm mới access token, lưu cặp token mới | Schedule Trigger, HTTP Request, node cơ sở dữ liệu |
| Luồng lỗi | Báo người phụ trách khi workflow hỏng | Error Trigger, Telegram hoặc Gmail |
Chưa quen n8n thì đọc trước bài n8n là gì.
Chuẩn bị: node Zalo, gói OA và địa chỉ HTTPS
n8n có node Zalo không
Ngày 09/11/2026, danh sách hơn 260 node ứng dụng trên docs.n8n.io có Telegram, WhatsApp, Line nhưng không có Zalo. Vì vậy luồng dưới đây dùng node HTTP Request gọi thẳng API của Zalo.
Node cộng đồng (community node) cho Zalo thì cẩn thận. Trang rủi ro của community node (kiểm 09/11/2026) ghi: node cộng đồng có toàn quyền trên máy chạy n8n, đọc được dữ liệu trong workflow, và n8n chỉ kiểm một số node. Luồng giữ khoá bí mật của OA thì tôi không dùng node chưa xác minh.
Gói OA và ứng dụng Zalo
Trang bảng giá Zalo OA (kiểm 09/11/2026) ghi muốn liên kết ứng dụng với OA qua API thì cần gói Tăng trưởng hoặc gói cao hơn; gói Tăng trưởng giới hạn 100 request mỗi phút. Giá gói có ở bài Zalo OA có mất phí không. Cần thêm ứng dụng trên Zalo for Developers, khoá bí mật của ứng dụng và cặp token lấy lần đầu theo bài API ở trên.
n8n phải có địa chỉ HTTPS
Trang Giới thiệu về Webhook của Zalo (kiểm 09/11/2026) ghi Webhook URL nên dùng tên miền và phải có HTTPS, không dùng dạng host:port. Cách đặt n8n lên máy chủ có tên miền có ở bài n8n self-hosted bằng Docker.
Bước 1: node Webhook nhận sự kiện tin nhắn
Node đầu của luồng chính là Webhook. Theo tài liệu node Webhook (kiểm 09/11/2026), tôi đặt:
- HTTP Method:
POST, vì Zalo gửi sự kiện bằng POST dạng JSON. - Path: mặc định là chuỗi ngẫu nhiên; tự đặt thì chọn chuỗi khó đoán.
- Respond:
Immediately. Zalo yêu cầu trả mã 200 trong tối đa 2 giây; chọn «When Last Node Finishes» thì n8n chờ cả luồng xong mới trả lời, dễ quá hạn.
Test URL chỉ nghe khi anh chị bấm «Listen for Test Event»; Production URL chỉ được đăng ký khi workflow được publish. Dán Production URL vào ô Webhook URL trong trang cài đặt ứng dụng Zalo, bật sự kiện người dùng gửi tin nhắn. Đừng bật «Lọc cú pháp»: tài liệu Zalo ghi khi bật, webhook chỉ nhận tin văn bản bắt đầu bằng dấu #.
Dữ liệu vào nằm trong $json.body: sender.id là ID khách, event_name là loại tin (user_send_text, user_send_image, user_send_file…), message.text và message.msg_id. Header nằm trong $json.headers.
Kiểm chữ ký trước khi xử lý
Tài liệu sự kiện người dùng gửi tin nhắn ghi header X-ZEvent-Signature theo công thức mac = sha256(appId + data + timeStamp + OAsecretKey), với data là chuỗi JSON nhận được. Node Crypto của n8n có thao tác Hash, kiểu SHA256, mã hoá HEX hoặc BASE64; tính chuỗi băm rồi dùng node If so với header, không khớp thì dừng. Tài liệu không ghi rõ kết quả băm là hex hay base64 và timeStamp lấy từ đâu, nên tôi ghi lại vài sự kiện thật, thử ra cách ghép đúng rồi mới bật chặn. Chuỗi JSON phải giữ nguyên như Zalo gửi; node Webhook có tuỳ chọn Raw Body để nhận thân yêu cầu dạng thô.
Bỏ tin trùng
Khi không mở được kết nối tới webhook, Zalo gửi lại sau 30 giây, 5 phút, 15 phút, 30 phút và 1 giờ, header có thêm num_retry. Node Remove Duplicates, thao tác «Remove Items Processed in Previous Executions», so theo msg_id, bỏ tin đã xử lý ở lượt trước.
Bước 2: phân loại tin bằng Switch và If
Node Switch ở chế độ Rules, mỗi luật so event_name với một giá trị:
user_send_text: đi tiếp nhánh xử lý văn bản.user_send_image,user_send_file: không trả lời tự động, tạo việc cho nhân viên xem.- Loại khác: bật Fallback Output là Extra Output để ghi nhật ký, không bỏ rơi tin nào.
Ở nhánh văn bản, node If kiểm điều kiện chuỗi đơn giản, ví dụ tin có chữ «giá» hay «địa chỉ» thì trả lời bằng mẫu có sẵn, còn lại báo nhân viên. Tôi giữ phần tự trả lời thật hẹp: câu trả lời lạc đề tệ hơn chờ người thật năm phút.
Bước 3: trả lời khách bằng HTTP Request gọi API gửi tin tư vấn
Tài liệu Gửi tin Tư vấn dạng văn bản (kiểm 09/11/2026) có sẵn lệnh curl mẫu. Nút Import cURL của node HTTP Request dán được lệnh này để n8n tự điền. Sau khi nhập, node có dạng:
- Method:
POST; URL:https://openapi.zalo.me/v3.0/oa/message/cs. - Send Headers:
access_token=<MA_TRUY_CAP>, lấy từ nơi lưu token (luồng token bên dưới). - Send Body, Body Content Type là JSON:
{"recipient":{"user_id":"{{ $json.body.sender.id }}"},"message":{"text":"<NOI_DUNG>"}}. Nội dung tối đa 2.000 ký tự.
Phản hồi thành công có error bằng 0 và message_id. Dùng thêm một node If kiểm error, khác 0 thì đẩy sang nhánh báo nhân viên.
Hai điều kiện trong tài liệu Zalo: khách phải tương tác với OA trong vòng 7 ngày (trang Điều kiện gửi tin Tư vấn), và tin tư vấn miễn phí trong 48 giờ kể từ tương tác cuối, sau đó tính theo bảng giá (trang Tổng quan tin nhắn OA). Luồng trả lời tin vừa nhận luôn nằm trong khung miễn phí; nhánh nhắc lại khách sau vài ngày thì tốn tiền.
Bước 4: ghi khách vào CRM
Sự kiện webhook chỉ có ID khách. Tài liệu Truy xuất chi tiết người dùng (kiểm 09/11/2026) cho một node HTTP Request thứ hai: GET https://openapi.zalo.me/v3.0/oa/user/detail, tham số data={"user_id":"<USER_ID>"}, header access_token. Ứng dụng cần quyền quản lý thông tin người dùng. Kết quả có display_name, user_last_interaction_date, user_is_follower; số điện thoại, địa chỉ nằm trong shared_info khi khách đã chia sẻ.
Ghi vào đâu tuỳ CRM anh chị đang dùng:
| Nơi lưu | Node n8n | Ghi chú |
|---|---|---|
| Google Sheets (đội nhỏ, chưa có CRM) | Google Sheets, Append or Update Row | Cột khoá là user_id, mỗi khách một dòng |
| CRM có node sẵn | Ví dụ node HubSpot, Odoo | Đọc tài liệu node của CRM đó |
| CRM có API riêng | HTTP Request | Hỏi nhà cung cấp endpoint và cách xác thực |
Tối thiểu nên ghi: ID khách theo OA, tên hiển thị, thời điểm nhắn, tóm tắt, ai phụ trách, trạng thái. Tên và tin nhắn khách là dữ liệu cá nhân, chỉ chép trường cần dùng. Muốn so với một CRM nối sẵn, xem bài cũ ZaloCRM tích hợp Zalo OA, bài chatbot Zalo OA nối ZaloCRM và bài CRM cho Zalo cần có gì.
Luồng token: làm mới bằng Schedule Trigger
Theo tài liệu Xác thực và uỷ quyền của Zalo (kiểm 09/11/2026), access token sống 25 giờ, refresh token sống 3 tháng và chỉ dùng một lần; dùng xong, Zalo trả cặp mới và access token cũ hết hiệu lực ngay. Luồng token của tôi:
- Schedule Trigger, Trigger Interval là Hours, Hours Between Triggers đặt dưới 25, ví dụ 20. Phần Settings có tuỳ chọn «If Execution Is Missed» cho lượt bị lỡ khi máy tắt.
- Đọc refresh token hiện tại từ nơi lưu (node Postgres hoặc MySQL tới bảng do anh chị quản lý).
- HTTP Request
POST https://oauth.zaloapp.com/v4/oa/access_token, headersecret_key: <KHOA_BI_MAT_UNG_DUNG>, Body Content Type là Form URLencoded vớirefresh_token,app_id,grant_type=refresh_token. - Ghi ngay cặp token mới vào nơi lưu, trước mọi việc khác. Ghi hỏng sau khi đã làm mới là mất refresh token, phải nhờ quản trị viên OA cấp quyền lại.
Chỉ một workflow được làm mới token. Luồng chính chỉ đọc. Hai luồng cùng làm mới thì luồng sau cầm refresh token đã chết.
Luồng lỗi: báo người phụ trách bằng Error Trigger
Theo tài liệu Error Trigger (kiểm 09/11/2026): tạo workflow có Error Trigger làm node đầu, lưu lại; trong luồng chính và luồng token mở Options, Settings, chọn workflow đó ở ô Error workflow. Dữ liệu ra có execution.error.message, execution.lastNodeExecuted, workflow.name và execution.url (khi lượt chạy được lưu). Nối node Telegram hoặc Gmail để báo người phụ trách. Tài liệu ghi không thử được workflow lỗi khi chạy luồng bằng tay.
Lỗi tôi báo trước tiên là làm mới token thất bại: luồng chính hỏng thì mất vài tin, token chết thì mất cả luồng.
Điểm bất lợi khi nối Zalo bằng n8n
- Không có node chính thức. Mọi lời gọi là HTTP Request anh chị tự giữ; Zalo đổi API thì tự sửa. Ví dụ tài liệu gửi tin ghi trường
remain,totaldừng trả về sau 01/3/2026. - Webhook khắt khe. n8n tắt quá các mốc gửi lại thì Zalo huỷ đăng ký nhận sự kiện, phải xin lại quyền bằng tay. Máy chạy n8n cần chạy liên tục, có giám sát.
- Token dễ hỏng. Refresh token dùng một lần, lưu sai một lần là phải cấp quyền lại.
- Giới hạn gửi. Gói Tăng trưởng 100 request mỗi phút; ngoài khung 48 giờ tính phí; trang Tổng quan tin nhắn OA ghi hệ thống tự hạn chế luồng gửi có dấu hiệu làm phiền người dùng.
- Chỉ cho Zalo OA. Không áp dụng cho số Zalo cá nhân của nhân viên.
- Vẫn cần người hiểu kỹ thuật. Kéo thả nhanh, nhưng kiểm chữ ký, lưu token, đọc nhật ký lỗi cần một người làm được.
Câu hỏi thường gặp về nối n8n với Zalo
n8n có node Zalo chính thức không?
Tới ngày 09/11/2026 thì không. Dùng node HTTP Request gọi API Zalo OA; node cộng đồng thì cân nhắc kỹ.
Vì sao chạy thử nhận được tin mà bật thật thì không?
Thường do dán Test URL vào Zalo. Dán Production URL và publish workflow; lượt chạy thật xem ở tab Executions.
Có tự nhắn cho khách cũ bằng luồng này được không?
Chỉ khi khách tương tác với OA trong 7 ngày; sau 48 giờ từ tương tác cuối thì tính phí. Khách im lâu hơn thì phải dùng tin theo mẫu (ZNS), có bảng giá riêng.
Lưu access token ở đâu trong n8n?
Ở một bảng cơ sở dữ liệu do anh chị quản lý, chỉ luồng token được ghi. Không gõ cố định vào node, vì token đổi mỗi lần làm mới.
Nguồn: docs.n8n.io (các node trong bài, danh sách app node, rủi ro community node); developers.zalo.me (Webhook, sự kiện người dùng gửi tin, gửi tin Tư vấn, điều kiện gửi tin, tổng quan tin nhắn, chi tiết người dùng, xác thực và uỷ quyền); zalo.solutions/oa/pricing, kiểm ngày 09/11/2026.


