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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

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

    始める前に

    エージェント発信用メッセージングインターフェイス アプリケーションをインストールします。詳しくは、 エージェントが開始したメッセージング・インターフェースのインストールを参照してください。

    必要なロール：admin

    このタスクについて

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

    拡張ポイントを使用すると、ベースコードを変更することなくカスタマイズを簡単に統合することができます。カスタマイズされたスクリプトを使用して、標準的な基本機能を拡張することができます。詳細については、「拡張ポイントを使用してアプリケーション機能を拡張する」を参照してください。

    手順

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