# Team Inbox Overview

**Team Inbox** is the central workspace where support and sales teams monitor, filter, and reply to customers across all connected messaging channels without switching between separate apps.

:::note[Required permissions]
- **`inbox:read:all`** grants read access to connected channels, conversations, messages, pinned messages, and live teammate presence.
- **`inbox:reply`** is required to send messages, attach media or stickers, react, recall, pin/archive/mute conversations, and use in-thread AI features.
- The system **Viewer** role has read-only access (`inbox:read:all`), while **Agent**, **Manager**, and **Owner** include both permissions.
:::

## Routes

- `/{slug}/inbox` — redirects automatically to `/{slug}/inbox/omnybot`.
- `/{slug}/inbox/omnybot?channel={channel}` — OmnyBot internal and system notification feed.
- `/{slug}/inbox/{accountId}` — conversation inbox for a specific connected account (supports `?person={id}` to deep-link to a thread).

## Three-Column Layout

### 1. Left Channel Rail

Displays the **OmnyBot** notification inbox at the top, followed by all connected accounts grouped in platform order:

1. **Zalo**
2. **Facebook**
3. **WhatsApp**
4. **Webchat**

Each account displays a real-time unread conversation badge.

### 2. Conversation List & Filters

When an account is selected, the conversation list column provides:

- **Search**: search by customer name, phone number, or content. On **Zalo**, entering a phone number not yet in the list and pressing **Enter** looks up the user directly on Zalo so you can start a chat.
- **Tag Filter**: filter by one or more CRM tags (or **Untagged**), with a shortcut to tag management (`/{slug}/tags`).
- **Quick Filter Tabs**:
  - **All**: all active conversations (pinned conversations stay at the top).
  - **Unanswered**: threads with an unanswered customer message, sorted by longest wait time first.
  - **Unread**: threads with unread messages.
  - **Archived**: archived conversations.
- **Toolbar Utilities**: **Mark all as read**, **Refresh**, and **Full screen** toggle.

### 3. Conversation Thread & Right Sidebar

- **Center Thread**: displays message history, pinned message bar, team presence & **Takeover** bar, AI draft suggestions, and the message composer.
- **Right Sidebar (Customer Profile)**: includes two tabs — **Info** (CRM profile fields, lead status, tags, internal notes, conversation AI toggle) and **Copilot** (internal AI chat assistant).

## OmnyBot Notification Inbox (`/inbox/omnybot`)

Selecting **OmnyBot** at the top of the channel rail opens 4 notification streams:

| Channel | Query `channel` | Contents |
| :--- | :--- | :--- |
| **Mentioned** | `mentioned` | Alerts when a teammate `@mentions` you or replies to your internal note. |
| **Channels** | `channels` | Connection and disconnection alerts for connected messaging channels. |
| **Wallet** | `wallet` | Low-balance and out-of-token alerts for the workspace AI wallet. |
| **AI** | `ai` | **Knowledge Gap** alerts when the AI lacks enough knowledge-base data to answer a customer. |

## Next Steps

- [Handling Conversations](/inbox/conversations/) — rich messaging, in-thread search, CRM profile editing, and team collaboration.
- [Zalo Group Chat](/inbox/group-chat/) — group and community threads, member `@mentions`, and composer lock states.
- [AI Copilot & Auto-Reply](/inbox/ai-copilot/) — AI drafts, auto-send, human handoff, and the internal Copilot assistant.