# Quick start with Inbox

Inbox Interface

Quickly understand the Inbox operation interface by area division.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2F00f53J9kGKOLZXSjeLIy%2FMy_Photor_1742470344118.jpg?alt=media&#x26;token=b9ddecb9-0c77-4477-be65-39b21b89358c" alt=""><figcaption></figcaption></figure>

**Orange Area: Inbox Search and Filtering Area** - By entering keywords or setting specific conditions, helps users quickly find conversations or messages, including:

* Agent status: Set the current status as "Away" or "Available". When set to "Away", conversations are not automatically assigned (unless special settings in the assignment rules apply).
* Search area: Basic search to help quickly find target customer sessions.
* Filter area: Quickly filter Inbox conversations by allocation status, contact tags and custom filters.
* Options: Data analysis, Inbox settings.

**Green Area: Conversation List** - Lists all conversations, allowing users to quickly switch and select which conversation to view or continue.

**Purple Area: Chat Area** - This is the main area where users communicate in real-time and send messages, displaying both parties' messages, including:

* Conversation area: Displays the conversation content.
* Message input area: Users input text, emojis, files, templates, etc., to be sent.
* Operation area: Provides a series of agent-executable actions, such as marking as favorite, transferring conversations, etc.

**Yellow Area: Customer Details** - Displays detailed information about the user related to the current conversation, such as name, profile image, contact details, and allows adding tags and modifying contact attributes.

## Inbox Search and Filtering Area

Helps users quickly find the desired conversations or messages.

### Basic Search

Inbox supports searching historical chat records by **phone number and name**. Note that text-based search for conversations is currently not supported.

Operation guidance: Log in to YCloud Inbox > Click the search box at the top left > Enter name/number to search.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2Fupc8XCPQug2zH5dz30p9%2FMy_Photor_1742470601112.jpg?alt=media&#x26;token=76dc40a4-f5a3-48cf-8374-a47d88ea5c31" alt=""><figcaption></figcaption></figure>

### Quick Filter

Quickly filter Inbox conversations by allocation status, contact tags and custom filters. Each category supports single selection only.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FUO1gnzeeudKMjY7S0MsB%2FMy_Photor_1742470737713.jpg?alt=media&#x26;token=f6069348-255f-45b1-bf50-db66db38c540" alt=""><figcaption></figcaption></figure>

### Advanced Filter

Inbox supports advanced filtering of conversations by combining single or multiple conditions, with multiple selections within conditions.

Click the add button at the left to custom filter. Advanced filtering  will automatically pop up.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FRBXpKcArZA6H0MxJSsrh%2FMy_Photor_1742470975478.jpg?alt=media&#x26;token=d974e033-2db0-4579-9562-5c009b3e84a3" alt=""><figcaption></figcaption></figure>

**Adding Conditions**

Select the conditions to filter by and set the filtering rules. After adding, you can continue to click "Add filter" to add more conditions.

{% hint style="info" %}
The relationship between conditions is "and".
{% endhint %}

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FWTZWYpwge1VrPF48nvIa%2FMy_Photor_1742471105493.jpg?alt=media&#x26;token=be58b085-0b53-4eec-adff-8efaa4cb1f8e" alt=""><figcaption></figcaption></figure>

**Deleting Conditions**

**Hover the mouse over the corresponding condition and click the cross to delete the added filtering condition.**

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2F5MSGxzIlALXRNXNjHRvA%2FMy_Photor_1742471933624.jpg?alt=media&#x26;token=56b2b702-f0e9-4aa1-bc10-3a72112326a6" alt=""><figcaption></figcaption></figure>

**Viewing Filter Results**

View the filtered results in the conversation list.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FuMOd8MegtlX907CXMiVl%2Fimage%20(390).png?alt=media&#x26;token=841c2346-495d-4eae-a916-6d8e771209d7" alt=""><figcaption></figcaption></figure>

**Closing Advanced Filter**

Click the advanced filter button again to close it.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FZEdrwwz2Paq10rZfAkr8%2Fimage%20(391).png?alt=media&#x26;token=9117e4ee-9cf7-4cbb-99f8-cff83bf08d32" alt=""><figcaption></figcaption></figure>

### Bulk transfer and close for conversations

Inbox provides functions for bulk transferring and closing conversations.Hover your mouse over the conversations you want to operate in batches, and a check box will appear on the left side of the conversation. Check the conversations you need to process in batches. On the right side of the page, you can see the number of conversations currently selected. Press the ESC key on your keyboard to cancel the current selection.

If you need to transfer conversations in batches, click the transfer button in the upper right corner of the conversation list and select the specific customer service you want to transfer these conversations to or transfer them to the "unassigned" group. The system will pop up a secondary confirmation window. After confirmation, the system will complete the transfer operation for you.

If you need to close conversations in batches, click the close button in the upper right corner. The system will pop up a confirmation window. After confirmation, the system will close the selected conversations in batches for you.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2For3Bs2AdCahApDahf6pZ%2Fimage.png?alt=media&#x26;token=8a0899d2-8cec-4f22-88e4-a40e00cad706" alt=""><figcaption></figcaption></figure>

## Inbox Chat Area

### Conversation Display Area

In Inbox, a "conversation" is the entire exchange process between you and a specific contact, including all content exchanged. A "message" is a specific piece of content sent or received during this exchange.

{% hint style="info" %}
Since Inbox is linked to all WhatsApp numbers under the YCloud account, there may be multiple conversation windows for the same customer. Please distinguish the corresponding WhatsApp number for the conversation by the Inbox name next to the user name at the top of the chat area.
{% endhint %}

#### **Conversation Status**

* Open
* Close

**Conversation Status Explanation**

Conversation opened by {{1}}: The conversation was opened by the client/agent.

Conversation was assigned to Agent B by Agent A: The current conversation was transferred from Agent A to Agent B.

The ”{{1}}“ tag was added by Agent A: Agent A added a “XXX” tag to the current customer.

Conversation was starred by Agent A: Agent A starred the current conversation.

Conversation was unstarred by Agent A: Agent A unstarred the current conversation.

Conversation status was changed to "Closed" by Agent A: The current conversation was closed by Agent A.

Conversation status was changed to "Closed" automatically: The current conversation was automatically closed after 24 hours without a reply from the customer.

#### **Message Status**

<img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FYHteq2Vx2mjHdN65LLP1%2Fimage%20(376).png?alt=media&#x26;token=1f7fc90c-1a86-40d3-912f-043db40d9a93" alt="" data-size="line"> Sent: The message has been successfully sent.

<img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FxgqS81CJjrG64ke4wUE2%2Fimage%20(377).png?alt=media&#x26;token=072101ca-0c73-4318-80b6-40f316e524e2" alt="" data-size="line"> Delivered: The message has been successfully delivered to the recipient's phone or any connected device.

<img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FMW1OpIwkc2nVPdhk4rLD%2Fimage%20(378).png?alt=media&#x26;token=e6162771-e21f-472a-9b91-1bcc59dd2efb" alt="" data-size="line"> Read: The message has been read.

<img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FKLEp3q6d8YEGyiInk8OC%2Fimage%20(379).png?alt=media&#x26;token=6c6e2c5e-8184-4ca2-9cf0-4b3eb726da45" alt="" data-size="line"> Send Error: Hover the mouse to display the error reason.

#### **Message Actions**

Hover the mouse over the message to reveal the "three-dot operation button", click the button to perform related actions.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2Fm2Zi2Un2fT98BMvwwodK%2Fimage%20(392).png?alt=media&#x26;token=dbbb9637-707c-4c22-aa9d-b77ff2de3992" alt=""><figcaption></figcaption></figure>

* **Message Quote (Reply)**: When you quote a message on WhatsApp, it attaches the original message to your new message, making it clear which message you are replying to, avoiding confusion.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2Fwew0Nv72czvX73aJ3XEU%2Fimage%20(403).png?alt=media&#x26;token=a572943e-4331-44c1-a6e6-5e67099647e1" alt=""><figcaption></figcaption></figure>

* **Message Reaction (React)**: The message reaction feature on WhatsApp is similar to Facebook's Reaction emojis. Users can like, express love, surprise, sadness, etc., to a message. This feature allows you to express your feelings about a message more quickly and intuitively without typing a text reply.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FJ5bjIaNWwYGGRz0QGTts%2Fimage%20(404).png?alt=media&#x26;token=d6c6833c-8a83-4477-a528-334e15f66d2e" alt=""><figcaption></figcaption></figure>

#### **Sender**

Distinguish the sender by avatar.

<table><thead><tr><th width="247">Sender</th><th>Avatar</th></tr></thead><tbody><tr><td>Agent</td><td><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FqEQK7cpPvPHlO8bqjWJ2%2Fimage%20(406).png?alt=media&#x26;token=90f1cbea-4d0a-4882-bdb5-cd4aa5ea5c69" alt="" data-size="original"></td></tr><tr><td>Chatbot</td><td><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FTUL1sfWjyYMVGWE9ms3j%2Fimage%20(408).png?alt=media&#x26;token=c14a6e76-0ef0-4ada-9ed4-585110a17755" alt="" data-size="original"></td></tr><tr><td>API</td><td><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FFpkeQwvk1aa3J7DgQnYA%2Fimage%20(409).png?alt=media&#x26;token=37d5b0b3-6b96-488f-81d5-9ee25f08824b" alt="" data-size="original"></td></tr><tr><td>Inbox Auto-Reply</td><td><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FzQQH4oPE6nCdaVX3yeiE%2Fimage%20(407).png?alt=media&#x26;token=df629c6e-4901-44ed-a392-a7d87d24e73b" alt="" data-size="original"></td></tr></tbody></table>

### Message Input Area

**Conversation Assigned to Me**

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2Fe428kPG7OITZzjjTzNmS%2Fimage%20(410).png?alt=media&#x26;token=8949f8e2-f584-4bff-b038-030b3a210cd5" alt=""><figcaption></figcaption></figure>

**Add messages through the chat area icons, supporting the following functions:**

1. Add emoji
2. Add attachment
3. Send template

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FZoty1NjdbV7MIbRbLufb%2Fimage%20(413).png?alt=media&#x26;token=c0d11311-550c-4533-84ad-ac74231ffe3b" alt=""><figcaption></figcaption></figure>

**Add Quick Reply**

Enter "/" to select a quick reply to add into the chat box. For details, see: [Quick Reply](https://helpdocs.ycloud.com/help-center/inbox/company-canned-response)

**Send Message**

Send the message by pressing Enter on the keyboard or clicking the "Send" button.

## User Information and Operation Area

### Basic Operations Supported

**Conversation Tags**

You can tag the current conversation or historical conversations. For details, see: [Conversation Tags](https://helpdocs.ycloud.com/help-center/inbox/conversation-tags)

**Star User**

For high-value customers, you can also click the star to favorite this customer. This customer will then be listed under the Starred label on the left.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FbE8hSQpOWANg017vdJOq%2Fimage%20(414).png?alt=media&#x26;token=ed38c064-6b06-4faa-aa05-b70f45e3b170" alt=""><figcaption></figcaption></figure>

**Transfer Conversation**

Click the "Transfer" button next to the user name at the top of the conversation area, and select the person to transfer to from the dropdown list. You can enter a name for quick search.

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FqcbLcJCRw9qBigpMucsr%2Fimage%20(372).png?alt=media&#x26;token=42325181-7c63-4fba-ada6-4df30cbe60b2" alt=""><figcaption></figcaption></figure>

**Close Conversation**

Click the "Close" button next to the user name at the top of the conversation area to end the conversation. The conversation status changes to "Closed".

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FYrEcK1Fo6I9dqDO5LHb6%2Fimage%20(373).png?alt=media&#x26;token=3b2fdb6f-35a9-46c1-89e7-779d5736d9bc" alt=""><figcaption></figcaption></figure>

## Customer Details

Click the "Expand" button or the customer's avatar to expand the customer details, and edit and modify customer attributes through the customer details.

* Modify customer nickname: Click the edit icon next to the customer's name.
* Modify customer assignment: Click the assignment dropdown box, select a customer service person or team.
* Add tags: Find the Tags category, click the "➕" button to select existing tags.
* Modify attributes: Click the text behind the attributes to modify the relevant attributes. Clicking on a blank area will save the changes (you can also press Enter on the keyboard to save).

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FOsFoUdtFCOceEYQ1doZa%2Fimage%20(374).png?alt=media&#x26;token=9a67cf98-2d8d-4462-a670-edf871c67bbe" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3466127247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSIAnjLP6KQY5rvyuaq5K%2Fuploads%2FZIES16OV3f3vAiUNEj3I%2Fimage%20(375).png?alt=media&#x26;token=25c98630-8c3c-40c8-8c77-7e9042c99fb8" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpdocs.ycloud.com/help-center/inbox/quick-start-with-inbox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
