Trigger Node - Omnichannel - Conversation Created

I. Tổng quan

Trigger này khởi phát flow khi hệ thống phát sinh một hội thoại mới trong module đa kênh.

1. Vấn đề

  • Khi có hội thoại mới, nhiều team muốn tự động tạo contact, gắn nhãn mặc định hoặc phân tuyến xử lý ngay từ đầu. Nếu chỉ chờ đến khi có thao tác tay thì dễ bỏ sót hoặc phản ứng chậm.

2. Giải pháp

  • Khởi phát flow tại thời điểm cuộc hội thoại mới được tạo trong hệ thống.

3. Đối tượng

  • Nhóm vận hành chat, CSKH hoặc sales xử lý inbound conversation.

4. Tầm nhìn/insight

  • Có thể mở rộng thêm trigger theo nguồn hội thoại, page, chiến dịch hoặc loại khách hàng.

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

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

  • Kích hoạt flow khi có hội thoại mới.
  • Truyền dữ liệu cuộc hội thoại sang các action xử lý tiếp theo.

2. Đặc tả chi tiết

  • Use case 1.1: Hội thoại mới xuất hiện trong inbox -> Hệ thống khởi phát run mới với trigger Conversation Created.
  • Use case 1.2: Flow tiếp theo có thể tự động tạo liên hệ, gắn tag hoặc phân công người xử lý.

3. Danh sách nghiệp vụ

  • Trigger áp dụng tại thời điểm tạo mới conversation record.
  • Input của trigger cần gồm tối thiểu ID hội thoại, kênh, page và thông tin cơ bản của khách nếu đã có.
  • Trigger này khác với Message Received: một conversation mới có thể là điểm bắt đầu của thread, trong khi message mới có thể phát sinh trên thread đã tồn tại.

4. Giao diện

  • Node sử dụng pattern trigger chung trong builder.

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

  • Trigger cần đủ ổn định để không tạo trùng nhiều run cho cùng một conversation mớ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: Khách bắt đầu hội thoại mới -> Trigger Conversation Created khởi phát flow.
  • TC2: Tin nhắn mới trên conversation đã tồn tại -> Trigger này không khởi phát nếu không có conversation mới.