初期テンプレートの内容
**Email件名のテンプレート**
```
【有人対応への転送】会話があなたに割り当てられました — {inboxName}
```
**Email本文のテンプレート**
```
{agentName}さん、こんにちは。
サポート窓口「{inboxName}」で、{customerName}さんからの会話があなたに割り当てられました。
次のリンクをクリックして、管理画面の会話を開いてください：
{conversationUrl}
```
**お知らせタイトルのテンプレート**
```
会話が割り当てられました：{customerName}
```
**お知らせ本文のテンプレート**
```
サポート窓口「{inboxName}」で、{customerName}さんからの会話が{agentName}さんに割り当てられました。管理画面で確認してください。
```
{% endstep %}
{% step %}
### 設定を保存します
設定が完了したら保存します。設定は直ちに反映されます。その後は各チャネルのスイッチと対象イベントに応じて通知が送信されます。Emailと通知センターは割り当て時のみ、WebhookはAIによる有人対応への転送判断、割り当て、AIへの復帰、待機タイムアウト時に送信します。
{% hint style="info" %} 有人対応への転送を有効にするをオフにすると通知も停止しますが、通知設定は**保持されます**。再び有人対応への転送をオンにすると、元の設定が復元されます。
{% endhint %}
{% endstep %}
{% endstepper %}
## 担当者と管理者に届く内容
### Email通知
割り当てられた担当者には、MaiAgentブランドのデザインのEmailが届きます。件名と本文はテンプレートから生成され、会話へのリンクが含まれます。設定したコピー通知の宛先は、同じメールを**CC**として受信します。すべての受信者が互いの宛先を確認できます。
### 通知センターのお知らせ
管理画面の右上にあるベルをクリックして通知センターを開き、組織のお知らせタブに切り替えると、種類が有人対応への転送通知のお知らせを確認できます。お知らせ内の引き継ぎに進むをクリックすると、対象の会話が直接開きます。
{% hint style="info" %}
有人対応への転送通知は頻繁に発生するトランザクションイベントです。お知らせ一覧が過剰に増えないように、この種類のお知らせは送信から**7日後に自動的に期限切れ**になります。
{% endhint %}
### 外部システムに届く内容
外部システムには、識別情報のみを含むJSONイベントが届きます。内容は、イベント名、イベントIDと発生時刻、会話、会話プラットフォーム、組織、顧客、イベント発生時点で割り当てられていた担当者のID、および管理画面の会話へのリンクです。会話の本文は含まれません。4種類のイベントは同じフィールドを持ち、担当者が割り当てられていないイベント（転送の発動、AIへの復帰、待機タイムアウト）では、割り当て先担当者は空です。フィールドの詳細と検証例は、APIドキュメントの[有人対応への転送Webhookイベント](https://docs.maiagent.ai/api/preparation/handoff-webhook)を参照してください。
## 注意事項
* **権限**：対象の会話プラットフォームの設定権限を持つユーザーのみが、通知設定を閲覧・編集できます。既存の有人対応への転送設定の権限が適用されます。
* **担当者にEmailがない場合**：割り当てられた担当者にEmailが設定されていない場合、Emailチャネルは自動的にスキップされますが、**通知センターのお知らせは通常どおり送信されます**。ほかの受信者には影響しません。
* **チャネルは互いに独立しています**：Email、通知センター、Webhookは個別に動作します。1つのチャネルで送信に失敗しても、ほかのチャネルや会話の割り当て処理には影響しません。
* **Webhook失敗時の処理**：外部エンドポイントがタイムアウトするかエラーを返すと、システムはバックグラウンドで自動的に3回再試行します。その間も有人対応への転送とほかの通知チャネルは通常どおり動作します。受信側ではイベントIDを使って重複イベントを除外してください。
* **会話プラットフォームの「Webhook」とは異なります**：会話プラットフォームには、会話のメッセージ自体を送信する別の[Webhook](/maiagent-user-guide/ja/serve/webhook.md)機能があります。有人対応への転送Webhookは転送状態のイベントのみを送信します。両者の設定とシークレットは独立しており、互いに影響しません。
* **会話を開いた後も引き継ぎ操作が必要です**：前述のとおり、リンクは会話を開くだけです。実際に引き継ぐには、会話の上部にある私が引き継ぐボタンを押してください。
---
# 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/human-handoff/handoff-notification.md?ask=&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.
