Action Node - Integration - Call Webhook

I. Tổng quan

Node Call Webhook dùng để gửi dữ liệu từ flow ra một endpoint ngoài hệ thống.

1. Vấn đề

  • Một số flow cần đồng bộ dữ liệu ra nền tảng khác sau khi xử lý xong trong CRM hoặc chat. Nếu không có action webhook thì người dùng phải xây connector riêng ngoài flow.

2. Giải pháp

  • Cung cấp action Call Webhook để gửi request tới endpoint ngoài với payload map từ dữ liệu flow.

3. Đối tượng

  • Nhóm tích hợp, admin kỹ thuật hoặc người cấu hình automation cần đẩy event ra ngoài.

4. Tầm nhìn/insight

  • Tương lai có thể hỗ trợ nhiều phương thức xác thực, retry policy hoặc mapping response phức tạp hơn.

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

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

  • Cấu hình endpoint gọi ra ngoài.
  • Cấu hình payload.
  • Nhận response để dùng tiếp nếu hệ thống hỗ trợ.

2. Đặc tả chi tiết

  • Use case 1.1: User thêm node Call Webhook -> Nhập endpoint -> Chọn phương thức gọi và map payload từ output node trước -> Khi flow chạy, hệ thống gửi request tới endpoint ngoài.

3. Danh sách nghiệp vụ

  • Endpoint phải hợp lệ trước khi node được xem là đủ điều kiện chạy.
  • Payload có thể lấy từ dữ liệu đầu vào của flow hoặc giá trị tĩnh.
  • Nếu endpoint trả lỗi, node phải phản ánh rõ trạng thái lỗi trong run detail.

4. Giao diện

  • Panel cấu hình cần có field endpoint, phương thức gọi và vùng map payload.

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

  • Cần có timeout và logging rõ ràng cho request gọi ra ngoài.
  • Không để lỗi từ hệ thống ngoài làm hỏng cơ chế truy vết của flow.

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

  • flow.md
  • Integration gateway / outbound HTTP 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: Endpoint hợp lệ, payload hợp lệ -> Request được gửi thành công.
  • TC2: Endpoint lỗi hoặc timeout -> Node phản ánh trạng thái fail trong run detail.