# Handling Conversations

The conversation view lets agents manage end-to-end customer threads while updating CRM records and coordinating with teammates so two agents never reply over each other.

:::note[Required permissions]
You need **`inbox:read:all`** to view conversation history and **`inbox:reply`** to send replies, interact with messages (react, recall, pin), or change thread state (pin, archive, mute).
:::

## Channel Capability Matrix

Some message actions depend on what the underlying messaging platform supports:

| Feature | Zalo | Facebook | WhatsApp | Webchat |
| :--- | :---: | :---: | :---: | :---: |
| Quote reply | Yes | Yes | Yes | Yes |
| Reactions | 6-icon palette | No | Unicode | No |
| Recall own message | Yes | No | No | No |
| Forward message | Yes | Yes | Yes | Yes |
| Pin message (up to 3) | Yes | Yes | Yes | Yes |
| Stickers & sticker suggestions | Yes | No | No | No |
| Contact card / Location | Yes | No | No | No |
| Outbound typing indicator | Yes | No | No | Yes |
| Friend actions & phone lookup | Yes | No | No | No |
| Group chat & Communities | Yes | No | No | No |
| Web visitor metadata (HMAC & URL) | No | No | No | Yes |

## Composing & Sending Messages

The message composer supports:

- **Text & Link Previews**: pasting a URL displays a compose-time link preview card before sending.
- **Images, Videos & Files**:
  - Drag-and-drop or paste images (`Ctrl+V`) from your clipboard: images are staged as composer previews so you can attach a caption and send together.
  - Videos and documents upload directly and send immediately.
- **Quote Reply**, **Forward**, **Reactions**, and **Recall** (Zalo): available directly on individual message bubbles.
- **Pinned Messages**: pin up to **3 team-shared messages** per conversation. When the limit is reached, a dialog lets you choose which existing pin to replace.
- **`+` Attach & Utilities Menu**: quick access to **AI Draft**, **Images & Videos**, **Files & Documents**, **Contact Card** (Zalo), **Location** (Zalo), **Stickers** (Zalo), and **Quick Replies (Snippets)**.
- **Quick Replies (Snippets)**: insert saved templates into the composer, or add, edit, and delete snippets with optional shortcuts inline.

:::tip[Delivery & read status]
In 1-1 threads, outbound messages display real-time **Delivered** and **Seen** status. If a send fails on the live channel session, the message bubble shows an error state with a **Retry** action.
:::

## Searching & Filtering Inside a Thread

Click the **Search** icon in the conversation header to open the 4-tab filter panel:

1. **Messages (`MESSAGES`)**: keyword search with highlighted matches; click any result to jump straight to that message.
2. **Media (`MEDIA`)**: grid gallery of shared images and videos with a full-screen lightbox (zoom, keyboard navigation, download, and jump-to-message).
3. **Files (`FILE`)**: list of shared documents with direct download buttons.
4. **Links (`LINK`)**: automatically extracts all URLs shared in the thread.

## Team Presence & Takeover

When multiple agents open the same conversation, the presence bar above the composer prevents duplicate replies:

- **Live Presence**: shows which teammates are currently viewing or composing in the thread (expires automatically after 30 seconds of inactivity).
- **Takeover (Claim)**: click **Takeover** to lock exclusive handling for yourself; other teammates' composers lock and display your name.
- **Release**: click **Release** to hand the thread back to the team (locks also release automatically when you leave the thread or after 90 seconds of inactivity). Teammates can still click **Takeover** to claim control if needed.

## Customer Profile Sidebar (Info Tab)

Click the **Info (i)** icon in the top-right header to toggle the customer profile panel:

- **Quick Actions**: **Pin conversation**, **Mute notifications**, **Mark as unread**, and Zalo friend actions (when supported).
- **Webchat Visitors**: displays the identity verification badge (**Verified (HMAC)** or **Unverified**) and the visitor's current page URL.
- **Auto-Reply Toggle**: enable or pause AI auto-reply for this specific conversation (see [AI Copilot & Auto-Reply](/inbox/ai-copilot/)).
- **Inline CRM Fields**: edit **Display Name**, **Phone Number**, **Gender**, and **Lead Status** (`New`, `Contacted`, `Engaged`, `Quoted`, `Not Interested`, `Converted`).
- **Tags**: add or remove CRM tags.
- **Internal Notes**: threaded team notes supporting 1-level replies, editing/deleting your own notes, and `@mentioning` teammates (which notifies them under **OmnyBot → Mentioned**).