For the complete documentation index, see llms.txt. This page is also available as Markdown.

連絡先

連絡先とは?

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

かんたんに言うと:

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

身元識別の例

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

なぜ連絡先機能が必要なのか?

パーソナライズされたサービス体験

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

  • その顧客との対話履歴を記憶する

  • 顧客の身元に応じて適切な情報を提供する

  • すでに把握している情報を繰り返し尋ねるのを避ける

正確な権限管理

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

  • VIP 会員は専用の優待を閲覧できる

  • 一般会員は標準的なサービス内容を閲覧できる

  • 訪問者は公開情報のみ利用できる

データセキュリティの保護

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

連絡先はどのように機能するのか?

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

連絡先の動作イメージ図

連絡先の動作イメージ図

連絡先タイプの説明

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

かんたんに言うと:

  • 匿名連絡先 = ログインしていない訪問者で、システムはその人が誰かを把握できない

  • 非匿名連絡先 = ログイン済みの会員で、システムはその身元やデータを把握している

連絡先タイプ比較表

項目
匿名連絡先
非匿名連絡先

適用シーン

Web ページから直接アクセスした訪問者で、企業の会員システムにログインしていないため、対応するアカウントがなくユーザー情報を取得できない

ログイン済みの会員、または他のプラットフォームのアカウントでアクセスした場合(Facebook、LINE など)で、システムがユーザーの氏名やアカウント情報を取得できる

身元識別

具体的な個人情報を取得できない

明確な身元識別情報(氏名、プロフィール写真など)を持つ

システム設定

MaiAgent システム内で「匿名」として設定される

元の会員アカウント ID が Source ID に変換される

権限管理

ナレッジベースのファイル権限、対話プラットフォーム管理

両者とも同じ

データの対応付け

Source ID がなく、企業の会員データと対応付けできない

ソース ID を通じて、連絡先が毎回正しいユーザーに対応付けられる

作成方法

訪問者(会員身元を持たない)がアクセスした場合、対話ごとに新しい匿名連絡先が自動的に作成される

システムが会員ログイン情報に基づき、MaiAgent API を通じて自動的に作成または更新する 詳細な連携内容は次を参照してください:技術者マニュアル—連絡先(Contact)の紹介および連携

記録の仕組み

システムはキャッシュに基づいてユーザーの対話履歴を記録する

Source ID と連絡先の対応付けを通じて対話の継続性を維持する

ソース ID(Source ID)の重要性

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

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

連絡先の設定

匿名ユーザー

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

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

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

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

  • 連携する会員情報の変更:ソース ID を入力して、匿名連絡先を会員データに連携する

  • 権限レベルの更新:より多くのファイル読み取り範囲を開放または制限する

  • 顧客の氏名や連絡先などの基本データを補足する

非匿名ユーザー

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

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

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

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

データの補完と修正

  • 誤って設定されたクエリメタデータを修正する(権限に応じて開放範囲を更新する)

  • 企業内のソース ID を修正し、正しい連絡先情報と会員情報を連携する

連絡先の追加

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

Web Chat の初期化で JavaScript スクリプトを使って権限範囲を指定したい場合は、次を参照してください:技術者マニュアル:構築を始める—JSON 形式の使用

中核機能の説明

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

かんたんに言うと:

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

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

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

権限管理

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

会員ランクによる制限

  • VIP 会員:すべてのナレッジベース、上級 FAQ、製品技術ドキュメントを照会できる

  • 一般会員:基礎 FAQ、製品利用マニュアルのみ照会できる

  • 訪問ユーザー:公開 FAQ、基本的な製品紹介のみ照会できる

部門権限による区分

  • 社内従業員:社内操作マニュアル、システム保守ドキュメント、完全な製品データを照会できる

  • 代理店:製品仕様、価格表、販売データを照会できる

  • 一般顧客:利用説明、よくある質問、保証情報のみ照会できる

製品タグによる分類

  • エンタープライズ版ユーザー:「エンタープライズ機能」「詳細設定」のタグが付いたドキュメントを照会できる

  • 個人版ユーザー:「基礎機能」「個人利用」のタグが付いたドキュメントのみ照会できる

  • トライアルユーザー:「トライアル説明」「入門ガイド」のタグが付いたコンテンツのみ照会できる

クエリメタデータについて詳しく知りたい場合は、次を参照してください:ナレッジ管理権限:クエリメタデータ

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

自動化連携

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

詳細は次を参照してください:技術者マニュアル—連絡先の紹介および連携

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

最終更新

役に立ちましたか?