Trigger Node - Integration - External Form Submitted

I. Tổng quan

Trigger này khởi phát flow khi một form ngoài hệ thống gửi dữ liệu vào Adahub/AdaFlow.

1. Vấn đề

  • Form đăng ký, form lead hoặc nguồn thu thập dữ liệu ngoài hệ thống thường cần đẩy khách hàng mới vào CRM ngay sau khi submit, nhưng nếu không có trigger chuẩn thì phải tạo nhiều connector rời rạc.

2. Giải pháp

  • Khởi phát flow ngay khi dữ liệu form ngoài được gửi vào hệ thống để từ đó có thể tạo contact, tạo deal hoặc gửi email phản hồi.

3. Đối tượng

  • Nhóm data acquisition, marketing, vận hành lead hoặc kỹ thuật tích hợp.

4. Tầm nhìn/insight

  • Có thể mở rộng thêm mapping schema form theo từng nguồn hoặc hỗ trợ nhiều mẫu form 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 form ngoài được submit hợp lệ.
  • Truyền dữ liệu form sang các node tiếp theo.

2. Đặc tả chi tiết

  • Use case 1.1: Người dùng ngoài gửi form -> Hệ thống nhận dữ liệu -> Trigger External Form Submitted khởi phát flow -> Action tiếp theo có thể tạo contact hoặc deal.

3. Danh sách nghiệp vụ

  • Dữ liệu form nhận được phải có schema tối thiểu để map vào flow.
  • Trigger chỉ áp dụng cho nguồn submit ngoài đã được cấu hình hoặc tích hợp trước.
  • Nếu form thiếu dữ liệu bắt buộc, run có thể bị chặn hoặc ghi nhận lỗi tùy rule kỹ thuật.

4. Giao diện

  • Panel cấu hình có thể cho phép chọn nguồn form hoặc schema mapping nếu hệ thống hỗ trợ.

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

  • Cần đảm bảo hệ thống xử lý được lượng submit lớn mà không sinh run trùng.

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

  • dev/ulead/data_acquisition.md
  • flow.md

V. API Contract (dev viết)

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

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

  • TC1: Submit form hợp lệ -> Flow run được tạo.
  • TC2: Submit form thiếu trường bắt buộc -> Run bị lỗi hoặc bị chặn theo rule hệ thống.