仮想エージェント通知コンテンツの定義

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：6分

    • チャットまたはメッセージングチャネルで配信される仮想エージェント通知のコンテンツを作成します。

    始める前に

    • 画像カードのイメージは、幅が 400 ピクセル以上で、.jpg、.png、.bmp、.gif、.ico、または .svg の形式である必要があります。
    • 以前のリリースからアップグレードしており、レコードカードに表示されるデータとチャット通知のパラメーター置換について ACL を監視する必要がある場合は、com.glide.cs.notification_record_access_check システムプロパティを true に設定します。このシステムプロパティのデフォルト値は false です。これは、ユーザーのアクセスレベルに関係なくデータが配信されることを意味します。
      注:
      このプロパティは、詳細通知には適用されません。
    • 必要なロール：virtual_agent_admin または admin

    このタスクについて

    パラメーター置換を使用してメッセージヘッダーとメッセージに動的コンテンツを追加することで、仮想エージェント通知をカスタマイズできます。通知に動的コンテンツを追加するときは、コンテンツに含めるレコード値を識別する変数を指定します。次のタイプの通知に動的コンテンツを追加できます。
    • レコードベースの通知 - コンテンツで ${<variable_name>} 形式を使用して、通知に使用されるテーブルのレコード値を表す変数を指定します。たとえば、インシデントテーブルを使用する通知のメッセージ見出しをカスタマイズし、メッセージにインシデントの優先度を含める場合は、[変数を選択] 列を使用してインシデント優先度の変数を選択します。
    • イベントベースの通知 - ${event.parm1} および ${event.parm2} 形式を使用して、通知コンテンツのレコード情報を渡すイベント固有のパラメーターを指定します。イベントパラメーターとその仕組みの詳細については、「イベント」を参照してください。
    • 詳細通知：詳細通知のユースケース用に提供されているスクリプトを変更して、さまざまなデータソースからの動的コンテンツを指定し、コンテンツ内のリンクを簡素化するための URL 短縮などのサードパーティーサービスを識別します。

    手順

    1. 移動先 すべて > システム通知 > プロバイダー > 通知 をクリックし、コンテンツを定義または更新する通知を選択します。
    2. 次のいずれかの操作を行います。
      • 新しいコンテンツを定義する場合は、[通知コンテンツ] 関連リストに移動して [新しいプロバイダーコンテンツ] を選択し、ステップ 3 に進みます。
      • コンテンツを更新する場合は、[通知コンテンツ] 関連リストに移動して更新するコンテンツを選択し、ステップ 4 に進みます。
    3. 仮想エージェントコンテンツタイプを選択します。
      • 仮想エージェントコンテンツ - チャット：通知はチャットチャネル用です。
      • 仮想エージェントコンテンツ - メッセージング：通知は、SMS などのメッセージングチャネル用です。
      図 : 1. 通知コンテンツ
      ユーザーが選択して作成できる通知コンテンツタイプを表示する [通知コンテンツ] ページ。使用可能なオプションは、[チャットチャネル]、[メッセージングチャネル]、および [ワークスペース] です。
    4. 通知コンテンツを提供または更新します。
      1. フォームで、チャットまたはメッセージング通知のフィールドに入力します。
        表 : 1. 通知コンテンツ - 仮想エージェントチャットまたは仮想エージェントメッセージング
        フィールド 説明
        名前 通知コンテンツの名前。
        通知 そのコンテンツに関連付けられている通知。このフィールドには、作成した通知が自動的に入力されます。
        タイプ 通知のレイアウト：
        • シンプル：レビュー用の情報を含むメッセージのみの通知。
        • レコードカード：テーブル内の特定のレコードに関する情報を含む通知。
        • 画像カード：画像を含む通知。
        テーブル (レコードカードの場合) 通知を受信するテーブル。このフィールドには、通知で定義したテーブルが自動的に入力されます。
        フィールド (レコードカードの場合) 通知に表示されるフィールド。たとえば、[コメントと作業メモ] を選択すると、通知にはユーザーがレコードに追加したコメントと作業メモが含まれます。
        アプリケーション 通知コンテンツのアプリケーションスコープ。
        アクティブ 通知コンテンツをアクティブ化するオプション。
        リンクの有効化 (レコードカードの場合) レコードへのリンクを追加するオプション。
        詳細 複数のデータソースからプルされた通知見出しとメッセージコンテンツの動的コンテンツを返すスクリプトを入力するためのスクリプトエディターを開くオプション。
        スクリプト

        (詳細通知コンテンツの場合) メッセージ見出しやメッセージコンテンツで使用する、サードパーティーサービス (URL 短縮など) を含む、さまざまなデータソースからの動的コンテンツを指定するために編集できるスクリプト。
        メッセージの見出し メッセージの上部に表示されるテキスト。デフォルトのメッセージ見出し：通知を受信しました。通知を表示した後に会話を続行することができます。
        動的コンテンツを使用してカスタム見出しを作成する場合は、見出しテキストを入力し、テキストで使用する変数を指定します。
        • レコードベースの通知の場合：[変数を選択] 列を展開し、見出しに含めるレコード値の変数を選択します。変数は、通知に使用されるテーブルのレコードにマップされます。例：インシデントが優先度 ${priority} であなたにアサインされました
        • イベントベースの通知の場合：${event.parm1} および ${event.parm2} 変数を指定して、通知コンテンツのレコード情報を渡すイベント固有のパラメーターを識別します。
        メッセージ リッチテキスト形式によるメッセージのコンテンツ。
        動的コンテンツを使用してカスタムメッセージを作成する場合は、メッセージテキストを入力し、テキストで使用する変数を指定します。
        • レコードベースの通知の場合：[変数を選択] 列を展開し、メッセージに含めるレコード値の変数を選択します。変数は、通知に使用されるテーブルのレコードにマップされます。例：アサインされたインシデントの簡単な説明は ${short_description} です
        • イベントベースの通知の場合：${event.parm1} および ${event.parm2} 変数を指定して、通知コンテンツのレコード情報を渡すイベント固有のパラメーターを識別します。

        リッチテキスト形式で定義された通知メッセージは、太字、斜体、リンク (url)、および順序付けされていないリストで表示されます。通知メッセージには、斜体のテキストと箇条書きが含まれています。また、詳細を参照できるナレッジ記事へのハイパーリンクも含まれています。

        ユーザーがメッセージ内の URL をクリックすると、ポータル設定に従って宛先にリダイレクトされます。
        イメージソース (画像カードの場合) 通知に表示する画像を選択するためのオプションは次のとおりです。
        • 画像をアップロード：アップロードして画像を追加します。
        • URL：画像の URL を指定します。
        画像 (画像カードの場合) カードに表示される画像。
        • 画像を追加するには、[クリックして追加] を選択します。ファイルファインダーから、使用する画像ファイルを選択して [OK] を選択します。
        • 画像を変更するには、[更新] を選択します。ファイルファインダーから、新しい画像ファイルを選択して [OK] を選択します。
        • 画像を削除するには、[削除] を選択します。ファイルがすぐに削除されます。
        画像の代替テキスト (画像カードの場合) カードに表示される画像の代替テキスト。
        注:
        メッセージング通知の詳細を作成または更新するには、[配信チャネル (Delivery Channel)] 関連リストに移動し、フォームに必要事項を入力します。詳細については、「仮想エージェント通知の配信チャネルの設定」を参照してください。
      2. [送信] または [更新] を選択します。

    次のタスク