Trigger Node - CRM - Deal

I. Tổng quan

File này mô tả các trigger node liên quan đến object Deal. Đây là file mẫu thứ hai cho nhóm trigger CRM, tập trung vào biến động của cơ hội bán hàng.

1. Vấn đề

  • Nhiều luồng CRM chỉ thực sự cần chạy khi một cơ hội bán hàng được tạo mới hoặc khi deal đổi trạng thái/pipeline, nhưng nếu không có trigger chuẩn thì người vận hành phải xử lý thủ công hoặc dùng nhiều rule rời rạc.

2. Giải pháp

  • Cung cấp nhóm trigger theo object Deal, với các ví dụ điển hình:
    • Khi tạo deal
    • Khi đổi trạng thái/pipeline

3. Đối tượng

  • Quản lý sales, admin CRM hoặc người cấu hình automation theo pipeline bán hàng.

4. Tầm nhìn/insight

  • Có thể mở rộng thêm trigger theo giá trị deal, xác suất deal, ngày đóng dự kiến hoặc khi deal được liên kết với contact/enterprise cụ thể.

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

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

  • Trigger Khi tạo deal.
  • Trigger Khi đổi trạng thái/pipeline.
  • Truyền dữ liệu deal cho action node tiếp theo.

2. Đặc tả chi tiết

User story 1: Là một [Quản lý sales], tôi muốn [khởi phát flow khi có deal mới] để [tự động phân công hoặc gửi thông báo cho đội ngũ liên quan].

  • Use case 1.1 (Khi tạo deal): Deal mới được tạo trong CRM -> Hệ thống khởi tạo flow run -> Dữ liệu deal trở thành input đầu tiên của flow.

User story 2: Là một [Người cấu hình pipeline automation], tôi muốn [khởi phát flow khi deal đổi trạng thái hoặc pipeline] để [chạy các bước bám theo tiến trình bán hàng].

  • Use case 2.1 (Khi đổi trạng thái/pipeline): User cấu hình trigger theo Deal -> Chọn sự kiện thay đổi trạng thái hoặc pipeline -> Khi deal được cập nhật sang trạng thái mới, hệ thống tạo run mới.

3. Danh sách nghiệp vụ

  • Trigger chỉ áp dụng cho object Deal.
  • Với trigger thay đổi trạng thái, hệ thống phải xác định được trạng thái trước và trạng thái sau nếu logic nghiệp vụ cần đối chiếu.
  • Trigger không nên sinh run nếu deal chỉ bị cập nhật ở các trường không liên quan đến điều kiện trigger đã chọn.

4. Giao diện

  • Card node hiển thị tên trigger deal.
  • Panel cấu hình bên phải cho phép chọn loại sự kiện khởi phát và điều kiện liên quan đến pipeline/trạng thái nếu có.

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

  • Dữ liệu deal đầu ra phải đủ để action node sau có thể map ít nhất ID deal, tên deal, trạng thái và pipeline hiện tại.

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

V. API Contract (dev viết)

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

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

  • TC1: Tạo deal mới -> Flow trigger Khi tạo deal được khởi phát.
  • TC2: Đổi trạng thái deal -> Flow trigger Khi đổi trạng thái/pipeline được khởi phát.
  • TC3: Chỉ sửa trường mô tả deal -> Trigger thay đổi trạng thái không được chạy nếu điều kiện không thỏa.