ServiceNow で埋め込みエクスペリエンスを設定する

基になるプラットフォームのコンテキスト認識を使用して、Microsoft 365 Copilot エージェントに Service を ServiceNow デスクトップに直接埋め込むことができます。この統合は、アプリケーションがより良い応答を提供し、AI エージェントのワークフローをさらに合理化する際に役立ちます。

前提条件

開始する前に、以下の環境とコンソールが必要です:

ServiceNow 環境に接続Microsoft 365 Copilotインスタンス内のサービス。
ServiceNow の運用環境または試用環境。

さらに、顧客サービス担当者が ServiceNow でエージェントを使用できるようにするには、基本ユーザーとオムニチャネルエージェントのロールを割り当てる必要があります。複数のユーザーに対してCopilotを有効にする場合は、必要なロールをすべての目的のユーザーに割り当て、ServiceNow でウィジェットを構成するときにユーザーグループを含めます。詳細については、ユーザーへのセキュリティロールの割り当てを参照してください。

ServiceNow でエージェントを統合する

Navigation の手順を実行して、Copilot埋め込み可能なウィジェット URL<iframe src=> 以降をコピーします。たとえば、「 https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com 」のように入力します。このURLはServiceNowの「Configure widget」ステップで使います。
Knowledge API プラグインのインストール
1. ServiceNow 環境で、すべてを選択し、プラグインを検索して、システム定義>プラグインを選択します。
2. ナレッジ API を検索します。システムは ナレッジ API プラグイン (アプリ ID: sn_km_api) を返す必要があります。
3. ナレッジ API カードを選択します。
4. インストールを選択して、最新バージョンを選択します。
5. 今すぐインストールを選択してから、ナレッジ API のインストールが完了するのを待ちます。
Openframe プラグインのインストール
1. ServiceNow 環境で、すべてを選択し、プラグインを検索して、システム定義>プラグインを選択します。
2. Openframe を検索します。システムは openframe プラグイン (プラグイン ID: com.sn_openframe) を返す必要があります。
3. インストール を選択してプラグインのインストールを開始します。
4. インストールを選択し、インストールが完了するのを待ちます。
Customer Service プラグインをインストールする
1. ServiceNow 環境で、すべてを選択し、プラグインを検索して、システム定義>プラグインを選択します。
2. com.sn_customerservice を検索します。システムは 顧客サービスプラグイン (プラグイン ID: com.sn_customerservice) を返す必要があります。
3. インストール を選択してプラグインのインストールを開始します。
4. インストールを選択し、インストールが完了するのを待ちます。

クラシック UI ナビゲーターの UI スクリプトの追加

ご利用の ServiceNow 環境で、グローバル ワークスペースにいることを確認します: 右上隅にある地球儀のアイコンを選択し、アプリケーションの範囲が グローバル に設定されていることを確認します。
すべてを選択し、UI スクリプトを検索して、システムUI>UI スクリプトを選択します。

新規を選択して次のようにフォームに入力します:

API 名: Copilot オープンフレームデスクトップスクリプト
UI タイプ: デスクトップ
グローバル チェックボックスを選択します。

スクリプト: 以下のスクリプトの内容をコピーしてください:

(function () {
  try {
    var logMoniker = "Copilot Navigator UI script: ";
    if (
      !window.parent.navigationListenerAdded &&
      !window.copilotNavigationClassicListenerAdded
    ) {
      console.log(logMoniker + "loading desktop navigator....");
      var payload = {
        url: window.location.href,
        source: "classicUIScript",
        sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
        configType: "singleFrame"
      };
      var context = {
        payload: JSON.stringify(payload),
        method: "openframe_communication"
      };
      CustomEvent.fireAll("openframe_request", context);

      window.navigation.addEventListener("navigate", (event) => {
        console.log(
          logMoniker +
            "desktop PAGE NAVIGATED: " +
            "\n Old Url: " +
            window.location.href +
            "\n New url: " +
            event.destination.url
        );

        var payload = {
          url: event.destination.url,
          source: "classicUIScript",
          sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
          configType: "singleFrame"
        };
        var context = {
          payload: JSON.stringify(payload),
          method: "openframe_communication"
        };
        CustomEvent.fireAll("openframe_request", context);
      });

      window.copilotNavigationClassicListenerAdded = true;
    } else {
      console.log(logMoniker + "Skipping desktop navigator load....");
    }
  } catch (error) {
    console.log(logMoniker + "Classic UI navigator error");
    console.log(error);
  }
})();

ワークスペースナビゲーターのクライアントスクリプトを追加する

ご利用の ServiceNow 環境で、グローバル ワークスペースにいることを確認します: 地球儀アイコンを選択し、アプリケーションのスコープが グローバル に設定されていることを確認します。
すべてを選択し、クライアントスクリプトを検索して、システム定義>クライアントスクリプトを選択します。
新規を選択して次のようにフォームに入力します:

Name: Copilotオープンフレームワークスペースナビゲーションスクリプト
テーブル: グローバル [global]
UI タイプ: モバイル/サービスポータル
タイプ: onLoad

スクリプト: 以下のスクリプトの内容をコピーしてください:

function onLoad() {
    var table = g_form.getTableName();
    try {
        if (table == 'incident' || table == 'sys_email' || table == 'sn_customerservice_case' || table == 'interaction') {
            var logMoniker = "Copilot Navigator Workspaces Client script: ";

            if (!globalThis.copilotNavigationWorkspaceListenerAdded) {
                console.log(logMoniker + "loading workspace navigator....");
                var payload = {
                    url: globalThis.window.location.href,
                    source: "workspaceClientScript",
                    sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                    configType: "singleFrame"
                };
                var context = {
                    payload: JSON.stringify(payload),
                    method: "openframe_communication"
                };
                globalThis.CustomEvent.fireAll("openframe_request", context);

                globalThis.window.navigation.addEventListener("navigate", (event) => {
                    console.log(
                        logMoniker +
                        "Workspace PAGE NAVIGATED: " +
                        "\n Old Url: " +
                        globalThis.window.location.href +
                        "\n New url: " +
                        event.destination.url
                    );

                    var payload = {
                        url: event.destination.url,
                        source: "workspaceClientScript",
                        sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                        configType: "singleFrame"
                    };
                    var context = {
                        payload: JSON.stringify(payload),
                        method: "openframe_communication"
                    };
                    globalThis.CustomEvent.fireAll("openframe_request", context);
                });

                globalThis.copilotNavigationWorkspaceListenerAdded = true;
            } else {
                console.log(logMoniker + "Workspace navigator already loaded....");
            }
        }
    } catch (error) {
        console.error(logMoniker + "Workspace Navigator error");
        console.error(error);
    }
}

ご利用の ServiceNow 環境で、グローバル ワークスペースにいることを確認します: 右上隅にある地球儀のアイコンを選択し、アプリケーションの範囲が グローバル に設定されていることを確認します。

すべてを選択し、クライアントスクリプトを検索して、システム定義>クライアントスクリプトを選択します。
新規を選択して次のようにフォームに入力します:

Name: Copilotオープンフレームインシデントテーブルスクリプト
テーブル: インシデント [incident]
UI タイプ: デスクトップ
タイプ: onLoad

スクリプト: 以下のスクリプトの内容をコピーしてください:

  function onLoad() {
    try {
        var tableName = g_form.getTableName();
        var id = g_form.getUniqueValue();
        var payload = {
            recordId: id,
            objectType: tableName,
            source: "classicClientScript",
            sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
            configType: "singleFrame"
        };
        var context = {
            payload: JSON.stringify(payload),
            method: "openframe_communication"
        };
        CustomEvent.fireAll("openframe_request", context);
    } catch (error) {
        console.log(
            "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
        );
        console.log(error);
    }
}

d. 再び New を選択し、次に、次のようにフォームに入力します: - Name: Copilotオープンフレームメールテーブルスクリプト - Table: Email [sys_email] - UI type: Desktop - Type: onLoad

スクリプト: 以下のスクリプトの内容をコピーしてください:

  function onLoad() {
        try {
            var tableName = g_form.getTableName();
            var id = g_form.getUniqueValue();
            var payload = {
                recordId: id,
                objectType: tableName,
                source: "classicClientScript",
                sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                configType: "singleFrame"
            };
            var context = {
                payload: JSON.stringify(payload),
                method: "openframe_communication"
            };
            CustomEvent.fireAll("openframe_request", context);
        } catch (error) {
            console.log(
                "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
            );
            console.log(error);
        }
     }

e. 再度新規を選択して次のようにフォームに入力します:

Name: Copilotオープンフレームケース・テーブルスクリプト
テーブル: 事例 [sn_customerservice_case]
UI タイプ: デスクトップ
タイプ: onLoad

スクリプト: 以下のスクリプトの内容をコピーしてください:

function onLoad() {
    try {
        var tableName = g_form.getTableName();
        var id = g_form.getUniqueValue();
        var payload = {
            recordId: id,
            objectType: tableName,
            source: "classicClientScript",
            sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
            configType: "singleFrame"
        };
        var context = {
            payload: JSON.stringify(payload),
            method: "openframe_communication"
        };
        CustomEvent.fireAll("openframe_request", context);
    } catch (error) {
        console.log(
            "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
        );
        console.log(error);
    }
}

ServiceNow でウィジェットを構成する
1. ServiceNow 環境で、すべてを選択し、OpenFrame を検索して、Openframe>Configurationsを選択します。
2. 右上隅にある新規をクリックします。
3. 名前とタイトルに「Microsoft Copilot」と入力してください。
4. 幅に 450、高さに 600 と入力します。
5. Microsoft 365 Copilotでサービスを有効にする User Groups を選択します。
6. URL フィールドの横にあるロックアイコンを選択してロックを解除し、Service in Microsoft 365 Copilot 管理者ページで以前保存したウィジェット URL を貼り付けます。
7. 送信を選択します。
8. ページを最新の情報に更新します。 Microsoft 365 Copilotのサービスウィジェットは、選択したアイコンの上部のナビゲーションバーで使用できる必要があります。
9. Microsoft 365 Copilotでサービスを開く前に、ServiceNow ページからのポップアップが許可されていることを確認します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-10

次の方法で共有

ServiceNow で埋め込みエクスペリエンスを設定する

前提条件

ServiceNow でエージェントを統合する

フィードバック

その他のリソース