> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox overview

> Manage WhatsApp conversations from a shared team inbox

## Inbox variants

Kapso provides three ways to access the inbox:

* **App inbox** — Built into the main dashboard at `app.kapso.ai`. Full access to all project features.
* **Standalone inbox** — Separate app at `inbox.kapso.ai`. For team members who only need to handle conversations.
* **Embedded inbox** — Iframe you can embed in your own app. See [Embedded inbox](/docs/platform/inbox/embedded).

## Layout

Three-panel layout:

* **Left** — Conversation list with filters and search
* **Center** — Message thread with input
* **Right** — Detail sidebar with tabs: Info, Workflow, Page

## Filters

| Filter          | Options                            |
| --------------- | ---------------------------------- |
| Status          | All, Active, Ended                 |
| Assignee        | All, Me, Unassigned, specific user |
| WhatsApp number | All, specific number               |
| Search          | Phone number                       |

The conversation list loads 30 conversations per page with infinite scroll.

## URL parameters

Deep-link into the inbox by appending query parameters:

| Parameter         | Values                           | Description                          |
| ----------------- | -------------------------------- | ------------------------------------ |
| `conversation_id` | UUID                             | Pre-selects a conversation           |
| `assignee`        | `me`, `unassigned`, or user UUID | Pre-sets the assignee filter         |
| `mode`            | `light`, `dark`, `system`        | Sets the theme (embedded inbox only) |

Example: `https://inbox.kapso.ai/projects/{id}?conversation_id={uuid}&assignee=me`

## Real-time updates

The inbox uses WebSocket for real-time updates. A green/red dot in the message thread indicates connection status.

Events pushed in real-time:

* New messages
* Message status changes (delivered, read, failed)
* New conversations
* Conversation updates (status, assignment changes)

The connection retries automatically with exponential backoff.

## Notifications

Toggle browser notifications with the bell icon in the conversation list header.

You'll get notified for new inbound messages when:

* The tab isn't focused
* You're viewing a different conversation

Preference is persisted in localStorage. Not available in the embedded inbox.

## Standalone inbox

The standalone inbox at `inbox.kapso.ai` is a separate app designed for support agents.

Invite team members to the standalone inbox without giving them access to project settings, workflows, or API keys. Useful for support teams who only need to handle conversations.

Features:

* Member management (owner/admin only)
* Account settings
* Invitation system — invite via email, new users get directed to registration
* Team members with the `human_agent` role are auto-redirected from `app.kapso.ai` to `inbox.kapso.ai`