> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/conversations/inbox-search.md).

# 受信トレイ検索

### 機能概要 <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>

**例 1：直近の返品関連の会話を検索する**

```
検索キーワード：返品
期間：直近 7 日間
会話ステータス：すべて
```

**例 2：特定顧客の過去の会話を検索する**

```
検索キーワード：山田太郎
期間：直近 30 日間
AI アシスタント：カスタマーサポート AI
```

***

### 活用シーン <a href="#use-cases" id="use-cases"></a>

#### シーン 1：カスタマーサポート品質のモニタリング <a href="#use-case-customer-service-quality-monitoring" id="use-case-customer-service-quality-monitoring"></a>

**ニーズ**：管理者が「返金」というキーワードを含むすべての会話を確認し、対応品質を評価したい

**操作方法**：

1. 検索ボックスに「返金」と入力します
2. 期間を「直近 7 日間」に設定します
3. 検索結果を一件ずつ確認し、対応が基準を満たしているかチェックします

#### シーン 2：問題のトラッキング <a href="#use-case-issue-tracking" id="use-case-issue-tracking"></a>

**ニーズ**：ユーザーから報告された問題について、関連する過去の会話履歴を見つけたい

**操作方法**：

1. ユーザー名、または問題のキーワードを入力します
2. 過去の会話履歴を確認します
3. 問題が発生した経緯と対応状況を把握します

#### シーン 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" %}
**関連機能**

* [すべての対話の機能](/maiagent-user-guide/maiagent-user-guide-ja/conversations/reply.md)
* [対話ビューア](/maiagent-user-guide/maiagent-user-guide-ja/conversations/conversation-viewer.md)
* [返信品質の管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/ja/channels/quality.md)
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/conversations/inbox-search.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.