Webhook Là Gì và Tại Sao Nó Quan Trọng
Hầu hết các tích hợp API đều dựa trên pull: workflow của bạn chạy theo lịch, gọi một dịch vụ bên ngoài và lấy về những gì đã thay đổi kể từ lần kiểm tra trước. Webhook lật ngược mô hình đó. Thay vì bạn chủ động hỏi, dịch vụ bên ngoài sẽ đẩy dữ liệu đến bạn ngay khi có sự kiện xảy ra — một khoản thanh toán hoàn tất, một biểu mẫu được gửi đi, một repo có commit mới. Kết quả là phản ứng gần như tức thì với chi phí polling bằng không.
n8n có sẵn Webhook node biến bất kỳ workflow nào thành một HTTP endpoint. Khi endpoint đó nhận được request, workflow sẽ được kích hoạt ngay lập tức. Bài học này sẽ hướng dẫn cách thiết lập, xử lý payload đến và gửi phản hồi phù hợp lại cho caller.
Thiết Lập Webhook Node
Kéo một Webhook node vào canvas và đặt nó làm trigger (node đầu tiên). Hai cài đặt bạn cần cấu hình ngay là HTTP Method và Path.
HTTP Method hầu như luôn là POST — đó là phương thức mà mọi nền tảng lớn đều gửi. Chỉ sử dụng GET khi bên thứ ba tài liệu hóa rõ ràng (một số bắt tay xác minh sử dụng GET).
Path là slug duy nhất để nhận diện workflow này. n8n tạo UUID theo mặc định, nhưng bạn có thể đặt một slug dễ đọc như /stripe-events hoặc /github-push. URL đầy đủ mà n8n hiển thị trông như sau:
Bạn dán URL đó vào phần cài đặt webhook của nền tảng bên thứ ba — Stripe dashboard, cài đặt repo GitHub, Typeform, hoặc bất kỳ dịch vụ nào liên quan.
n8n cung cấp cho bạn hai URL webhook cho mỗi node: URL Test và URL Production. URL Test chỉ hoạt động khi bạn đang ở trong trình chỉnh sửa với workflow được mở và đang lắng nghe. URL Production chỉ hoạt động khi workflow đã được lưu và kích hoạt. Không bao giờ cung cấp URL Test cho nhà cung cấp đối với tích hợp thực tế — nó sẽ ngừng hoạt động ngay khi bạn đóng tab trình duyệt.
Nhận và Phân tích Payload
Khi webhook được kích hoạt, dữ liệu đến sẽ nằm trong output của Webhook node. n8n tự động phân tích các body JSON, vì vậy nếu Stripe gửi sự kiện payment_intent.succeeded, bạn có thể truy cập trực tiếp số tiền charge trong các node tiếp theo thông qua biểu thức:
Đối với các body dạng form-encoded (một số dịch vụ cũ gửi Content-Type: application/x-www-form-urlencoded), n8n cũng tự động phân tích chúng vào cùng đối tượng $json.
Headers cũng có sẵn, điều này rất quan trọng cho việc xác minh chữ ký. Stripe, GitHub và hầu hết các nền tảng chuyên nghiệp đều ký các payload webhook của họ bằng HMAC secret để bạn có thể xác nhận yêu cầu thực sự đến từ họ. Trong n8n, bạn có thể đọc header chữ ký bên trong một Code node và xác minh nó:
Luôn xác minh chữ ký trên các workflow production kích hoạt bất kỳ hành động nhạy cảm nào — gửi email, sửa đổi bản ghi, tính phí người dùng.
Phản hồi lại Caller
Một số nền tảng yêu cầu phản hồi HTTP cụ thể, không chỉ đơn thuần là 200 OK mặc định. Stripe mong đợi phản hồi 200 trong vòng vài giây nếu không sẽ thử lại. GitHub mong đợi 200. Một số hệ thống như Typeform hoặc các dịch vụ nội bộ tùy chỉnh muốn nhận lại một body JSON xác nhận đã nhận.
Trong cài đặt của Webhook node, đặt Response Mode thành Last Node. Bây giờ node cuối cùng trong workflow sẽ kiểm soát nội dung được gửi lại. Kết hợp nó với một Respond to Webhook node ở cuối chuỗi và cấu hình node đó:
Nếu workflow của bạn thực hiện xử lý nặng — ghi database, gửi email, gọi các API khác — và bạn vẫn cần phản hồi nhanh, hãy sử dụng Response Mode: Immediately trong Webhook node. n8n trả về 200 ngay lập tức và tiếp tục chạy phần còn lại của workflow trong nền. Đánh đổi ở đây là bạn không thể gửi body phản hồi động, nhưng caller sẽ không bao giờ bị timeout.
Những lỗi thường gặp cần tránh
Sử dụng URL Test trên môi trường production là sai lầm phổ biến nhất. Workflow sẽ ngừng hoạt động ngay khi bạn đóng trình soạn thảo và không ai nhận ra cho đến khi các sự kiện bị mất.
Không xử lý retry là một lỗ hổng khác. Stripe sẽ retry webhook bị lỗi trong tối đa 72 giờ. Nếu workflow của bạn không có tính idempotent — tức là chạy hai lần cùng một sự kiện sẽ gây ra bản ghi trùng lặp hoặc tính phí hai lần — bạn cần kiểm tra xem mình đã xử lý ID sự kiện đó chưa trước khi thực hiện bất kỳ thao tác ghi nào.
Bỏ qua response timeout sẽ gây ra lỗi âm thầm. Nếu workflow của bạn mất 30 giây và bên gọi kỳ vọng nhận phản hồi trong 5 giây, họ sẽ đánh dấu giao nhận là thất bại và thử lại, mặc dù cuối cùng workflow của bạn vẫn thành công. Hoặc phản hồi ngay lập tức, hoặc tối ưu lại luồng xử lý.
Tóm tắt
Webhook cho phép các dịch vụ bên thứ ba đẩy sự kiện đến n8n theo thời gian thực, loại bỏ nhu cầu polling theo lịch. Bạn thiết lập node Webhook với một đường dẫn và phương thức HTTP, dán Production URL vào phần cài đặt của nhà cung cấp, sau đó truy cập payload thông qua $json trong các node phía sau. Xác minh chữ ký giúp bảo vệ khỏi các request giả mạo, và node Respond to Webhook hoặc chế độ Immediately cho phép bạn kiểm soát dữ liệu mà bên gọi nhận lại. Xử lý đúng các chi tiết này — URL chính xác, kiểm tra chữ ký, idempotency, thời điểm phản hồi — chính là điều phân biệt một tích hợp mong manh với một tích hợp vận hành ổn định trên môi trường production.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.