close

Node Webhook trong n8n là gì? Chức năng và cách sử dụng

Tác giả: Đông Tùng Ngày đăng: 08/05/2025 Chuyên mục: n8n
Disclosure
Website Tino blog được cung cấp bởi Tino Group. Truy cập và sử dụng website đồng nghĩa với việc bạn đồng ý với các điều khoản và điều kiện trong chính sách bảo mật - điều khoản sử dụng nội dung. Tino Group có thể thay đổi điều khoản sử dụng bất cứ lúc nào. Việc bạn tiếp tục sử dụng Tino blog sau khi thay đổi có nghĩa là bạn chấp nhận những thay đổi đó.
Why Trust Us
Các bài viết với hàm lượng tri thức cao tại Tino blog được tạo ra bởi các chuyên viên Marketing vững chuyên môn và được kiểm duyệt nghiêm túc theo chính sách biên tập bởi đội ngũ biên tập viên dày dặn kinh nghiệm. Mọi nỗ lực của chúng tôi đều hướng đến mong muốn mang đến cho cộng đồng nguồn thông tin chất lượng, chính xác, khách quan, đồng thời tuân thủ các tiêu chuẩn cao nhất trong báo cáo và xuất bản.

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 }}.

Cấu trúc dữ liệu đầu ra của node Webhook trong n8n: request POST tới /webhook/contact-form?src=web với JSON name, email, message; item đầu ra có body lấy bằng $json.body.name, query lấy bằng $json.query.src, headers và params; viết $json.name ngay sau Webhook sẽ ra rỗng

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 WebhookNode HTTP Request
Chiều dữ liệuBên ngoài gửi vào n8nn8n gửi ra API bên ngoài
Vai trò trong workflowTrigger, đứng đầu workflowNode hành động, chạy khi node trước chạy xong
Khi nào dùngNhận sự kiện: đơn hàng mới, form gửi, commit code, tin nhắn từ chatbotLấ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ựcBạ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
So sánh node Webhook và node HTTP Request trong n8n

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ử.

Sơ đồ Test URL và Production URL của node Webhook trong n8n: Test URL dạng /webhook-test/ nghe 120 giây sau khi bấm Listen for test event và hiện dữ liệu trên canvas; Production URL dạng /webhook/ đăng ký khi Publish, nhận tối đa 16 MB mỗi request, dữ liệu xem ở tab Executions; bốn chế độ Respond

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.
Cấu hình node Webhook trong n8n với Test URL, Production URL, HTTP Method, Path, Authentication và danh sách tùy chọn Respond: Immediately, When Last Node Finishes, Using Respond to Webhook Node

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_HOPS bằ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.

Workflow nhận form liên hệ trong n8n gồm bốn node nối tiếp: Webhook nhận POST, Edit Fields, Gmail gửi thư và Respond to Webhook trả phản hồi

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ảng What triggers this workflow trong n8n, tìm từ khóa webhook và chọn node Webhook để bắt đầu workflow

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.
Node Webhook trong n8n cấu hình HTTP Method POST, Path contact-form, Respond Using Respond to Webhook Node, hiển thị Test URL

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.

Thêm node Edit Fields (Set) sau node Webhook trong n8n bằng ô tìm kiếm What happens next

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:

Node Gmail trong n8n chọn credential, Resource Message, Operation Send, ô To là hộp thư quản trị, Subject New Contact Form Submission và Email Type HTML
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ệ!"
}
Node Respond to Webhook trong n8n với Respond With JSON và Response Body gồm 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"}'
Gửi request POST tới Test URL webhook-test/contact-form bằng Postman với body JSON name, email, message và nhận phản hồi 200 OK status success

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.

Email New Contact Form Submission do n8n gửi, nội dung gồm Name, Email và Message lấy từ form, tên người gửi đã được che

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ốngNguyên nhânCá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 PublishBấm Listen for test event, hoặc Publish workflow
Không nhận được dữ liệuBê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ớnMặc định mỗi request tối đa 16 MBBả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:5678n8n 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ặnn8n đứ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 CloudWebhook không phản hồi trong 100 giâyTrả phản hồi sớm bằng Respond to Webhook, xử lý dài để chạy sau
Hai workflow tranh một URLMỗi cặp path và method chỉ một webhookUnpublish workflow cũ hoặc đổi path, method
Lỗi webhook thường gặp (theo docs.n8n.io Webhook node và Common issues, truy cập 22/10/2026)

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.

Đông Tùng

Senior Technology Writer

Là cử nhân Quản trị kinh doanh của Trường Đại học Tài chính - Marketing, Tùng bắt đầu làm việc tại Tino Group từ năm 2021 ở vị trí Content Marketing để thỏa mãn niềm đam mê viết lách của bản thân. Sở hữu khả năng sáng tạo đặc biệt, anh cùng đội ngũ của mình đã tạo nên những chiến dịch quảng cáo độc đáo cùng vô số bài viết hữu ích về nhiều chủ đề khác nhau. Sự tỉ mỉ, kiên trì và tinh thần sáng tạo của Tùng đã góp phần lớn vào thành công của Tino Group trong lĩnh vực marketing trực tuyến.

Xem thêm bài viết

Bài viết liên quan

Xem nhiều