Trigger Node - CRM - Contact

I. Tổng quan

File này mô tả các trigger node liên quan đến object Contact. Trong phạm vi hiện tại, đây là file mẫu đại diện cho cách viết trigger CRM theo object.

1. Vấn đề

  • Nhiều flow CRM cần phản ứng ngay khi có liên hệ mới hoặc khi thông tin liên hệ được cập nhật, nhưng nếu không có trigger chuẩn thì mỗi rule phải tự kiểm tra dữ liệu ở nhiều nơi khác nhau.

2. Giải pháp

  • Cung cấp nhóm trigger theo object Contact, với các ví dụ điển hình:
    • Khi tạo liên hệ
    • Khi cập nhật liên hệ

3. Đối tượng

  • Admin hoặc người cấu hình automation CRM.
  • Nhóm vận hành sales/CSKH cần tự động hóa theo biến động liên hệ.

4. Tầm nhìn/insight

  • Tương lai có thể mở rộng thêm trigger theo điều kiện cụ thể như khi đổi owner, khi contact đạt tiêu chí tag nhất định hoặc khi liên hệ được liên kết vào object khác.

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

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

  • Trigger Khi tạo liên hệ.
  • Trigger Khi cập nhật liên hệ.
  • Trả ra dữ liệu contact làm input đầu tiên cho flow.

2. Đặc tả chi tiết

User story 1: Là một [Người cấu hình CRM automation], tôi muốn [khởi phát flow khi có liên hệ mới] để [tự động xử lý các bước sau tạo contact].

  • Use case 1.1 (Khi tạo liên hệ): User cấu hình trigger Khi tạo liên hệ -> Hệ thống theo dõi sự kiện tạo record Contact mới -> Khi có contact mới hợp lệ, hệ thống tạo run mới và đưa dữ liệu contact vào flow.

User story 2: Là một [Người cấu hình CRM automation], tôi muốn [khởi phát flow khi contact được cập nhật] để [phản ứng với thay đổi thông tin quan trọng của liên hệ].

  • Use case 2.1 (Khi cập nhật liên hệ): User cấu hình trigger Khi cập nhật liên hệ -> Chọn hoặc giới hạn các trường quan trọng cần theo dõi nếu hệ thống hỗ trợ -> Khi contact bị cập nhật, hệ thống tạo run mới và truyền dữ liệu contact sau cập nhật cho flow.

3. Danh sách nghiệp vụ

  • Trigger chỉ áp dụng cho object Contact.
  • Dữ liệu đầu ra tối thiểu của trigger phải có ID contact và các field cơ bản cần dùng cho bước sau.
  • Với trigger cập nhật, hệ thống cần phân biệt giữa record mới tạo và record đã tồn tại bị chỉnh sửa.
  • Nếu engine có cơ chế chống lặp vô hạn, quy tắc đó phải được áp dụng khi cùng một flow tự cập nhật lại contact đã làm phát sinh trigger.

4. Giao diện

  • Trigger này tuân theo pattern chung của builder:
    • Card node hiển thị tên trigger và mô tả ngắn.
    • Panel phải cho phép chọn loại trigger và các điều kiện bổ sung nếu có.

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

  • Hệ thống cần ghi nhận đúng object và thời điểm làm phát sinh trigger.
  • Dữ liệu contact đầu ra phải ổn định để các action sau có thể map field.

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 contact mới -> Flow dùng trigger Khi tạo liên hệ được khởi phát.
  • TC2: Cập nhật contact đang tồn tại -> Flow dùng trigger Khi cập nhật liên hệ được khởi phát.
  • TC3: Flow dùng trigger Khi tạo liên hệ -> Không chạy lại chỉ vì contact được sửa sau khi đã tạo.