Trigger Node - Integration - Webhook Received

I. Tổng quan

Trigger này khởi phát flow khi hệ thống nhận được một webhook event từ nguồn ngoài.

1. Vấn đề

  • Nhiều automation cần bắt đầu từ sự kiện ngoài hệ thống như form submit, trạng thái giao dịch hoặc callback từ nền tảng khác. Nếu không có trigger webhook, dữ liệu ngoài khó đi vào flow engine một cách nhất quán.

2. Giải pháp

  • Cung cấp trigger Webhook Received để nhận event ngoài và chuyển payload vào flow làm input đầu tiên.

3. Đối tượng

  • Nhóm tích hợp, admin kỹ thuật hoặc người cấu hình automation kết nối hệ thống ngoài.

4. Tầm nhìn/insight

  • Có thể mở rộng thêm xác thực nguồn gọi, schema validation và mapping nhiều loại webhook khác nhau.

II. Yêu cầu chức năng

1. Danh sách tính năng

  • Kích hoạt flow khi nhận webhook hợp lệ.
  • Truyền payload webhook sang các node sau.

2. Đặc tả chi tiết

  • Use case 1.1: Hệ thống ngoài gửi webhook đến endpoint đã cấu hình -> Hệ thống xác nhận webhook hợp lệ -> Trigger Webhook Received khởi phát run mới.
  • Use case 1.2: Payload webhook được đưa vào flow để dùng cho CRM, logic hoặc integration action node phía sau.

3. Danh sách nghiệp vụ

  • Trigger chỉ khởi phát khi webhook hợp lệ theo quy tắc xác thực đã chốt.
  • Payload nhận được phải được lưu đủ để truy vết ở run detail.
  • Nếu webhook sai schema hoặc không hợp lệ, hệ thống không nên tạo run thành công.

4. Giao diện

  • Panel cấu hình có thể gồm tên nguồn webhook, khóa xác thực hoặc schema tham chiếu nếu hệ thống hỗ trợ.

III. Yêu cầu phi chức năng

  • Cần có cơ chế bảo mật và xác thực phù hợp cho nguồn webhook.
  • Trigger phải xử lý được payload ngoài mà không làm hỏng flow engine khi dữ liệu sai định dạng.

IV. Dependency (liên quan & phụ thuộc)

  • flow.md
  • Integration gateway / webhook service

V. API Contract (dev viết)

  • Chưa chốt API chi tiết.

VI. Test case (BA hoặc tester viết)

  • TC1: Gửi webhook hợp lệ -> Flow run được tạo.
  • TC2: Gửi webhook thiếu xác thực -> Hệ thống không khởi phát run thành công.