Cấu hình node - Webhook Trigger

Trigger kích hoạt workflow từ webhook URL. Hệ thống bên ngoài gửi HTTP request đến URL unique, workflow tự động khởi chạy với dữ liệu từ request body.

Bảng tham số cấu hình

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
enabled	boolean	Không	true	Bật/tắt webhook endpoint
secret	string	Không	—	Secret token xác thực request (gửi qua header Authorization)
sync	boolean	Không	false	true: chờ workflow xong rồi trả result; false: trả 202 ngay
method	string	Không	POST	HTTP method chấp nhận

Dữ liệu đầu vào (Input)

Tên	Kiểu	Mô tả
body	object	Request body (JSON) từ hệ thống bên ngoài
headers	object	HTTP headers của request
query	object	Query parameters trên URL

Dữ liệu đầu ra (Output)

Tên	Kiểu	Mô tả
status	number	HTTP status code trả về cho caller
body	any	Response body (chỉ khi sync: true)

Webhook URL format

Mỗi workflow có URL webhook duy nhất:

https://your-domain.com/api/webhooks/:webhookId

URL không thay đổi khi sửa workflow, đảm bảo an toàn cho hệ thống bên ngoài đã cấu hình.

So sánh chế độ Sync vs Async

Đặc điểm	Sync (true)	Async (false)
Response	HTTP 200 + result body	HTTP 202 Accepted ngay
Thời gian chờ	Chờ workflow hoàn thành	Trả về ngay lập tức
Phù hợp	Caller cần kết quả	Fire-and-forget
Rủi ro	Timeout nếu workflow chạy lâu	Không biết kết quả

Lưu ý quan trọng

• Luôn bật secret để bảo vệ webhook khỏi request trái phép
• Chế độ sync giữ connection mở - cẩn thận timeout nếu workflow chạy lâu (mặc định 30s)
• Request body quá lớn (trên 1MB) có thể bị từ chối tùy cấu hình server
• Test webhook bằng curl hoặc Postman trước khi cấu hình hệ thống bên ngoài
• Webhook hỗ trợ retry-safe - an toàn khi hệ thống ngoài gửi lại request