> 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/org/contact.md).

# 連絡先

## 連絡先とは？ <a href="#what-is-contact" id="what-is-contact"></a>

**連絡先**（Contact）は MaiAgent の中核機能の一つで、企業の「顧客名刺ホルダー」のような存在です。企業は顧客一人ひとりに専用の身元プロフィールを作成でき、対話のたびにパーソナライズされたサービス体験を提供できます。

{% hint style="info" %}
**かんたんに言うと：**

連絡先は「顧客データカード」のようなもので、顧客の身元や権限を記録します。顧客が訪れた際、AI アシスタントはこのデータカードに基づいて、どのようなサービスやコンテンツを提供するかを判断します。
{% endhint %}

<figure><img src="/files/ObvlZXYIYzVs0F8NwWpE" alt=""><figcaption><p>身元識別の例</p></figcaption></figure>

たとえば、顧客が Web サイトのチャットウィンドウを通じてやり取りする際、システムは即座に「これは張さん、VIP 会員だ」あるいは「これは新規訪問者で、一部のファイルのみ開放されている」と識別し、それに応じたサービス内容と権限を提供できます。

## なぜ連絡先機能が必要なのか？ <a href="#why-contact-feature" id="why-contact-feature"></a>

### **パーソナライズされたサービス体験** <a href="#personalized-service" id="personalized-service"></a>

顧客はそれぞれ固有のニーズと背景を持っています。連絡先機能により、AI アシスタントは次のことが可能になります：

* その顧客との対話履歴を記憶する
* 顧客の身元に応じて適切な情報を提供する
* すでに把握している情報を繰り返し尋ねるのを避ける

### **正確な権限管理** <a href="#precise-permission-management" id="precise-permission-management"></a>

顧客ごとに表示すべきコンテンツは異なります：

* VIP 会員は専用の優待を閲覧できる
* 一般会員は標準的なサービス内容を閲覧できる
* 訪問者は公開情報のみ利用できる

### **データセキュリティの保護** <a href="#data-security" id="data-security"></a>

* 顧客が自分のデータのみにアクセスできるようにし、情報漏えいを防止します。

## 連絡先はどのように機能するのか？ <a href="#how-contact-works" id="how-contact-works"></a>

ユーザーが対話ウィンドウを開くと、対話リクエストは企業内部システムへ送られて処理され、会員情報がすでに引き渡されているかどうかを判断します。判断結果に応じて、連絡先（匿名または非匿名）を検索・作成します。どの経路をたどっても、最終的にはパーソナライズされた対話が展開され、すべてのユーザーが自分に適したパーソナライズ体験を得られるようになっています。

連絡先の動作イメージ図

<figure><img src="/files/D0aWUTafNFrNbnfZn6yw" alt=""><figcaption><p>連絡先の動作イメージ図</p></figcaption></figure>

## 連絡先タイプの説明 <a href="#contact-types" id="contact-types"></a>

MaiAgent の連絡先システムは、ユーザーの身元識別方法に応じて 2 つのタイプに分かれます：

{% hint style="info" %}
**かんたんに言うと：**

* **匿名連絡先** = ログインしていない訪問者で、システムはその人が誰かを把握できない
* **非匿名連絡先** = ログイン済みの会員で、システムはその身元やデータを把握している
  {% endhint %}

## 連絡先タイプ比較表 <a href="#contact-type-comparison" id="contact-type-comparison"></a>

<table><thead><tr><th width="104.83331298828125">項目</th><th>匿名連絡先</th><th>非匿名連絡先</th></tr></thead><tbody><tr><td><strong>適用シーン</strong></td><td>Web ページから直接アクセスした訪問者で、企業の会員システムにログインしていないため、対応するアカウントがなくユーザー情報を取得できない</td><td>ログイン済みの会員、または他のプラットフォームのアカウントでアクセスした場合（Facebook、LINE など）で、システムがユーザーの氏名やアカウント情報を取得できる</td></tr><tr><td><strong>身元識別</strong></td><td>具体的な個人情報を取得できない</td><td>明確な身元識別情報（氏名、プロフィール写真など）を持つ</td></tr><tr><td><strong>システム設定</strong></td><td>MaiAgent システム内で「匿名」として設定される</td><td>元の会員アカウント ID が Source ID に変換される</td></tr><tr><td><strong>権限管理</strong></td><td>ナレッジベースのファイル権限、対話プラットフォーム管理</td><td>両者とも同じ</td></tr><tr><td><strong>データの対応付け</strong></td><td>Source ID がなく、企業の会員データと対応付けできない</td><td>ソース ID を通じて、連絡先が毎回正しいユーザーに対応付けられる</td></tr><tr><td><strong>作成方法</strong></td><td>訪問者（会員身元を持たない）がアクセスした場合、対話ごとに新しい匿名連絡先が自動的に作成される</td><td>システムが会員ログイン情報に基づき、MaiAgent API を通じて自動的に作成または更新する<br>詳細な連携内容は次を参照してください：<a href="https://docs.maiagent.ai/tech/authorization-integration/contacts">技術者マニュアル—連絡先（Contact）の紹介および連携</a></td></tr><tr><td><strong>記録の仕組み</strong></td><td>システムはキャッシュに基づいてユーザーの対話履歴を記録する</td><td>Source ID と連絡先の対応付けを通じて対話の継続性を維持する</td></tr></tbody></table>

{% hint style="info" %}
**ソース ID（Source ID）の重要性**

**ソース ID** は、MaiAgent の連絡先と企業の会員システムを結びつける重要な橋渡し役です。ユーザーがさまざまな経路（Web サイト、アプリ、ソーシャルプラットフォーム）で企業とやり取りする際、システムはソース ID を通じてユーザーの身元を正しく識別でき、対話の継続性とパーソナライズ体験を確保します。

\*\*かんたんに言うと：\*\*ソース ID は「会員番号」のようなもので、システムが異なるプラットフォーム上でも同じ顧客を認識できるようにします。
{% endhint %}

## 連絡先の設定 <a href="#setup-contact" id="setup-contact"></a>

### 匿名ユーザー <a href="#anonymous-user" id="anonymous-user"></a>

ユーザーが新しい対話を作成すると、システムがバックエンドで自動的に新しい匿名ユーザーを作成します（対話ごとに 1 名の匿名ユーザーとなります）⬇️

<div><figure><img src="/files/Vb0emr367JuqaN9jvuyr" alt=""><figcaption></figcaption></figure> <figure><img src="/files/WlHCPgPIZJRz1Rkmz8A3" alt=""><figcaption></figcaption></figure></div>

連絡先 ID、対話プラットフォームの記録、作成日時などの情報が含まれます

編集をクリックして、匿名連絡先の情報を手動で編集できます：

<div><figure><img src="/files/BrwN7zhRVRuh5E7QGr2h" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ZJudv0qbSEyQwLQS1iiL" alt=""><figcaption></figcaption></figure></div>

**編集を通じて**、次のことができます：

* 連携する会員情報の変更：ソース ID を入力して、匿名連絡先を会員データに連携する
* 権限レベルの更新：より多くのファイル読み取り範囲を開放または制限する
* 顧客の氏名や連絡先などの基本データを補足する

### 非匿名ユーザー <a href="#non-anonymous-user" id="non-anonymous-user"></a>

ユーザーが他の対話プラットフォーム（LINE、FB Messenger、Telegram など）からアクセスした場合：

バックエンドは FB のユーザー情報に基づき、対応する非匿名ユーザーを自動的に作成します（ソース ID、連絡先の氏名、プロフィール写真などを含む）：

<div><figure><img src="/files/M57F0CKuDGUlCmsbzvoi" alt=""><figcaption></figcaption></figure> <figure><img src="/files/9KhuBFtoaQ2sVMSzDnVy" alt=""><figcaption></figcaption></figure></div>

引き続き編集ボタンをクリックして、非匿名連絡先の情報を編集できます

<figure><img src="/files/St8PtD6Dixv5S27CgDvh" alt=""><figcaption></figcaption></figure>

**編集を通じて、次のことができます：**

データの補完と修正

* 誤って設定されたクエリメタデータを修正する（権限に応じて開放範囲を更新する）
* 企業内のソース ID を修正し、正しい連絡先情報と会員情報を連携する

{% hint style="danger" %}
連絡先はソース ID に依存して対応付けを行うため、編集時にはソース ID が企業内部と同期していることを必ず確認してください。さもないと、その後のプログラム上で企業内部の情報と同期する際に、データの対応付けに誤りが生じるおそれがあります。
{% endhint %}

### 連絡先の追加 <a href="#add-contact" id="add-contact"></a>

連絡先の新規作成機能は、主に**デフォルト権限を持つ顧客プロフィールを能動的に作成する**ために使用します。Web Chat 内で権限範囲を指定していない場合でも、あらかじめ連絡先を作成しておくことで、顧客が実際に対話を開始する前に権限の設定とサービスの準備を完了できます。

{% hint style="info" %}
Web Chat の初期化で JavaScript スクリプトを使って権限範囲を指定したい場合は、次を参照してください：[技術者マニュアル：構築を始める—JSON 形式の使用](https://docs.maiagent.ai/tech/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/json-interfaces#webchat-chu-shi-hua-she-ding)
{% endhint %}

#### 中核機能の説明 <a href="#core-features" id="core-features"></a>

連絡先を手動で新規作成することで、システム管理者は特定の身元を持つユーザープロフィールをカスタマーサービスシステム内にあらかじめ作成し、それに対応する**クエリメタデータ権限**（Query Metadata）を設定できます。これらの事前作成された連絡先が後日**指定した対話プラットフォーム**を通じてカスタマーサービスのやり取りを行う際、システムは**ソース ID の自動照合メカニズム**を通じて、あらかじめ設定された権限レベルを即座に適用し、彼らがその身元に合ったデータコンテンツにアクセスできるようにします。

{% hint style="info" %}
**かんたんに言うと：**

「顧客の権限設定をあらかじめ準備しておく」ようなものです。この顧客が初めて訪れたとき、システムはすでにその顧客がどのデータを閲覧できるか、できないかを把握しています。
{% endhint %}

連絡先の追加をクリックして、編集ページに入り情報を追加できます：

<div><figure><img src="/files/Mm8l2NPe4qObtzRKeCWk" alt=""><figcaption></figcaption></figure> <figure><img src="/files/7YwJCFrVXGgXEFFQuFxH" alt=""><figcaption></figcaption></figure></div>

ページ内では、連絡先の氏名や指定する対話プラットフォームなどの情報を追加できます：

<figure><img src="/files/Hp6Nfk1o8UgGt8ZTWKi7" alt=""><figcaption></figcaption></figure>

## 権限管理 <a href="#permission-management" id="permission-management"></a>

企業のニーズに応じて、クエリメタデータを使用して連絡先ごとにファイルの利用範囲を制限できます。たとえば：

#### 会員ランクによる制限 <a href="#restrict-by-membership-level" id="restrict-by-membership-level"></a>

* **VIP 会員**：すべてのナレッジベース、上級 FAQ、製品技術ドキュメントを照会できる
* **一般会員**：基礎 FAQ、製品利用マニュアルのみ照会できる
* **訪問ユーザー**：公開 FAQ、基本的な製品紹介のみ照会できる

#### 部門権限による区分 <a href="#restrict-by-department-permission" id="restrict-by-department-permission"></a>

* **社内従業員**：社内操作マニュアル、システム保守ドキュメント、完全な製品データを照会できる
* **代理店**：製品仕様、価格表、販売データを照会できる
* **一般顧客**：利用説明、よくある質問、保証情報のみ照会できる

#### 製品タグによる分類 <a href="#restrict-by-product-tag" id="restrict-by-product-tag"></a>

* **エンタープライズ版ユーザー**：「エンタープライズ機能」「詳細設定」のタグが付いたドキュメントを照会できる
* **個人版ユーザー**：「基礎機能」「個人利用」のタグが付いたドキュメントのみ照会できる
* **トライアルユーザー**：「トライアル説明」「入門ガイド」のタグが付いたコンテンツのみ照会できる

{% hint style="info" %}
クエリメタデータについて詳しく知りたい場合は、次を参照してください：[ナレッジ管理権限：クエリメタデータ](/maiagent-user-guide/maiagent-user-guide-ja/org/querymetadata.md)
{% endhint %}

連絡先でクエリメタデータを設定する際、システムはあなたが指定した対話プラットフォームのナレッジベースに基づく設定のみを許可します。他の対話プラットフォームのナレッジベースに対して設定を行おうとすると、次の警告メッセージが表示されます：

<figure><img src="/files/GBgkxCV0WMlZRIYw2WCG" alt=""><figcaption></figcaption></figure>

## 自動化連携 <a href="#automation-integration" id="automation-integration"></a>

技術チーム向けに、MaiAgent は API インターフェースも提供しており、企業の既存システムとシームレスに連携できます

{% hint style="info" %}
詳細は次を参照してください：[技術者マニュアル—連絡先の紹介および連携](https://docs.maiagent.ai/tech/authorization-integration/contacts)
{% endhint %}

企業の規模を問わず、連絡先機能はより良い顧客サービス体験の提供を支援すると同時に、データセキュリティと運用効率を確保します。匿名・非匿名連絡先の分類管理、ソース ID による正確な対応付けメカニズム、そして柔軟な作成方法を通じて、企業はさまざまなタイプのユーザーに最適なサービス体験を提供でき、顧客とのやり取りの前から十分な準備を整えられます。


---

# 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/org/contact.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.