Action Node - Omnichannel - Add Conversation Tag

I. Tổng quan

Node này dùng để gắn nhãn cho hội thoại trong module đa kênh.

1. Vấn đề

  • Team vận hành inbox thường cần tự động gắn nhãn như Khách hàng mới, CSKH, Ưu tiên cao để dễ lọc và phân loại hội thoại, nhưng làm thủ công sẽ chậm và thiếu nhất quán.

2. Giải pháp

  • Cung cấp action Add Conversation Tag để flow gắn tag cho hội thoại dựa trên trigger hoặc điều kiện đã cấu hình.

3. Đối tượng

  • Nhóm CSKH, sales inbox và admin cấu hình automation trên chat.

4. Tầm nhìn/insight

  • Tương lai có thể hỗ trợ thêm gỡ nhãn, thay nhãn hoặc gắn nhãn theo rule kết hợp nhiều điều kiện.

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

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

  • Gắn một hoặc nhiều tag cho hội thoại.
  • Nhận target conversation từ trigger hoặc node trước.

2. Đặc tả chi tiết

  • Use case 1.1: Trigger Message Received khởi phát flow -> Action Add Conversation Tag gắn tag Khách hàng mới -> Hội thoại được cập nhật tag tự động.

3. Danh sách nghiệp vụ

  • Tag áp dụng phải là tag hợp lệ trong hệ thống.
  • Node phải xác định được hội thoại mục tiêu trước khi thực thi.
  • Nếu cùng tag đã tồn tại trên conversation, hệ thống cần xử lý idempotent hoặc tránh gắn trùng.

4. Giao diện

  • Panel cấu hình cần có field chọn tag hoặc map danh sách tag.

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

  • Cần đảm bảo thao tác gắn nhãn đủ nhanh để user thấy được tag gần thời gian thực trên inbox nếu workflow yêu cầu.

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: Flow nhận conversation hợp lệ -> Action gắn tag thành công.
  • TC2: Tag không hợp lệ -> Node trả lỗi.