---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# ユーザープロファイルをエージェントが開始したメッセージに関連付ける

# ユーザープロファイルをエージェントが開始したメッセージに関連付ける {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

スクリプト化された拡張ポイントを使用して、ユーザープロファイルをエージェントが開始したメッセージに関連付けるカスタムスクリプトを呼び出します。

## 始める前に

エージェント発信用メッセージングインターフェイスアプリケーションをインストールします。詳細については、「[エージェントが開始したメッセージングインターフェイスのインストール](https://servicenow-prod.fluidtopics.net/A5br8wO2n5Q7lKIpm1R6VQ "admin ロールを持っている場合は、エージェント発信用メッセージングインターフェイス アプリケーション (sn_agent_initiated) をインストールできます。このアプリケーションは、関連する ServiceNow Store アプリケーションとプラグインをインストールします (まだインストールされていない場合)。")」を参照してください。

必要なロール：アドミン

## このタスクについて

エージェントは、CSM 構成可能ワークスペース 内のメッセージ以外のタイプのインタラクションからメッセージを作成できます。デフォルトでは、AgentMessagingInteractionUserDocument スクリプトインクルードは、インタラクションレコードでコンシューマーと顧客の連絡先に関連付けられたユーザープロファイルを取得するために使用できます。

拡張ポイントを使用すると、ベースコードを変更することなくカスタマイズを簡単に統合することができます。カスタマイズされたスクリプトを使用して、標準的な基本機能を拡張することができます。詳細については、「[拡張ポイントを使用してアプリケーション機能を拡張する](https://www.servicenow.com/docs/access?context=extension-points&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」を参照してください。

## 手順

1. 移動先 すべてシステム拡張ポイントスクリプト化済みの拡張点.
2. \[API 名\] 列で、\[sn_agent_initiated.AgentInitiatedMessagingUserDocument\] を検索して選択します。
3. \[拡張ポイント\] フォームで、スクリプトインクルードを変更して sn_agent_initiated.AgentInitiatedMessagingUserDocument 拡張ポイントを使用するか、カスタムスクリプトインクルードを作成して登録します。
   * カスタムスクリプトインクルードを作成および登録します。
   * 既存のスクリプトインクルードを変更するには、\[実装\] 関連リストに移動し、\[クラス\] 列のスクリプトインクルードを選択します。  
     注:  
     デフォルトで、sn_agent_initiated.AgentInitiatedMessagingUserDocument 拡張ポイントを使用する AgentMessagingInteractionUserDocument スクリプトインクルードは エージェント発信用メッセージングインターフェイス アプリケーションで使用できます。このスクリプトインクルードは、インタラクション \[interaction\] テーブルレコードからコンシューマーと顧客の連絡先に関連付けられたユーザープロファイルを取得するように構成されています。
   {#agent-init-messg-user-record-ext-pt__choices_mxh_ght_plb}
4. sn_agent_initiated.AgentInitiatedMessagingUserDocument 拡張ポイントをスクリプトインクルードに追加して、エージェントが開始したメッセージのユーザープロファイルを関連付けます。  
   拡張ポイントに対して複数の実装を作成し、各実装に順序番号を指定できます。順序番号が最も小さい実装が最初に実行されます。{#agent-init-messg-user-record-ext-pt__table_czh_m5m_5nb__entry__2}

   | カスタマイズ | 実装 |
   |-|-|
   | メッセージが開始されたテーブルレコードを関連付ける | isValidForTableRecord メソッドを sn_agent_initiated.AgentInitiatedMessagingUserDocument 拡張ポイントに含めます。 |
   | メッセージが開始されたテーブルレコードに関連付けられているユーザー詳細を取得する | getUserDocument メソッドを sn_agent_initiated.AgentInitiatedMessagingUserDocument 拡張ポイントに含めます。 |
   [ ]

   {#agent-init-messg-user-record-ext-pt__table_czh_m5m_5nb}  
   注:  
   isValidForTableRecord メソッドで設定されたテーブルレコードに基づいて、getUserDocument メソッドでエージェントが開始したメッセージを送信するためのユーザーの詳細が取得されます。
5. \[拡張ポイント\] フォームで、\[更新\] をクリックします。