# Shared inbox

The inbox shows every DM conversation for your TikTok account. That includes chats your automations or an [AI Expert](/ai/expert-conversations) are handling, and chats your team is answering.

Open it from the sidebar: **Engage** → **Inbox**.

*Screenshot: The Inbox on the Needs reply tab: conversation list with reply-window flags, an open conversation with automation and teammate messages, and the contact panel*

The screen has three parts:

- **Conversation list** (left): search, the **Filter** button, the view tabs and the list of chats.
- **Thread** (middle): the messages, the conversation status, the automation control and the reply box.
- **Contact panel** (right): who is handling the chat, labels, and details about the customer.

:::note
The inbox shows chats for the TikTok account selected at the top of the sidebar. If you connected more than one account, switch accounts there to see the other account's chats.
:::

## View tabs

Four tabs above the list sort your chats into work queues. The inbox opens on **Needs reply** and remembers the last tab you used.

| Tab | What it shows |
| --- | --- |
| **Needs reply** | The customer wrote last, no automation is answering, the chat is not Resolved, and you can still reply. Start here. |
| **Expiring** | Chats where TikTok's reply window closes within the next 6 hours. The chat that closes soonest is at the top. |
| **Requests** | New chats that TikTok put in message requests. They wait here until you reply. |
| **All** | Every conversation, newest first. |

**Needs reply**, **Expiring** and **Requests** show a count when they have chats. The counts follow your filters, so a tab's number always matches what the tab shows.

When a tab is empty, you see a message such as **You're all caught up**, with a button to **View all conversations**.

## Read a conversation row

Each row has two lines.

- **Line 1:** the customer's name and the time of the last message. Unread chats are **bold** with a dot.
- **Line 2:** a preview of the last message. Messages you sent start with "You:". Images, videos, stickers, shared posts and Q&A cards show a short label instead of text.

Line 2 also shows small flags, but only when they matter:

| Flag | Meaning |
| --- | --- |
| ⚡ icon | An automation is handling this chat right now. |
| ✨ icon | An AI Expert is answering this chat right now. |
| **Request** | TikTok filed this chat as a message request. |
| **3h left** (for example) | Time left before the reply window closes. It turns amber when less than 6 hours are left. |
| **2 follow-ups left** (for example) | The 48-hour window has passed. You can send only this many more messages until the customer replies. |
| **Missed** | The customer wrote, but the reply window closed before anyone answered. |
| ✓ icon | The chat is Resolved. |

For the rules behind the time and follow-up flags, see [Messaging limits](/inbox/messaging-limits).

## Search and filter

### Search

Type in **Search conversations...** at the top of the list. Search looks at:

- the customer's name and TikTok username
- the text of every message in the chat

Search only looks in the tab you are on, but it covers every chat in that tab, not only the ones loaded on screen. It does not search labels or automation names.

If nothing matches in **Needs reply**, **Expiring** or **Requests**, you see **No matching conversations** and *"Only this tab was searched. Look in all conversations."* Click **View all conversations** to switch to **All**. Your search text stays, so the results appear right away. Click **Clear filters** to start over instead.

### Filter

Click the **Filter** button (next to search) to narrow the list. When filters are on, the button shows how many.

| Filter | Options |
| --- | --- |
| **Status** | **All statuses**, **New**, **Open**, **Pending**, **Resolved** |
| **Reply window** | **Any window**, **Open**, **Follow-ups only**, **Closed** |
| **Automation** | **Any automation**, **Running**, **AI Answering**, **Paused** |
| **Assignee** (Pro) | **Anyone**, **Assigned to me**, **Unassigned** |

Click **Clear filters** to reset them all. Filters work together with the tabs and search.

## Read a thread

Click a row to open the chat. Each message you sent shows who sent it, under the bubble:

- **Automation**: sent by one of your automations (marked ⚡).
- **AI Expert**: written by an AI Expert (marked ✨).
- A teammate's name: sent by a person on your team from the inbox. The bubble shows their initials.
- **TikTok auto message**: an auto message that TikTok sent for you, such as a welcome message.

You may also see:

- A card at the top showing the post and comment the chat came from (**From a comment**, **matched "keyword"**, **View on TikTok**).
- A line such as **Started from a TikTok ad** or **Started from a tiktok.me link**.
- Images, videos and stickers the customer sent, and emoji reactions on messages.
- **Seen** under your last message that the customer has read.
- **Blocked by TikTok policy** under a message TikTok refused to deliver.

## Reply to a customer

1. Open the chat.
2. Type in the box at the bottom. Press **Enter** to send. Press **Shift + Enter** for a new line.
3. To send a picture, click **Attach image**. Use a JPG or PNG under 3 MB. Then click **Send**.
4. To send one of your TikTok posts, click **Share a post**, pick a post, then click **Share post**.

When you send a reply:

- Automation **pauses** for this chat. A running flow stops, and new automations won't start here until someone clicks **Resume automation**. See [Human handoff](/inbox/human-handoff).
- The chat's status changes to **Pending** (waiting for the customer).
- If the chat had no one assigned, it is assigned to you.
- If it was a message request, it moves out of **Requests**.

Above the reply box, a short line tells you what to know before you send, for example **5h 12m left to reply** or **Sending a reply pauses automation for this chat.** See [Messaging limits](/inbox/messaging-limits#what-you-see-in-the-inbox) for every message.

If your role can't reply (for example **Viewer**), there is no reply box. A view-only bar with a lock icon says **Your role can view this chat but can't reply.**

:::caution
You can only reply while TikTok's reply window is open. When it is closed, the reply box is replaced by: **The reply window is closed. You can reply once the customer messages again.**
:::

Some chats don't accept images. If TikTok refuses, you see an error and the image is not sent. Send a text message instead.

## Contact panel

Click the person icon (**Contact details**) in the thread header to show or hide the panel. On a narrow screen or a phone, the panel slides over the thread. Click outside it or press **Esc** to close it.

The panel has two parts.

**This conversation**

- **Assigned to** (Pro): pick the teammate who owns this chat, or **Unassigned**.
- **Labels** (Pro): labels for this chat.

**Contact**

- **Follower**, **First source**, **Trigger** and **First seen**.
- **Labels** (Pro): labels that stay with this person across all their chats. You can use them in campaign audiences.
- **Notes**: free text about the customer.
- **Custom fields** (Pro): click **Add a custom field** to store extra data.
- **View full profile** opens the contact's page in [Contacts](/contacts).

Changes save on their own. You see **Saving…**, then **Saved**. If you see **Couldn't save.**, click **Retry**.

## New message alerts

When a customer sends you a DM and you are on another page in Tuku, a pop-up shows their name and the message. Click **View** to open the chat.

- Only customer messages trigger it. Messages your automations send do not.
- Several messages from the same customer update one pop-up, so you don't get a pile of them.
- You don't get these pop-ups while you are on the Inbox page. The list updates by itself there.
- Only people whose role can see the inbox get them. See [Members](/settings/members#roles).

## Who can do what

- **Administrator**, **Manager** and **Agent** can reply, change the status, pause or resume automation, and assign chats.
- **Viewer** can read the inbox but can't reply or change anything. Viewers see a view-only bar instead of the reply box.
- **Billing Manager** can't open the inbox.

Assigning chats, labels and custom fields need the Pro plan. See [Plans and pricing](/discover/plans-and-pricing).

## Troubleshooting

**A chat is missing from the list.**
Search and filters only cover the tab you are on. Switch to **All** (or click **View all conversations** on the empty list) and click **Clear filters**. If you connected several TikTok accounts, check which account is selected at the top of the sidebar.

**I can't type a reply.**
If you see **Your role can view this chat but can't reply.**, your role is view-only. Ask an Admin to change it in [Members](/settings/members). Otherwise, the reply window is closed, or the customer has not sent a message yet. You can reply when the customer writes again. See [Messaging limits](/inbox/messaging-limits).

**A red banner says DMs aren't available, or asks me to reconnect.**
Tuku can't send DMs for this account right now. Click **View checks** to see what is wrong. See [Connect TikTok](/getting-started/connect-tiktok).