Webhook là một URL mà ứng dụng khác gọi tới để báo có sự kiện mới. Trong n8n, node Webhook tạo URL đó và khởi động workflow khi nhận request. Mỗi node có hai URL: Test URL chỉ nghe trong 120 giây sau khi bấm Listen for test event, còn Production URL chỉ hoạt động khi workflow đã Publish.
Bài này giải thích chức năng của node Webhook trong n8n, các thành phần cấu hình, ví dụ nhận dữ liệu form liên hệ rồi gửi email và trả phản hồi, cùng các giới hạn hay gây lỗi. Nội dung theo n8n 2.x, đối chiếu tài liệu node Webhook ngày 22/10/2026.
Webhook là gì và hoạt động thế nào trong n8n?
Webhook là cách một ứng dụng chủ động gửi dữ liệu sang ứng dụng khác ngay khi có sự kiện, bằng một request HTTP tới URL định sẵn. Bên nhận không phải hỏi đi hỏi lại “có gì mới không”, nên dữ liệu tới gần như tức thời.
Trong n8n, bạn thêm node Webhook làm trigger, chọn phương thức (thường là POST), đặt đường dẫn, và n8n cấp một URL riêng. Khi form trên website, Stripe, GitHub hay một hệ thống nội bộ gửi request tới URL này, node Webhook nhận dữ liệu và chuyển cho các node phía sau.
Ví dụ: ngay khi khách thanh toán thành công, cổng thanh toán gọi webhook của n8n; workflow ghi đơn vào Google Sheets và gửi email cảm ơn.
Chức năng chính của node Webhook trong n8n
Node Webhook có bốn chức năng: khởi động workflow theo sự kiện, nhận dữ liệu của request, trả phản hồi cho bên gọi và chặn request không hợp lệ bằng xác thực. Nhờ vậy, một workflow n8n có thể đóng vai endpoint API nhỏ mà không cần viết máy chủ riêng.
Kích hoạt workflow theo thời gian thực
Node Webhook là trigger: workflow chạy ngay khi có request tới, không cần lịch chạy định kỳ. Đây là điểm khác với Schedule Trigger, vốn chạy theo giờ đã đặt dù có dữ liệu mới hay không.
Nhận dữ liệu từ bên ngoài
Node Webhook nhận các phương thức DELETE, GET, HEAD, PATCH, POST, PUT. Mỗi request thành một item gồm bốn phần: headers, params, query và body. Dữ liệu form hay JSON gửi bằng POST nằm trong body, nên node phía sau phải lấy bằng {{ $json.body.ten_truong }}.

Phản hồi lại nơi gửi
Node Webhook quyết định trả gì cho bên gọi: trả ngay, trả kết quả node cuối, hoặc để node Respond to Webhook tùy chỉnh mã trạng thái, header và nội dung. Phần cấu hình Respond ở dưới.
Bảo mật và xác thực
Node Webhook hỗ trợ Basic auth, Header auth, JWT auth, giới hạn địa chỉ IP gọi tới và bỏ qua bot. Webhook nhận dữ liệu thật nên bật xác thực trước khi Publish.
Node Webhook và node HTTP Request khác nhau thế nào?
Node Webhook chờ request từ bên ngoài gửi vào n8n, còn node HTTP Request chủ động gửi request từ n8n ra API khác. Hai node thường đi cùng nhau: Webhook nhận sự kiện, HTTP Request gọi tiếp sang hệ thống khác.
Tiêu chí Node Webhook Node HTTP Request Chiều dữ liệu Bên ngoài gửi vào n8n n8n gửi ra API bên ngoài Vai trò trong workflow Trigger, đứng đầu workflow Node hành động, chạy khi node trước chạy xong Khi nào dùng Nhận sự kiện: đơn hàng mới, form gửi, commit code, tin nhắn từ chatbot Lấy dữ liệu (thời tiết, CRM) hoặc gửi dữ liệu (tạo bản ghi, gửi tin) Cần gì URL công khai mà bên gửi truy cập được (tên miền + HTTPS khi tự host) Địa chỉ API và thông tin xác thực nếu API yêu cầu Xác thực Bạn đặt xác thực để chặn người gọi lạ Bạn gửi thông tin xác thực mà API kia yêu cầu
Các thành phần cấu hình của node Webhook
Node Webhook có sáu nhóm cấu hình: hai URL (Test và Production), HTTP Method, Path, Authentication, Respond và Options. Bốn nhóm đầu quyết định ai gọi được webhook và gọi vào đâu; Respond và Options quyết định n8n trả lời ra sao và lọc request thế nào.
Test URL và Production URL
Mỗi node Webhook có hai URL dùng cho hai giai đoạn khác nhau. Theo trang Common issues của node Webhook:
- Test URL (dạng
/webhook-test/...): hoạt động trong 120 giây sau khi bấm Listen for test event. Dữ liệu nhận được hiện ngay trên canvas để bạn map trường. - Production URL (dạng
/webhook/...): hoạt động khi workflow đã Publish. Dữ liệu không hiện trên canvas; xem ở tab Executions của workflow.
Ở n8n 2.x, nút Publish thay cho công tắc Active/Inactive của bản 1.x (v2.0 breaking changes). Không dùng Test URL trong ứng dụng thật vì URL này chỉ nghe khi bạn đang bấm nghe thử.

HTTP Method
Chọn phương thức mà bên gửi dùng: GET, POST, PUT, PATCH, DELETE hoặc HEAD. Nếu một URL cần nhận nhiều phương thức, bật Allow Multiple HTTP Methods trong Settings của node. Gửi sai phương thức, n8n sẽ không nhận request đó.
Path
Path mặc định là chuỗi ngẫu nhiên để tránh trùng. Bạn có thể đặt path dễ đọc như contact-form, hoặc có tham số động như /:id, /order/:id; giá trị tham số nằm trong $json.params. Mỗi cặp path và method chỉ được một webhook trên cả instance.
Authentication
- None: không xác thực, chỉ dùng khi thử nghiệm.
- Basic auth: bên gửi kèm tên đăng nhập và mật khẩu.
- Header auth: bên gửi kèm một header bí mật, ví dụ
X-Webhook-Token. - JWT auth: bên gửi kèm JSON Web Token, n8n kiểm chữ ký bằng khóa bạn cấu hình.
Respond
Respond quyết định thời điểm và nội dung phản hồi cho bên gọi:
- Immediately: trả ngay mã phản hồi kèm thông điệp “Workflow got started”, workflow chạy tiếp phía sau.
- When Last Node Finishes: chờ workflow chạy xong, trả dữ liệu của node cuối. Response Data chọn trả mọi item, item đầu tiên dạng JSON, file nhị phân hoặc không có body.
- Using ‘Respond to Webhook’ Node: node Respond to Webhook ở vị trí bạn đặt sẽ trả phản hồi, tùy chỉnh được mã trạng thái, header, nội dung.
- Streaming response: trả dữ liệu dần trong lúc workflow chạy; cần node hỗ trợ streaming như AI Agent.

Options
- Allowed Origins (CORS): tên miền được phép gọi webhook từ trình duyệt; mặc định cho phép mọi nguồn.
- IP(s) Allowlist: chỉ nhận request từ IP trong danh sách, IP khác nhận lỗi 403. Sau reverse proxy, đặt biến
N8N_PROXY_HOPSbằng số proxy để n8n đọc đúng IP thật. - Ignore Bots: bỏ qua request của trình xem trước liên kết và bot thu thập dữ liệu.
- Only Run If: chỉ chạy workflow khi biểu thức đúng; request không khớp vẫn nhận 200 nhưng không tạo execution.
- Raw Body: nhận dữ liệu thô chưa phân tích, ví dụ JSON hoặc XML cần kiểm chữ ký.
- Binary Property: nhận file (ảnh, âm thanh, PDF) vào một thuộc tính nhị phân, áp dụng cho POST, PATCH, PUT.
- Response Headers, Response Content-Type: thêm header và kiểu nội dung cho phản hồi.
Cách sử dụng node Webhook trong n8n: ví dụ form liên hệ
Mục tiêu: form liên hệ trên website gửi dữ liệu tới n8n; n8n gửi email thông báo cho quản trị viên rồi trả JSON xác nhận cho form. Workflow gồm bốn node: Webhook → Edit Fields → Gmail → Respond to Webhook.

Bước 1: Tạo workflow và thêm node Webhook
Mở n8n (bản tự host trên VPS hoặc n8n Cloud), tạo workflow mới, đặt tên “Webhook – Contact Form”. Bấm thêm bước đầu tiên, tìm “webhook” và chọn node Webhook.

Bước 2: Cấu hình node Webhook
- HTTP Method:
POST, phù hợp với form gửi dữ liệu. - Path:
contact-form. - Authentication: để None khi thử; chuyển sang Header auth trước khi Publish.
- Respond:
Using 'Respond to Webhook' Node.

Bước 3: Lấy dữ liệu bằng node Edit Fields
Thêm node Edit Fields (Set) sau Webhook, chế độ Manual Mapping, bấm Add Field cho từng trường. Vì dữ liệu POST nằm trong body, giá trị phải trỏ vào $json.body:
Name = {{ $json.body.name }}
Email = {{ $json.body.email }}
Message = {{ $json.body.message }}
Nếu viết {{ $json.name }}, trường sẽ rỗng vì name không nằm ở cấp đầu của item. Tham số trên URL (sau dấu ?) thì lấy bằng $json.query.

Bước 4: Gửi email thông báo bằng node Gmail
Thêm node Gmail (hoặc Send Email nếu dùng SMTP), chọn credential, Operation Send. Điền To là hộp thư quản trị (ví dụ ten@example.com), Subject “New Contact Form Submission”, Message dùng dữ liệu từ Edit Fields:

Name: {{ $json.Name }}
Email: {{ $json.Email }}
Message: {{ $json.Message }}
Tên trường sau $json. phải trùng tên bạn đặt ở Edit Fields, kể cả chữ hoa chữ thường.
Bước 5: Trả phản hồi bằng Respond to Webhook
Thêm node Respond to Webhook cuối workflow, Respond With JSON, Response Body như dưới. Theo tài liệu Respond to Webhook, node còn có tùy chọn Response Code và Response Headers; nếu workflow có nhiều node Respond to Webhook, chỉ node chạy đầu tiên gửi phản hồi.
{
"status": "success",
"message": "Cảm ơn bạn đã liên hệ!"
}

Bước 6: Gửi dữ liệu thử tới Test URL
Bấm Execute workflow (hoặc Listen for test event ở node Webhook), rồi trong vòng 120 giây gửi request tới Test URL bằng curl hoặc Postman:
curl -X POST "https://n8n.ten-mien-cua-ban.vn/webhook-test/contact-form" \
-H "Content-Type: application/json" \
-d '{"name":"Nguyễn Văn A","email":"ten@example.com","message":"Đây là tin nhắn thử nghiệm"}'

Kiểm ba điều: canvas hiện dữ liệu ở từng node, email về đúng hộp thư, bên gửi nhận JSON phản hồi.

Bước 7: Publish và dùng Production URL
Bấm Publish ở góc trên bên phải canvas. Sau đó dán Production URL (/webhook/contact-form) vào form trên website. Mỗi lần form gửi sẽ tạo một execution; xem lại ở tab Executions, cách đọc có trong bài execution log trong n8n. Sửa workflow sau khi Publish chỉ là bản nháp, cần Publish lại thì bản production mới đổi.
Giới hạn và lỗi hay gặp với webhook n8n
Phần lớn lỗi webhook đến từ việc dùng nhầm URL, workflow chưa Publish, sai phương thức hoặc vượt giới hạn kích thước. Bản tự host còn hay gặp lỗi do reverse proxy: URL hiển thị sai tên miền, IP thật của bên gọi bị thay bằng IP proxy. Kiểm theo bảng sau:
Tình huống Nguyên nhân Cách xử lý Request trả 404, báo webhook chưa được đăng ký Gọi Test URL khi không bấm nghe thử, hoặc gọi Production URL khi workflow chưa Publish Bấm Listen for test event, hoặc Publish workflow Không nhận được dữ liệu Bên gửi dùng method khác (GET thay vì POST), sai path Đổi HTTP Method, bật Allow Multiple HTTP Methods nếu cần Lỗi payload quá lớn Mặc định mỗi request tối đa 16 MB Bản tự host đổi bằng biến N8N_PAYLOAD_SIZE_MAX; file lớn nên gửi qua lưu trữ rồi chuyển link URL hiển thị localhost:5678 n8n tự host sau reverse proxy chưa biết tên miền công khai Đặt N8N_WEBHOOK_URL (từ 2.30.0; WEBHOOK_URL bị đánh dấu deprecated từ 2.35.0) IP trong allowlist vẫn bị chặn n8n đứng sau proxy, đọc nhầm IP của proxy Đặt N8N_PROXY_HOPS bằng số reverse proxy Lỗi 524 trên n8n Cloud Webhook không phản hồi trong 100 giây Trả phản hồi sớm bằng Respond to Webhook, xử lý dài để chạy sau Hai workflow tranh một URL Mỗi cặp path và method chỉ một webhook Unpublish workflow cũ hoặc đổi path, method
Lỗi quá thời gian chờ ở phía bên gửi được phân tích kỹ hơn trong bài timeout trong n8n; các mã lỗi khác khi n8n gọi API ra ngoài có ở bảng mã lỗi API trong n8n.
Lưu ý khi dùng webhook trên n8n
- Bật xác thực trước khi Publish. Production URL là địa chỉ công khai; Header auth hoặc JWT auth chặn người gọi lạ, IP(s) Allowlist dùng khi bên gửi có IP cố định.
- Kiểm dữ liệu đầu vào. Bên thứ ba có thể gửi thiếu trường. Dùng node If hoặc Switch để rẽ nhánh và trả lỗi có kiểm soát, xem cách dùng node If và Switch.
- Phản hồi nhanh. Bên gửi thường có thời gian chờ ngắn. Đặt Respond to Webhook ngay sau bước kiểm dữ liệu, các bước tốn thời gian để phía sau.
- Trả mã trạng thái rõ ràng. Dùng Response Code 200 khi thành công, 400 khi dữ liệu thiếu, để bên gửi biết lỗi ở đâu.
- Tránh vòng lặp. Workflow tự gọi lại chính webhook của mình sẽ chạy không dứt; thêm điều kiện dừng.
Webhook là một trong các node cơ bản cần nắm khi tạo workflow trên n8n. Ví dụ thực tế khác có trong bài kết nối API Messenger với n8n qua webhook.
Những câu hỏi thường gặp
Vì sao gửi dữ liệu tới webhook mà không thấy phản hồi?
Kiểm theo thứ tự: workflow đã Publish chưa (nếu gọi Production URL); node Webhook có đặt Respond là Using ‘Respond to Webhook’ Node mà workflow lại không chạy tới node đó; node lỗi giữa chừng, xem tab Executions để biết node nào dừng.
Có test webhook n8n trên máy cá nhân được không?
Được, nhưng bên thứ ba ngoài Internet không gọi được localhost. Từ n8n 2.0, lệnh n8n –tunnel đã bị bỏ; dùng công cụ tunnel như ngrok hoặc Cloudflare Tunnel để có URL công khai tạm, hoặc chạy n8n trên VPS có tên miền và HTTPS.
Webhook n8n có nhận được file không?
Có. Bên gửi gửi multipart/form-data với phương thức POST, PUT hoặc PATCH; node Webhook lưu file vào thuộc tính nhị phân (Binary Property). Sau đó xử lý bằng node Extract from File, gửi tiếp bằng HTTP Request hoặc lưu lên Google Drive.
Một webhook có xử lý nhiều loại sự kiện được không?
Được. Nhiều dịch vụ gửi mọi sự kiện về một URL, kèm trường như event hoặc type. Dùng node Switch đọc trường đó để rẽ từng nhánh xử lý riêng.
Muốn chạy n8n 24/7 mà không tự cài? VPS n8n của Tino cài sẵn n8n trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.
