カードボット応答コントロール

  • リリースバージョン: Xanadu
  • 更新日 2024年07月29日
  • 所要時間:8分
  • 仮想エージェントトピックでカードボット応答コントロールを使用して、インスタンス上のレコードから選択した情報と、動画や画像などのリッチコンテンツをアップロードして表示します。

    カードには、レコード情報、画像、または YouTube ビデオコンテンツをコンパクト形式で含めることができます。コンパクト形式は、チャットウィンドウ内で読みやすいように設計されています。

    カードボット応答には、次のタイプのコンテンツを表示できます。

    • レコード:インスタンスの単一レコードのコンテンツを表示します。このレコードは、フロー内の変数から参照することも、選択したテーブルから単一の Glide レコードを返すスクリプトを使用して照会することもできます。レコードコンテンツには、カードの上部にテーブルの表示フィールドが含まれ、ボット応答のプロパティによって指定されたその他のフィールドが続きます。
    • 画像:入力した大小の画像と、タイトルおよび説明が表示されます。プロパティシートには、カードレイアウト用に事前設定されたテンプレートが用意されています。タイトル、説明、およびイメージソースを指定します。
    • YouTube ビデオ:チャネルでサポートされている場合は、インラインビデオプレーヤーで表示されます。画像は、タイトル、説明、および関連するコンテンツへのハイパーリンクとともに表示されます。

      Xanadu リリースでは、YouTube ビデオのみがサポートされています。

      ヒント:
      ビデオボット応答コントロールを使用して、会話に YouTube ビデオを含めることもできます。ビデオボット応答コントロールには、会話を一時停止するナビゲーションボタンが含まれています。会話を続行する前にユーザーにビデオを視聴してもらいたい場合は、このナビゲーションボタンを使用します。ユーザーがビデオの視聴を終了したら、このナビゲーションボタンをクリックして会話を続行できます。
    注:
    HTML ボット応答コントロールを使用してカードレイアウトを生成する会話を以前に作成している場合は、カードボット応答コントロールを使用するように会話を更新することを検討してください。カードには、インスタンス内のレコードの情報が表示され、その関連レコードへのリンクが含まれています。または、画像を表示し、ビデオなどのリッチコンテンツを含めることができます。

    カードボット応答コントロールのプロパティ

    プロパティ 説明
    ノード名 トピックフローでカードボット応答コントロールノードを識別する名前。
    カードタイプ 使用するカードのタイプ。次のいずれかのオプションを選択します。
    • レコード
    • テキスト付きの大きな画像
    • テキスト付きの小さな画像
    • YouTube ビデオカード
      注:
      Xanadu リリースでは、YouTube ビデオカードのみがサポートされています。
    タイプ:レコード
    レコード 特定のレコードへの参照です。カードのデータは、フロー内の別のノードの変数で参照されるレコードから取得されます。たとえば、選択リストや Glide アクションを参照に使用できます。
    1. レコードオブジェクトを含む現在のフローから変数を選択します。
    2. フィールドリストを使用して、カードに表示されるフィールドを決定します。
    テーブル カードに表示されているデータを含む単一の Glide レコードを参照するテーブル。
    このテーブルのフィルター手段 テーブルのデータをフィルタリングする条件またはスクリプトを入力し、レコードを返します。
    • 条件:テーブルレコードを返す条件ステートメント。
    • スクリプト:Glide レコードを返す Glide レコードクエリ。
    フィールド

    カードに表示される ServiceNow レコードのフィールドです。[フィールドの追加] をクリックして各フィールドを指定します。

    注:
    Workplace を使用している場合、最大 4 つのフィールドがカードに表示されます。4 つ以上のフィールドがある場合、残りのフィールドは後続のカード (カードあたり最大 4 つのフィールド) に表示されます。
    タイプ:テキスト付きの大きな画像またはテキスト付きの小さな画像
    テンプレート 画像カードのレイアウトを視覚的に表現したものです。テンプレートの各領域には番号が付けられています。
    カード上のフィールドにデータをマップ テンプレートに表示される番号に対応するフィールド。これらフィールドは次のとおりです。
    1. タイトル:カードの名前またはラベル
    2. 説明:画像の説明
    3. 画像 URL のリンク:次のいずれかの方法でカードに表示される画像を指定します。
      • テキストフィールド、データピル、またはスクリプトを使用して、画像の URL を指定します。
      • [画像をアップロード] をクリックして画像をアップロードします。

      画像をアップロードすると、選択した画像がサーバーにアップロードされ、イメージ [sys_db_image] テーブルと更新セットに保存されます。画像がイメージテーブルと更新セットに保存されている場合は、本番インスタンスまたは非本番インスタンスで必要に応じて画像を使用できます。

      画像がアップロードされると、次のように URL リンクが [応答プロパティ] シート内に表示されます。

      プロパティシートに表示されたアップロード済み画像へのリンク。

      リンクをクリックして画像を表示します。

      URL は動的に生成されます。インスタンスの名前は、URL パスの先頭に挿入されます。

      画像へのリンクを変更または削除できます。このプロパティシートのリンクを削除すると、URL への参照のみが削除されます。画像は将来使用するためにサーバー上に残ります。

    4. 画像の代替テキストアクセシビリティプログラム用に画像を説明する、画面で読み取り可能な代替テキスト。このテキストは画像とともに使用されます。テキストフィールド、データピル、またはスクリプトを使用してテキストを入力します。
    タイプ:YouTube ビデオカード
    テンプレート カードに含まれるビデオのレイアウトを視覚的に表現したものです。
    カード上のフィールドにデータをマップ テンプレートに表示される番号に対応するフィールド。これらフィールドは次のとおりです。
    • タイトル:カードのタイトル。
    • タイトルリンク:関連するコンテンツの URL。
    • 説明:ビデオが処理するトピックなどのカードの説明。
    • YouTube ビデオ ID:カードで使用されるビデオの一意の識別子。この識別子は、ビデオの URL パスの末尾にある等号 (=) に続く文字列です。

      たとえば、以下に示すパスでは、ビデオ識別子は FVgtjdEOa5M です。

      URL www.youtube.com/watch?v=FVgtjdEOa5M では、ビデオ識別子は FVgtjdEOa5M です。

      この URL では、ビデオ識別子は中括弧で囲まれたビデオ ID です。

    詳細
    このノードを非表示
    次の場合、このノードを条件付きで表示します

    会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。

    チャネルサポート

    表 : 1. カードボット応答コントロールのチャネルサポート
    チャネル サポート 制約
    Web UI サポート対象 なし
    モバイル UI サポート対象 なし
    Now Assist パネル 部分的サポート レコードカードとアクションのみのレコードカード。
    Microsoft Teams サポート対象 ビデオコントロールには、ビデオのサムネイル画像が表示されます。ユーザーがこの画像を選択すると、ユーザーが使用する Web ブラウザでビデオが開きます。
    Slack サポート対象 Conversational Integration with Slack バージョン 2.0.0 以降。

    ビデオコントロールには、ビデオのサムネイル画像が表示されます。ユーザーがこの画像を選択すると、ユーザーが使用する Web ブラウザでビデオが開きます。

    Workplace 部分的サポート 画像カード出力は利用できません。

    Facebook アプリは垂直リストテンプレートをサポートしなくなりました。カードレイアウトでは、2019 年 8 月 15 日から水平スクロール可能なカルーセルテンプレートが使用されています。カードではボタンテンプレートも使用できます。

    Facebook Messenger サポート対象 なし
    SMS Twilio サポート対象 レコードと画像カードのみ。
    LINE 部分的サポート レコードと画像カードのみ。
    WhatsApp 部分的サポート レコードと画像カードのみ。
    Apple Messages for Business サポート対象 なし
    Alexa (音声アシスト機能) 部分的サポート 一部のタイプの出力は、画面付きのデバイスでのみ使用できます。画面表示されていないデバイスの場合 、カードタイトルが読み込まれます。詳細については、「最適な Alexa 音声チャットエクスペリエンスのための 仮想エージェント 設定とトピックの微調整」を参照してください。

    Glide レコード クエリの例

    (function execute(table) {
        /* Write a glide record query, and return the glide record.
           For example:
           
           var now_GR = new GlideRecord(table);
           gr.addEncodedQuery('active=true^number=INC0010099');
           gr.query();
           if(gr.next()) {
              return gr;
        }
        */
    })(table)
    

    この例では、スクリプトは GlideRecord オブジェクトを作成し、単一の結果を返すクエリを使用してこのオブジェクトを設定した後、レコードを返します。テーブル プロパティは、このクエリで使用されるテーブルを定義します。

    レコードのカードボット応答出力の例

    注:
    仮想エージェントデザイナーコントロールは、他のチャネルでは表示や機能が異なる場合があります。
    応答プロパティ カード出力
    図 : 1. カードボット応答コントロールの基本プロパティ
    基本プロパティには、ノード名、カードタイプ、カードの入力方法 (レコードまたはテーブル)、返されるフィールドが含まれます。
    図 : 2. Web UI カード出力
    ヘッダーにインシデントとインシデント番号が表示されているカードの例。表示されるフィールドは、[カテゴリ]、[簡単な説明]、および [ステータス] です。
    図 : 3. Microsoft Teams カード出力
    ヘッダーに会話と作成時間が表示されている、 Microsoft Teams 会話のカードの例。表示されるフィールドには、[コンシューマー]、[SysID]、[デバイスタイプ]、および [作成日時] が含まれます。

    大きな画像のカードボット応答の例

    画像のカード応答レイアウトは、チャネルによって異なる場合があります。
    応答プロパティ カード出力

    基本プロパティには、ノード名、カードタイプ、カードテンプレート、タイトル、説明、画像リンク、および画像の代替テキストが含まれます。

    図 : 4. Web UI 画像カード出力
    ヘッダーに「すぐにオフィスに戻ることを忘れないでください (Don't forget we are going back to the office soon!)」と書かれたカード。これには、ユーザーのスケジュール復帰日と詳細情報への画像リンクが含まれます。
    図 : 5. Microsoft Teams UI 画像カード
    Microsoft Teams 画像の上のヘッダータイトル「Scenery」とプレースホルダー行「Scenery Description」を表示する画像カード。

    小さな画像のカードボット応答の例

    画像のカード応答レイアウトは、チャネルによって異なる場合があります。

    応答プロパティ カード出力
    基本プロパティには、ノード名、カードタイプ、テンプレート、タイトル、説明、画像リンク、および画像の代替テキストが含まれます。
    図 : 6. Web UI 画像カード出力
    ユーザーは「いつ収益を発表しますか?」と尋ねます。「日付を保存 - Q1 収益コール (Save the date - Q1 Earnings Call)」というヘッダーが付いたカードが返されます。

    ビデオコンテンツを含むカードボット応答の例

    カードボット応答でのビデオの表示方法は、チャネルによって異なる場合があります。たとえば、Slack メッセージでの表示は、Microsoft Teams または Workplace from Facebook での表示とは異なる場合があります。また、埋め込みプレーヤーがそのチャネルでサポートされている場合は、そのプレーヤーが表示に含まれます。チャネルの詳細については、使用しているチャネルのドキュメントを参照してください。

    応答プロパティ カード出力
    基本プロパティには、ノード名、カードタイプ、テンプレート、タイトル、タイトルリンク、説明、および YouTube 動画 ID が含まれます。
    図 : 7. Web クライアントのビデオ付きカードボット応答出力
    「新しいクリスマスキャンペーンをチェック」と書かれたカード。YouTube 動画が下に埋め込まれ、リンクされたタイトルと説明が表示されます。
    図 : 8. ビデオがオンになったカードボット応答出力 Microsoft Teams
    ビデオカード Microsoft Teams 、ヘッダータイトル、ビデオの例、プレースホルダー行、ビデオの例の説明が表示されている例 (プレビュー画像の上)。