# AI Copilot & Tự động trả lời

OmnyBot tích hợp trợ lý AI trực tiếp trong Team Inbox để rút ngắn thời gian phản hồi, tự động trả lời các câu hỏi có sẵn trong Kho tri thức và hỗ trợ nhân viên tóm tắt hoặc soạn câu trả lời ngay trong từng hội thoại.

:::note[Quyền truy cập & Phạm vi]
- Cần quyền **`inbox:reply`** để bật/tắt AI theo hội thoại, tạo hoặc gửi gợi ý AI và trò chuyện với AI Copilot.
- Cấu hình AI cấp Workspace, Bot và Kho tri thức yêu cầu quyền **`ai:manage`** hoặc **`workspace:manage`**.
- AI tự động trả lời và thanh gợi ý chỉ hoạt động trên **hội thoại 1-1** (Zalo, Facebook, WhatsApp, Webchat) và không áp dụng cho chat nhóm. Việc gọi AI sử dụng số dư token trong Ví AI của Workspace.
:::

## Thanh gợi ý AI (`Gợi ý từ AI`)

Thanh gợi ý nằm ngay phía trên khung soạn thảo:

- **Tự động soạn gợi ý khi có tin khách**: khi bật chế độ tự soạn gợi ý, hệ thống áp dụng cơ chế gom tin nhắn liên tiếp (**debounce**) — chờ **6 giây** sau tin nhắn hoặc tín hiệu đang soạn cuối cùng của khách (tối đa **40 giây** tính từ tin đầu tiên) rồi mới tạo bản nháp để tránh trả lời cắt đoạn.
- **Tạo gợi ý theo yêu cầu**: nhấn nút **`+`** ở khung soạn thảo → chọn **Gợi ý AI** để yêu cầu AI soạn câu trả lời ngay lập tức cho hội thoại hiện tại.
- **Thao tác với bản nháp**:
  - **Gửi luôn**: gửi trực tiếp nội dung gợi ý cho khách (bao gồm cả bộ ảnh kịch bản nếu AI đính kèm).
  - **Dùng**: đưa nội dung gợi ý vào khung soạn thảo để bạn chỉnh sửa trước khi gửi.
  - **Soạn lại**: yêu cầu AI tạo một phương án trả lời khác.
  - **Đóng (`✕`)**: bỏ qua gợi ý hiện tại.

## Chế độ Tự động gửi (`AUTO_SEND`) & Chuyển giao nhân viên

Thứ tự ưu tiên quyết định AI có tự động phản hồi hay không tuân theo cấp bậc **Workspace → Kênh/Bot → Hội thoại**.

Ở chế độ **Tự động gửi (`AUTO_SEND`)**:

- AI chỉ tự gửi khi câu trả lời có độ tin cậy cao từ Kho tri thức, nằm trong **lịch hoạt động** (ưu tiên lịch riêng của Bot, sau đó đến khung giờ chung của Workspace) và chưa vượt **hạn mức gửi tự động mỗi ngày** của kênh.
- Nếu câu hỏi nằm ngoài Kho tri thức, hệ thống ghi nhận một phiếu **Lỗ hổng tri thức (Knowledge Gap)** (thông báo tại **OmnyBot → AI & Tri thức**) và chuyển về dạng **Gợi ý (Draft)** hoặc gửi **tin nhắn dự phòng** theo cấu hình (mặc định tối đa 1 lần/ngày/hội thoại để tránh lặp).
- Riêng trên **Zalo** ở chế độ `AUTO_SEND`, với các tin xác nhận ngắn của khách (như "ok", "vâng", "cảm ơn"), AI có thể tự động thả tim (**❤️**) thay vì nhắn thêm chữ (giới hạn 120 lượt/ngày).

### Tự động tạm dừng Bot để nhân viên tiếp quản

Bot sẽ tự động tạm dừng trên hội thoại hiện tại khi rơi vào một trong các điều kiện sau (thời gian tạm dừng mặc định là **4 giờ**, có thể tùy chỉnh trong cấu hình Bot):

1. **Từ khóa chuyển giao**: tin nhắn khách chứa từ khóa yêu cầu gặp người thật (mặc định: `gặp nhân viên`, `gặp người thật`, `tư vấn viên`, `alo shop`, `hotline`). Nếu có cấu hình tin nhắn chuyển giao, Bot sẽ gửi câu thông báo này trước khi dừng.
2. **Đạt giới hạn lượt trả lời liên tiếp**: Bot đã tự trả lời liên tiếp quá số lượt cho phép (mặc định **3 lượt**) mà khách vẫn tiếp tục hỏi.
3. **Ngoài Kho tri thức (khi bật tin dự phòng)**: Bot gửi tin nhắn dự phòng và tạm dừng để nhân viên xử lý tiếp.

Khi Bot đang tạm dừng, thanh phía trên khung chat hiển thị đồng hồ đếm ngược (**`Bot đang tạm dừng • Tự bật lại sau ...`**) kèm nút **Tiếp tục Bot** để bật lại ngay lập tức. Nếu không thao tác thủ công, Bot sẽ tự động kích hoạt lại khi hết thời gian tạm dừng.

## Bật/tắt AI cho từng hội thoại

Trong cột phải **Hồ sơ khách hàng → Tab Thông tin**, mục **Tự động trả lời** cung cấp công tắc bật/tắt AI riêng cho hội thoại đang mở:

- **Tắt**: tạm dừng AI tự động cho riêng khách hàng này (không ảnh hưởng các hội thoại khác trên cùng kênh).
- **Bật**: hội thoại quay lại tuân theo cấu hình AI chung của kênh/Bot.

## Trợ lý AI Copilot nội bộ (Tab Copilot)

Tab **Copilot** ở cột phải là khung trò chuyện nội bộ dành riêng cho nhân viên — **khách hàng hoàn toàn không nhìn thấy** nội dung trao đổi tại đây.

Copilot tự động đọc hồ sơ CRM của khách (tên, số điện thoại, trạng thái tiềm năng, thẻ, ghi chú), **30 tin nhắn gần nhất** và **Kho tri thức** của Workspace để hỗ trợ bạn:

- **4 câu lệnh nhanh có sẵn**:
  - *Tóm tắt hội thoại này giúp em*
  - *Gợi ý câu trả lời tiếp theo cho khách*
  - *Khách đang quan tâm sản phẩm/dịch vụ nào?*
  - *Soạn câu xin SĐT và chốt đơn khéo léo*
- **Sử dụng câu trả lời gợi ý**: khi Copilot trả về khung **Gợi ý tin nhắn cho khách**, bạn có thể nhấn **Copy** hoặc **Chèn vào ô chat** để đưa thẳng vào khung soạn thảo.
- **Quản lý phiên chat Copilot**: lịch sử trò chuyện với Copilot được lưu tạm theo từng hội thoại trong bộ nhớ trình duyệt khi bạn chuyển qua lại giữa các khách hàng; nhấn **Làm mới** để xóa phiên và bắt đầu lại.