> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/company-settings/ai-sdr/chat-history.md).

# チャット履歴

チャット履歴では、AI接客のリードとの会話履歴を確認し、フィードバックを付与してAIの応答を改善できます。

## チャット履歴とは

チャット履歴とは、AI接客でリードとAIの間で行われた会話の履歴を閲覧・管理する画面です。各チャットセッションの詳細を確認し、AIの応答に対してフィードバックを付与することで、AIの応答品質を継続的に改善できます。

## チャット履歴でできること

| 機能           | 説明                            |
| ------------ | ----------------------------- |
| セッション一覧の閲覧   | チャットセッションの一覧を確認できます           |
| セッション詳細の閲覧   | 各セッションのメッセージを時系列で確認できます       |
| リード情報の確認     | チャットセッションに紐づくリード情報を確認できます     |
| リード詳細の表示     | チャット履歴からリード詳細を直接確認できます        |
| ページURLの確認    | 各セッションがどのページURLで発生したかを確認できます  |
| CSVダウンロード    | チャット履歴をCSVファイルでダウンロードできます     |
| フィードバックの付与   | AIの応答メッセージにGood/Bad評価を付与できます  |
| フィードバック内容の記入 | Bad評価時に改善のためのフィードバック内容を記入できます |

## セッション一覧

### 表示項目

| 項目           | 説明                                                                   |
| ------------ | -------------------------------------------------------------------- |
| 開始日時         | チャットセッションが開始された日時                                                    |
| リード          | セッションに紐づくリードの氏名とメールアドレス。クリックするとリード詳細が表示されます。リードが紐づいていない場合は「-」と表示されます |
| 最初のメッセージ     | リードが最初に送信したメッセージの内容。メッセージの下にページURLが表示されます                            |
| トリガーされたアクション | 会話中にトリガーされたアクション名                                                    |
| メッセージ数       | セッション内のメッセージ総数                                                       |
| Good         | Good評価が付与されたメッセージの数                                                  |
| Bad          | Bad評価が付与されたメッセージの数                                                   |

### ページURL表示 <a href="#page-url" id="page-url"></a>

セッション一覧の「最初のメッセージ」列に、リードがAI接客を利用したWebサイトのページURLが表示されます。これにより、どのページでAI接客が行われたかをセッション一覧から直接確認できます。

## CSVダウンロード <a href="#csv-download" id="csv-download"></a>

チャット履歴画面の右上にある「CSVダウンロード」ボタンをクリックすると、チャット履歴をCSVファイルでダウンロードできます。

### CSVダウンロードの使い方

1. チャット履歴画面の右上にある「CSVダウンロード」ボタンをクリックします
2. CSVファイルが自動的にダウンロードされます
3. ダウンロードが完了すると、完了メッセージが表示されます

### CSV出力項目

| 項目           | 説明                      |
| ------------ | ----------------------- |
| セッションID      | チャットセッションの識別ID          |
| 日時           | メッセージの送信日時              |
| ページURL       | AI接客が表示されたWebサイトのページURL |
| 送信者          | メッセージの送信者（「リード」または「AI」） |
| メッセージ        | メッセージの内容                |
| トリガーされたアクション | メッセージに紐づくアクション名         |

### 注意事項

* CSVファイルはUTF-8（BOM付き）形式で出力されるため、Excelで直接開くことができます
* ファイル名は `ai_sdr_chat_history_YYYY-MM-DD.csv` の形式です
* 直近180日分のデータが出力対象です
* 出力件数の上限は50,000件です
* セッションIDと日時の昇順でソートされます

## リード情報の表示 <a href="#lead-info" id="lead-info"></a>

チャット履歴では、フォーム入力などを通じてリード情報が紐づいているセッションに、リードの氏名とメールアドレスが表示されます。

セッション一覧の「リード」列に表示されるリード名をクリックすると、リード詳細モーダルが表示され、リードの基本情報やイベント履歴、チャット履歴などを確認できます。

リード詳細については[リード一覧](/reports/leads.md)を参照してください。

## セッション詳細 <a href="#session-detail" id="session-detail"></a>

セッション一覧から任意のセッションをクリックすると、セッション詳細モーダルが表示されます。リードとAIのメッセージが時系列で表示されます。

### 表示項目

| 項目           | 説明                                              |
| ------------ | ----------------------------------------------- |
| 開始日時         | セッションの開始日時                                      |
| 最終更新         | セッションの最終更新日時                                    |
| リード情報        | セッションに紐づくリードの氏名とメールアドレス。クリックするとリード詳細モーダルが表示されます |
| メッセージ        | リード（右側）とAI（左側）のメッセージが時系列で表示されます                 |
| トリガーされたアクション | メッセージに紐づくアクション名がバッジで表示されます                      |

## フィードバック <a href="#feedback" id="feedback"></a>

セッション詳細画面で、AIの応答メッセージに対してフィードバックを付与できます。

### フィードバックの種類

| 種類   | 説明                   |
| ---- | -------------------- |
| Good | AIの応答が適切だった場合に付与します  |
| Bad  | AIの応答に改善が必要な場合に付与します |

### フィードバックの付与方法

1. セッション一覧から対象のセッションをクリックします
2. AIの応答メッセージの下にある「評価」セクションで「Good」または「Bad」ボタンをクリックします
3. 「Bad」を付与した場合、フィードバック内容の入力フォームが表示されます
4. フィードバック内容を記入して「送信」をクリックします（スキップも可能です）

### フィードバックの効果

* Bad評価に記入されたフィードバック内容はAIのプロンプトに動的に反映され、次回以降の応答改善に活用されます
* フィードバック内容は最大100文字まで記入できます

### 注意事項

* 同じメッセージに対するフィードバックは再度ボタンをクリックすると解除できます
* フィードバック内容は[フィードバック管理](/company-settings/ai-sdr/feedbacks.md)画面でも確認・削除できます


---

# 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.immedio.io/company-settings/ai-sdr/chat-history.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.