# Bảng tra trạng thái

Trang này tổng hợp các trạng thái hệ thống bạn gặp trong OmnyBot và hành động tương ứng.

## Trạng thái kênh kết nối

OmnyBot hỗ trợ kết nối đa kênh gồm **Zalo cá nhân**, **Facebook Fanpage**, **WhatsApp** và **Webchat**.

### Tài khoản Zalo (`ZaloAccountStatus`)

| Trạng thái | Mã hệ thống | Ý nghĩa | Việc cần làm |
| --- | --- | --- | --- |
| **Đang hoạt động** | `CONNECTED` | Phiên Zalo đang trực tuyến, nhận và gửi tin bình thường. | Không cần làm gì. |
| **Mất kết nối** | `DISCONNECTED` | Phiên đăng nhập tạm gián đoạn hoặc chưa kết nối lại. | Nhấn **Kết nối lại**; nếu không được, chọn **Đăng nhập lại** bằng mã QR. |
| **Đã chết** | `DIED` | Tài khoản bị Zalo khóa hoặc vô hiệu hóa phiên phía Zalo. | Khôi phục/mở khóa trên ứng dụng Zalo trước, sau đó **Đăng nhập lại** bằng mã QR. |
| **Đăng nhập nơi khác** | `LOGGED_IN_ELSEWHERE` | Tài khoản bị đẩy phiên do đăng nhập trên thiết bị/trình duyệt khác. | Thống nhất thiết bị sử dụng trong nhóm rồi **Đăng nhập lại** bằng mã QR. |

:::caution[Kênh bị khóa theo gói]
Khi gói dịch vụ hết hạn hoặc Workspace vượt hạn mức kênh (`maxNicks`), các kênh vượt mức sẽ bị tạm khóa thanh toán (`lockedNicks`) và chuyển ngoại tuyến cho đến khi bạn gia hạn hoặc nâng cấp tại [Gói dịch vụ & Dùng thử](/vi/workspace-management/billing/).
:::

### Facebook Fanpage, WhatsApp & Webchat

Các kênh **Facebook Fanpage**, **WhatsApp** và **Webchat** sử dụng trạng thái kết nối chuẩn (mặc định **`CONNECTED`** khi tích hợp hợp lệ). Nếu kết nối gián đoạn (hết hạn token Fanpage, sai cấu hình webhook/tên miền), hãy kiểm tra lại cấu hình kênh tại trang **Kênh của tôi** hoặc xem [Sự cố kênh kết nối](/vi/troubleshooting/nick-login/).

## Trạng thái hội thoại (`ZaloConversationStatus`)

| Trạng thái | Mã hệ thống | Ý nghĩa |
| --- | --- | --- |
| **Đang mở** | `OPEN` | Hội thoại đang cần theo dõi hoặc xử lý. |
| **Đang chờ** | `PENDING` | Hội thoại đang chờ phản hồi từ khách hàng hoặc bộ phận liên quan. |
| **Đã giải quyết** | `RESOLVED` | Hội thoại đã hoàn tất chăm sóc. |

## Trạng thái liên hệ / phễu bán hàng (`ZaloContactLeadStatus`)

| Trạng thái | Mã hệ thống | Ý nghĩa |
| --- | --- | --- |
| **Chưa liên hệ** | `NEW` | Liên hệ mới vào hệ thống, chưa có nhân sự chăm sóc. |
| **Đã liên hệ** | `CONTACTED` | Nhân sự đã chủ động nhắn tin hoặc liên hệ với khách. |
| **Đang trao đổi** | `ENGAGED` | Khách đã phản hồi, hai bên đang trao đổi. |
| **Đã báo giá** | `QUOTED` | Đã gửi báo giá hoặc đề xuất mua hàng cho khách. |
| **Đã chốt** | `CONVERTED` | Khách đồng ý mua, chuyển đổi thành công. |
| **Không quan tâm** | `NOT_INTERESTED` | Khách từ chối hoặc chưa có nhu cầu. |

:::note[Chuyển trạng thái tự động]
Khi khách nhắn tin đến mà liên hệ đang ở **Chưa liên hệ** (`NEW`) hoặc **Đã liên hệ** (`CONTACTED`), hệ thống tự động chuyển sang **Đang trao đổi** (`ENGAGED`). Các trạng thái còn lại do nhân sự cập nhật thủ công.
:::

## Trạng thái Proxy (`ZaloProxyStatus`)

OmnyBot hỗ trợ proxy giao thức `HTTP`, `HTTPS` và `SOCKS5` gắn cố định theo từng tài khoản Zalo.

| Trạng thái | Mã hệ thống | Ý nghĩa |
| --- | --- | --- |
| **Ổn định** | `HEALTHY` | Proxy kiểm tra kết nối thành công và hoạt động bình thường. |
| **Lỗi / Chết** | `DEAD` | Proxy không phản hồi hoặc từ chối kết nối; cần thay proxy mới. |
| **Chưa xác định** | `UNKNOWN` | Proxy chưa được kiểm tra sức khỏe gần đây. |

## Trạng thái AI & Kho tri thức

### Chế độ phản hồi AI (`AiReplyMode`)

| Chế độ | Mã hệ thống | Ý nghĩa |
| --- | --- | --- |
| **Gợi ý nháp** | `DRAFT` | AI soạn sẵn câu trả lời trong hộp thư để nhân sự duyệt trước khi gửi. |
| **Tự động gửi** | `AUTO_SEND` | AI tự gửi trực tiếp khi đủ độ tin cậy và còn trong hạn mức; nếu không chắc sẽ tự lùi về nháp. |

### Trạng thái nháp AI (`AiReplyDraftStatus`) & Lỗ hổng tri thức (`AiKnowledgeGapStatus`)

| Nhóm | Trạng thái | Ý nghĩa |
| --- | --- | --- |
| **Nháp AI** | `SUGGESTED` | Nháp đang chờ nhân sự xem xét. |
| **Nháp AI** | `USED` | Nhân sự đã sử dụng nháp để gửi khách. |
| **Nháp AI** | `DISMISSED` | Nhân sự đã bỏ qua nháp. |
| **Nháp AI** | `AUTO_SENT` | AI đã tự động gửi câu trả lời cho khách. |
| **Lỗ hổng tri thức** | `OPEN` | Câu hỏi khách hàng mà AI chưa đủ thông tin để trả lời, cần bổ sung vào Kho tri thức. |
| **Lỗ hổng tri thức** | `RESOLVED` | Đã bổ sung thông tin xử lý lỗ hổng. |
| **Lỗ hổng tri thức** | `DISMISSED` | Đã bỏ qua câu hỏi này (không cần đưa vào Kho tri thức). |

## Trạng thái gói dịch vụ, thanh toán & lời mời

| Nhóm | Trạng thái | Ý nghĩa |
| --- | --- | --- |
| **Gói dịch vụ** (`SubscriptionStatus`) | `ACTIVE` / `EXPIRED` / `CANCELED` | Gói đang hiệu lực, đã hết hạn (chuyển về hạn mức thấp hơn/khóa kênh vượt mức), hoặc đã hủy. |
| **Nguồn kích hoạt** (`SubscriptionSource`) | `TRIAL` / `SEPAY` / `STRIPE` / `MANUAL` | Kích hoạt qua dùng thử 14 ngày, chuyển khoản VietQR/SePay, Stripe hoặc admin cấp thủ công. |
| **Yêu cầu nâng cấp** (`UpgradeRequestStatus`) | `PENDING` / `APPROVED` / `REJECTED` | Đang chờ thanh toán/duyệt, đã phê duyệt kích hoạt, hoặc đã từ chối. |
| **Lời mời thành viên** (`WorkspaceInviteStatus`) | `PENDING` / `ACCEPTED` / `REVOKED` / `DECLINED` | Đang chờ nhận, đã tham gia, đã thu hồi bởi quản trị viên, hoặc người được mời đã từ chối. |

:::tip[Xử lý sự cố nhanh]
Gặp lỗi khi kết nối tài khoản hoặc AI không trả lời? Xem [Sự cố kênh kết nối](/vi/troubleshooting/nick-login/) và [AI không hoạt động](/vi/troubleshooting/ai-issues/).
:::