Nhận dự án mới tháng 11/2026 · phản hồi trong ngày làm việcZalo · GitHub

Nối n8n với Zalo: nhận tin, trả lời và ghi vào CRM

Kỹ thuật viên dựng luồng tự động nối tin nhắn khách với phần mềm quản lý

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.

Tin khách vào OA, webhook đẩy sang n8n, n8n phân loại, trả lời qua API và ghi khách vào CRM
Luồng n8n nối Zalo: tin khách vào OA, webhook đẩy sang n8n, n8n phân loại, trả lời qua API và ghi khách vào CRM.
WorkflowViệcNode chính trong n8n
Luồng chínhNhận tin, kiểm chữ ký, bỏ trùng, phân loại, trả lời, ghi CRMWebhook, Crypto, If, Remove Duplicates, Switch, HTTP Request, Google Sheets
Luồng tokenLàm mới access token, lưu cặp token mớiSchedule Trigger, HTTP Request, node cơ sở dữ liệu
Luồng lỗiBáo người phụ trách khi workflow hỏngError 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ưuNode n8nGhi chú
Google Sheets (đội nhỏ, chưa có CRM)Google Sheets, Append or Update RowCột khoá là user_id, mỗi khách một dòng
CRM có node sẵnVí dụ node HubSpot, OdooĐọc tài liệu node của CRM đó
CRM có API riêngHTTP RequestHỏ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:

  1. 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.
  2. Đọ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ý).
  3. HTTP Request POST https://oauth.zaloapp.com/v4/oa/access_token, header secret_key: <KHOA_BI_MAT_UNG_DUNG>, Body Content Type là Form URLencoded với refresh_token, app_id, grant_type=refresh_token.
  4. 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, total dừ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.

Lộc Nguyễn

Dựng đội agent làm việc thật cho doanh nghiệp. Viết lại những gì đã làm, có số đo kèm theo.

Về tác giả →

Khoá Claude miễn phí cho người không rành kỹ thuật

8 bài, làm theo từng bước: từ lần đầu mở Claude đến nối Zalo, bảng tính và email. Để lại email, nhận bài 1 ngay.

n8n Zalo: nhận tin OA, trả lời và ghi khách vào CRM