# 收件匣搜尋

### 功能簡介 <a href="#feature-introduction" id="feature-introduction"></a>

收件匣搜尋功能讓您能快速找到特定的對話記錄，無需手動翻閱大量對話列表。透過關鍵字搜尋，您可以即時過濾出相關的對話內容，大幅提升客服工作效率。

{% hint style="info" %}
此功能支援即時搜尋（輸入即搜尋），並自動保存最近的搜尋記錄，方便快速重複查詢。
{% endhint %}

***

### 如何使用搜尋功能 <a href="#how-to-use-search" id="how-to-use-search"></a>

#### 基本搜尋 <a href="#basic-search" id="basic-search"></a>

1. **進入收件匣頁面**
   * 點選左側選單「<mark style="color:blue;">客服對話</mark>」
   * 點選「<mark style="color:blue;">所有對話</mark>」或選擇特定對話平台
2. **輸入搜尋關鍵字**
   * 在收件匣上方的搜尋框中輸入關鍵字
   * 系統會即時顯示符合的對話列表
3. **檢視搜尋結果**
   * 對話列表會自動過濾，只顯示包含關鍵字的對話
   * 符合的關鍵字會以醒目方式標示

#### 搜尋範圍 <a href="#search-scope" id="search-scope"></a>

系統會搜尋以下欄位：

* 對話內容（使用者訊息與 AI 回覆）
* 使用者名稱
* 對話標題（如有設定）
* 聯絡人資訊（如有串接）

{% hint style="warning" %}
搜尋功能僅能搜尋當前顯示的對話匣（如 LINE、Facebook、Web Chat 等）。如需跨平台搜尋，請使用「所有對話」頁面。
{% endhint %}

***

### 進階搜尋技巧 <a href="#advanced-search-tips" id="advanced-search-tips"></a>

#### 使用篩選條件 <a href="#using-filters" id="using-filters"></a>

除了關鍵字搜尋，您還可以結合以下篩選條件：

1. **時間範圍**
   * 今日對話
   * 最近 7 天
   * 最近 30 天
   * 自訂日期區間
2. **對話狀態**
   * 進行中
   * 已結束
   * 待處理
3. **AI 助理**
   * 選擇特定 AI 助理的對話

#### 搜尋組合範例 <a href="#search-combination-examples" id="search-combination-examples"></a>

**範例一：查詢最近退貨相關對話**

```
搜尋關鍵字：退貨
時間範圍：最近 7 天
對話狀態：全部
```

**範例二：查詢特定客戶的歷史對話**

```
搜尋關鍵字：王小明
時間範圍：最近 30 天
AI 助理：客服 AI
```

***

### 應用情境 <a href="#use-cases" id="use-cases"></a>

#### 情境一：客服品質監控 <a href="#use-case-customer-service-quality-monitoring" id="use-case-customer-service-quality-monitoring"></a>

**需求**：主管需要檢視包含「退費」關鍵字的所有對話，評估處理品質

**操作方式**：

1. 在搜尋框輸入「退費」
2. 設定時間範圍為「最近 7 天」
3. 逐一檢視搜尋結果，確認處理是否符合標準

#### 情境二：問題追蹤 <a href="#use-case-issue-tracking" id="use-case-issue-tracking"></a>

**需求**：使用者回報某個問題，需要找出相關的歷史對話記錄

**操作方式**：

1. 輸入使用者名稱或關鍵問題描述
2. 查看過往對話記錄
3. 了解問題發生經過與處理情況

#### 情境三：效能分析 <a href="#use-case-performance-analysis" id="use-case-performance-analysis"></a>

**需求**：分析特定產品的諮詢量與問題類型

**操作方式**：

1. 搜尋產品名稱關鍵字
2. 匯出搜尋結果（如系統支援）
3. 分析常見問題與改善方向

***

### 常見問題 <a href="#faq" id="faq"></a>

#### Q：搜尋速度會受對話數量影響嗎？ <a href="#faq-search-speed-affected-by-volume" id="faq-search-speed-affected-by-volume"></a>

**A**：系統使用高效能搜尋技術，即使對話數量龐大，也能在 1-2 秒內返回結果。但建議適當使用時間範圍篩選，以獲得最佳體驗。

#### Q：搜尋是否區分大小寫？ <a href="#faq-case-sensitive-search" id="faq-case-sensitive-search"></a>

**A**：不區分。輸入「退貨」或「退貨」都會得到相同結果。

#### Q：可以同時搜尋多個關鍵字嗎？ <a href="#faq-multiple-keywords" id="faq-multiple-keywords"></a>

**A**：可以。輸入多個關鍵字（以空格分隔），系統會搜尋包含任一關鍵字的對話。

範例：輸入「退貨 退款」會搜尋包含「退貨」或「退款」的對話。

#### Q：搜尋歷史會保存嗎？ <a href="#faq-search-history-saved" id="faq-search-history-saved"></a>

**A**：系統會保存最近的搜尋關鍵字，方便您快速重複查詢。搜尋歷史會在瀏覽器中保存，清除瀏覽器資料會同時清除搜尋歷史。

#### Q：為什麼搜尋不到某些對話？ <a href="#faq-conversation-not-found" id="faq-conversation-not-found"></a>

**A**：可能原因：

* 對話已被刪除或封存
* 您沒有該對話的存取權限（受角色權限限制）
* 關鍵字拼寫錯誤
* 對話時間超出篩選範圍

***

### 注意事項 <a href="#notes" id="notes"></a>

{% hint style="info" %}
**權限說明**

搜尋結果會受到您的角色權限限制：

* 只能搜尋您有權存取的對話平台
* 只能搜尋您有權存取的 AI 助理相關對話
* 組織擁有者可以搜尋所有對話
  {% endhint %}

{% hint style="warning" %}
**效能建議**

* 避免使用過於常見的關鍵字（如「你好」、「謝謝」），會返回過多結果
* 善用時間範圍篩選，縮小搜尋範圍
* 建議定期封存舊對話，保持收件匣整潔
  {% endhint %}

***

### 相關功能 <a href="#related-features" id="related-features"></a>

{% hint style="info" %}
**延伸功能**

* [所有對話的功能](/conversations/reply.md)
* [對話查看器](/conversations/conversation-viewer.md)
* [回覆品質控管](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/zh-tw/channels/quality.md)
  {% endhint %}


---

# 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://docs.maiagent.ai/conversations/inbox-search.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.