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

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

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

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

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

      オーストラリアリリースでは、YouTube 動画のみがサポートされています。

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

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

    プロパティ 説明
    ノード名 トピックフローでこのカードボット応答コントロールノードを識別する名前。
    カードタイプ 使用するカードのタイプ。次のいずれかのオプションを選択します。
    • レコード
    • テキスト付きの大きな画像
    • テキスト付きの小さな画像
    • YouTube ビデオカード
      注:
      オーストラリアリリースでは、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 サポート対象 なし
    Mobile UI サポート対象 なし
    Now Assist パネル 部分的サポート レコードカードとアクションのみのレコードカード。
    Microsoft Teams サポート対象 ビデオコントロールには、ビデオのサムネイル画像が表示されます。ユーザーがこの画像を選択すると、ユーザーが使用する Web ブラウザでビデオが開きます。
    Slack サポート対象 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 オブジェクトを作成し、単一の結果を返すクエリを使用してこのオブジェクトを設定した後、オブジェクトを返します。Table プロパティは、このクエリで使用されるテーブルを定義します。

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

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

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

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

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

    図 : 4. Web UI 画像カード出力
    ヘッダーに「すぐにオフィスに戻ることを忘れないでください!」と書かれたカード。これには、ユーザーのスケジュール復帰日と詳細情報への画像リンクが含まれます。
    図 : 5. Microsoft Teams UI 画像カード
    Microsoft Teams ヘッダータイトルの [風景] とプレースホルダー行の [風景の説明] が表示された画像カード。

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

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

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

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

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

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