Trigger Node - Omnichannel - Message Received

I. Tổng quan

Trigger này khởi phát flow khi hệ thống nhận được một tin nhắn đến mới trong module đa kênh.

1. Vấn đề

  • Khi khách hàng nhắn tin mới, team vận hành thường muốn tự động gắn nhãn, phân công người xử lý hoặc tạo liên hệ CRM ngay, nhưng nếu không có trigger chuẩn thì các bước đó phải làm thủ công.

2. Giải pháp

  • Khởi phát flow ngay khi có tin nhắn đến mới và đưa dữ liệu hội thoại/tin nhắn vào flow.

3. Đối tượng

  • Nhóm CSKH, sales inbox, quản lý vận hành chat đa kênh.

4. Tầm nhìn/insight

  • Tương lai có thể mở rộng thêm filter theo kênh, page, nhãn hoặc nội dung tin nhắn.

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

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

  • Kích hoạt flow khi có tin nhắn đến.
  • Truyền dữ liệu hội thoại và tin nhắn làm input đầu tiên.

2. Đặc tả chi tiết

  • Use case 1.1: Khách hàng gửi tin nhắn mới -> Hệ thống nhận message -> Trigger Message Received khởi phát run mới.
  • Use case 1.2: Flow sử dụng dữ liệu message để chạy các action như gắn tag, gán nhân viên hoặc tạo contact.

3. Danh sách nghiệp vụ

  • Trigger chỉ áp dụng cho tin nhắn đến từ khách hàng, không áp dụng cho tin nhắn do nhân viên nội bộ gửi ra.
  • Input của trigger nên gồm tối thiểu ID cuộc hội thoại, ID message, kênh, thông tin khách và nội dung tin nhắn.
  • Nếu hệ thống hỗ trợ lọc theo kênh hoặc page, điều kiện đó cần được lưu trong cấu hình trigger.

4. Giao diện

  • Hình dưới đây là ảnh tham chiếu để người đọc hình dung ngữ cảnh hội thoại đa kênh.
  • Thiết kế giao diện chính thức của màn đa kênh xem tại:
    • https://www.figma.com/design/tBBrdtHlG1LAYJUfJsvyS3/UCALL-2026–Ant-Design-5.10.1-?node-id=32138-117673&m=dev

Minh họa màn hình đa kênh

  • Node dùng pattern trigger chung trong builder.
  • Panel cấu hình có thể mở rộng thêm các điều kiện theo kênh hoặc nhãn trong tương lai.

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

  • Trigger phải đủ nhanh để các automation gần thời gian thực như gắn tag hoặc phân công xử lý không bị trễ đáng kể.

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

  • dev/chat/omni_channel.md
  • dev/chat/zalo_sync_label_permission.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: Khách gửi tin nhắn mới -> Flow trigger Message Received được khởi phát.
  • TC2: Nhân viên nội bộ gửi phản hồi -> Trigger không khởi phát nếu rule chỉ áp dụng cho tin nhắn đến.