# Status Reference

This page summarizes the system statuses you encounter across OmnyBot and the recommended action for each.

## Connected Channel Statuses

OmnyBot supports omnichannel messaging across **Personal Zalo**, **Facebook Fanpage**, **WhatsApp**, and **Webchat**.

### Zalo Accounts (`ZaloAccountStatus`)

| Status | System Code | Meaning | Action Needed |
| --- | --- | --- | --- |
| **Connected** | `CONNECTED` | Session is online and sending/receiving messages normally. | None. |
| **Disconnected** | `DISCONNECTED` | Session was temporarily interrupted or not yet reconnected. | Click **Reconnect**; if that fails, choose **Re-login** via QR code. |
| **Died** | `DIED` | Account was locked or invalidated by Zalo. | Recover/unlock the account in the Zalo mobile app first, then **Re-login** via QR code. |
| **Logged in elsewhere** | `LOGGED_IN_ELSEWHERE` | Session was signed out because someone logged into this Zalo account on another device/browser. | Coordinate device usage with your team, then **Re-login** via QR code. |

:::caution[Billing-locked channels]
When a subscription expires or a workspace exceeds its channel limit (`maxNicks`), excess channels are suspended by billing (`lockedNicks`) and stay offline until you renew or upgrade in [Plans & Trials](/workspace-management/billing/).
:::

### Facebook Fanpage, WhatsApp & Webchat

**Facebook Fanpage**, **WhatsApp**, and **Webchat** channels use standard connection status (defaulting to **`CONNECTED`** when properly integrated). If delivery stops (expired Page token, invalid webhook/domain settings), inspect the channel configuration under **My Channels** or see [Channel Connection Issues](/troubleshooting/nick-login/).

## Conversation Statuses (`ZaloConversationStatus`)

| Status | System Code | Meaning |
| --- | --- | --- |
| **Open** | `OPEN` | Conversation is active and requires attention. |
| **Pending** | `PENDING` | Waiting on customer reply or an internal follow-up. |
| **Resolved** | `RESOLVED` | Conversation has been completed. |

## Contact / Lead Funnel Statuses (`ZaloContactLeadStatus`)

| Status | System Code | Meaning |
| --- | --- | --- |
| **New** | `NEW` | Contact just entered the system and has not been reached yet. |
| **Contacted** | `CONTACTED` | Your team has initiated outreach to the customer. |
| **Engaged** | `ENGAGED` | Customer has replied and an active discussion is underway. |
| **Quoted** | `QUOTED` | A quote or proposal has been sent to the customer. |
| **Converted** | `CONVERTED` | Customer agreed to buy / deal closed successfully. |
| **Not Interested** | `NOT_INTERESTED` | Customer declined or has no current need. |

:::note[Automatic status transition]
When an inbound message arrives from a contact currently in **New** (`NEW`) or **Contacted** (`CONTACTED`), OmnyBot automatically moves the contact to **Engaged** (`ENGAGED`). All other stages are updated manually.
:::

## Proxy Statuses (`ZaloProxyStatus`)

OmnyBot supports `HTTP`, `HTTPS`, and `SOCKS5` sticky proxies assigned per Zalo account.

| Status | System Code | Meaning |
| --- | --- | --- |
| **Healthy** | `HEALTHY` | Proxy passed connectivity checks and is operating normally. |
| **Dead** | `DEAD` | Proxy is unreachable or rejecting connections; replace with a working proxy. |
| **Unknown** | `UNKNOWN` | Proxy has not been health-checked recently. |

## AI & Knowledge Base Statuses

### AI Reply Modes (`AiReplyMode`)

| Mode | System Code | Meaning |
| --- | --- | --- |
| **Draft suggestion** | `DRAFT` | AI drafts replies in the inbox for human review before sending. |
| **Auto-send** | `AUTO_SEND` | AI sends replies automatically when confident and within daily limits; falls back to a draft otherwise. |

### AI Reply Draft (`AiReplyDraftStatus`) & Knowledge Gap (`AiKnowledgeGapStatus`)

| Group | Status | Meaning |
| --- | --- | --- |
| **AI Draft** | `SUGGESTED` | Draft is waiting for agent review. |
| **AI Draft** | `USED` | Agent used the draft to reply. |
| **AI Draft** | `DISMISSED` | Agent dismissed the draft. |
| **AI Draft** | `AUTO_SENT` | AI sent the reply automatically. |
| **Knowledge Gap** | `OPEN` | Customer question the AI lacked information to answer; needs KB addition. |
| **Knowledge Gap** | `RESOLVED` | Missing knowledge has been added. |
| **Knowledge Gap** | `DISMISSED` | Question was dismissed (no KB entry needed). |

## Subscription, Upgrade Request & Invitation Statuses

| Group | Statuses | Meaning |
| --- | --- | --- |
| **Subscription** (`SubscriptionStatus`) | `ACTIVE` / `EXPIRED` / `CANCELED` | Plan is active, expired (reverted/excess channels locked), or canceled. |
| **Subscription Source** (`SubscriptionSource`) | `TRIAL` / `SEPAY` / `STRIPE` / `MANUAL` | Activated via 14-day trial, VietQR/SePay bank transfer, Stripe, or manual admin grant. |
| **Upgrade Request** (`UpgradeRequestStatus`) | `PENDING` / `APPROVED` / `REJECTED` | Awaiting payment/review, approved and activated, or rejected. |
| **Workspace Invite** (`WorkspaceInviteStatus`) | `PENDING` / `ACCEPTED` / `REVOKED` / `DECLINED` | Awaiting acceptance, joined, revoked by an admin, or declined by the invitee. |

:::tip[Quick troubleshooting]
Running into channel disconnects or silent AI bots? See [Channel Connection Issues](/troubleshooting/nick-login/) and [AI Not Working](/troubleshooting/ai-issues/).
:::