> 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/ja/serve/choose-channel/web-chat/website.md).

# メッセージングプラットフォームとの連携：Web サイト

## <mark style="color:blue;">1. 設定ページを開く</mark> <a href="#navigate-to-settings" id="navigate-to-settings"></a>

### 1. 経路1：ウェブサイトのサポート会話を追加する <a href="#path-add-web-chat" id="path-add-web-chat"></a>

左側のメニューで「<mark style="color:blue;">カスタマーサポートの会話 > 会話チャネル</mark>」をクリックし、右上の「<mark style="color:blue;">＋会話チャネルを連携</mark>」から「<mark style="color:blue;">Website</mark>」を選択します。

### 2. 経路2：AI アシスタントに紐付く会話チャネルから開く <a href="#path-ai-agent-link-channel" id="path-ai-agent-link-channel"></a>

左側のメニューから<mark style="color:blue;">AI 機能</mark> → <mark style="color:blue;">AI アシスタント</mark>に進み、設定するアシスタントを選択して<mark style="color:blue;">会話チャネル</mark>タブに切り替えます。変更するウェブサイトの会話チャネルを見つけ、<mark style="color:blue;">チャネル設定</mark>をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-b8489ca6969c2a5473b72ee019bf07d539d1ca45%2Fai-agent-channel-platform-settings-prod.png?alt=media" alt="AI アシスタントの会話チャネルタブ。各チャネルのカードにチャネル設定ボタンがあります"><figcaption><p>AI アシスタントの会話チャネルタブで「チャネル設定」をクリックします。</p></figcaption></figure>

設定後、ページ上部の<mark style="color:blue;">AI アシスタント設定に戻る</mark>をクリックすると、元のアシスタントの<mark style="color:blue;">会話チャネル</mark>タブに戻れます。<mark style="color:blue;">基本</mark>、<mark style="color:blue;">利用枠</mark>、<mark style="color:blue;">自動返信設定</mark>を切り替えても、この戻り先は表示され続けます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9dc1869d16658968ef1f594d157bd5045fda1b3c%2Finbox-back-to-ai-agent-settings-prod.png?alt=media" alt="会話チャネル設定ページ上部の AI アシスタント設定に戻るボタン"><figcaption><p>設定後、元の AI アシスタント設定ページに直接戻れます。</p></figcaption></figure>

{% hint style="info" %} <mark style="color:blue;">AI アシスタント設定に戻る</mark>は、AI アシスタントの<mark style="color:blue;">会話チャネル</mark>タブから開いた場合にのみ表示されます。左側のメニューの<mark style="color:blue;">会話チャネル</mark>から直接開いた場合は、従来のナビゲーションが維持されます。
{% endhint %}

#### 使用例：ウェブサイトのサポート設定を変更してアシスタントに戻る <a href="#scenario-return-to-agent" id="scenario-return-to-agent"></a>

サポート責任者が「製品問い合わせアシスタント」のウェブサイト向けサポート設定を更新する場合、その AI アシスタントの<mark style="color:blue;">会話チャネル</mark>タブで<mark style="color:blue;">チャネル設定</mark>をクリックします。変更後に<mark style="color:blue;">AI アシスタント設定に戻る</mark>をクリックすると、同じアシスタントの会話チャネル一覧に戻り、他のサポート窓口を引き続き確認できます。AI アシスタント一覧から再び探す必要はありません。

### 3. 経路3：会話チャネルの操作から開く <a href="#path-channel-management" id="path-channel-management"></a>

左側のメニューの「<mark style="color:blue;">カスタマーサポートの会話 > 会話チャネル</mark>」で設定する AI アシスタントを選択し、「<mark style="color:blue;">操作</mark>」アイコンをクリックすると、会話チャネルの設定を開けます。

## <mark style="color:blue;">2. 基本設定</mark> <a href="#basic-settings" id="basic-settings"></a>

「基本」タブの「一般」グループにある5つの分類は、それぞれ専用ページで詳しく説明しています。

### 1. 基本設定 <a href="#general-settings" id="general-settings"></a>

チャネル名、AI アシスタント、戻り先 URL、カスタムドメイン、埋め込みを許可するドメイン、公開アクセス URL、3種類の埋め込み方法については、[基本設定](/maiagent-user-guide/ja/serve/platform-settings/basic-settings.md)をご覧ください。

#### 埋め込みを許可するドメイン <a href="#allowed-embed-origins" id="allowed-embed-origins"></a>

埋め込み許可リストの動作、設定手順、有効にする前のチェックリストについては、[基本設定：埋め込みを許可するドメイン](/maiagent-user-guide/ja/serve/platform-settings/basic-settings.md#allowed-embed-origins)をご覧ください。

### 2. 外観設定 <a href="#appearance-settings" id="appearance-settings"></a>

Logo、アバター、表示設定、ライト／ダークテーマの配色については、[外観設定](/maiagent-user-guide/ja/serve/platform-settings/appearance-settings.md)をご覧ください。

### 3. 機能設定 <a href="#feature-settings" id="feature-settings"></a>

有効化、ファイルのアップロード許可、ドキュメントの引用、OCR、ツールの表示モード、質問セットの選択肢の表示モード、AI 認識設定については、[機能設定](/maiagent-user-guide/ja/serve/platform-settings/function-settings.md)をご覧ください。

### 4. インタラクション設定 <a href="#interaction-settings" id="interaction-settings"></a>

開始メッセージ、会話開始時の質問、開始メッセージの選択肢を Agent のコンテキストに含める設定、会話の表示設定、満足度アンケート、利用枠を使い切った際のメッセージについては、[インタラクション設定](/maiagent-user-guide/ja/serve/platform-settings/interaction-settings.md)をご覧ください。

#### 開始メッセージの選択肢を Agent のコンテキストに含める <a href="#include-greeting-in-context" id="include-greeting-in-context"></a>

有効にする前後の違い、適した用途、注意事項については、[インタラクション設定：開始メッセージの選択肢を Agent のコンテキストに含める](/maiagent-user-guide/ja/serve/platform-settings/interaction-settings.md#include-greeting-in-context)をご覧ください。

### 5. ログイン設定 <a href="#login-settings" id="login-settings"></a>

**SSO のログイン元を設定する**

* MaiAgent は現在、Keycloak との連携による SSO（Single Sign-On）に対応しています。
* 「<mark style="color:blue;">ログイン元</mark>」ドロップダウンで切り替えます。
* 認証方式として Maiagent または Keycloak を選択します。

**埋め込み元からログインせずに会話する**

Web Chat を自社サイトに埋め込み、ユーザーがすでにそのサイトにログインしている場合は、「<mark style="color:blue;">埋め込み元から Source ID でログインせずに会話することを許可</mark>」を有効にすると、直接会話できます。設定方法と署名連携については、[連絡先の Source ID でログインせずに会話する](/maiagent-user-guide/ja/serve/choose-channel/web-chat/source-id-access.md)をご覧ください。

**Keycloak のログイン情報を引き継いでツールを呼び出す**

ログイン元に Keycloak を選択している場合は、「<mark style="color:blue;">Keycloak のログイン情報を引き継いでツールを呼び出す</mark>」を有効にすると、AI アシスタントが MCP／API ツールを呼び出す際に訪問者本人の Keycloak ログイン認証情報を自動的に付与します。設定方法と注意事項については、[Keycloak のログイン情報を引き継いでツールを呼び出す](/maiagent-user-guide/ja/serve/choose-channel/web-chat.md#keycloak-token-passthrough)をご覧ください。

## <mark style="color:blue;">3. 自動返信設定</mark> <a href="#auto-reply-settings" id="auto-reply-settings"></a>

ここではボットが返信する時間帯を設定できます。

* 日付の横のスイッチをクリックし、週のどの日に返信するかを選択します。
* 時間帯の設定：開始時刻と終了時刻を選択します。
* 時間帯の追加：複数の時間帯が必要な場合は、「<mark style="color:blue;">+時間帯を追加</mark>」をクリックして追加し、時間帯を設定します。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/serve/choose-channel/web-chat/website.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.