集成預配置的服務專員 ServiceNow

發行項
12/09/2024

您可以將預配置的服務代理直接嵌入到 ServiceNow 底層平臺的上下文中桌面並瞭解底層平臺。此整合有助於應用程式提供更好的回應，並有助於進一步簡化代理的工作流程。

先決條件

在開始之前，您必須具有以下環境和控制台：

連接到 ServiceNow 環境的服務用 Copilot 執行個體。
ServiceNow 生產環境或試用環境。

此外，要使您的客戶服務代表能夠在其中 ServiceNow使用代理，您必須為他們分配專員角色。有關如何將此角色指派給代理程式的資訊，請參閱將安全角色指派給使用者。

登入您的服務用 Copilot 執行個體。
在網站地圖上，選擇頻道，然後選擇 ServiceNow。
複製在 iframe src= 之後 <開始的 URL。例如，https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com
將 URL 保存在本地，您可以在後續步驟中將其複製並粘貼。

第 2 步：安裝知識 API 外掛程式

在您的 ServiceNow 環境中，選擇全部，搜索外掛程式，然後選擇 系統定義>外掛程式。
搜尋知識 API。系統應返回 知識 API 外掛程式（應用 ID：sn_km_api）。
選擇知識 API 卡片。
選擇安裝，然後選擇最新版本。
選擇立即安裝，然後等待知識 API 安裝完成。

第 3 步：安裝 Openframe 外掛程式

在您的 ServiceNow 環境中，選擇全部，搜索外掛程式，然後選擇 系統定義>外掛程式。
搜尋 Openframe。系統應傳回 openframe 外掛程式 (外掛程式 id: com.sn_openframe)。
選取安裝開始進行外掛安裝。
選擇安裝，然後等待安裝完成。

第 4 步：安裝客戶服務外掛程式

在您的 ServiceNow 環境中，選擇全部，搜索外掛程式，然後選擇 系統定義>外掛程式。
搜尋 com.sn_customerservice。系統應返回 客戶服務（外掛程式 ID：com.sn_customerservice）。
選取安裝開始進行外掛安裝。
選擇安裝，然後等待安裝完成。

步驟 5：為工作區導航器添加 UI 腳本

在您的 ServiceNow 環境中，請確保您位於全域工作區中：選擇右上角的地球圖示，然後驗證應用程式範圍是否已設定為全域。
選擇全部，然後搜索UI 腳本，然後選擇系統 UI>UI 腳本。
選擇新建，然後按如下所示填寫表單：
- API 名稱：Copilot open 框 workspace script
- UI 類型：移動/服務門戶
- 文稿：複製以下文稿的內容：

 (function () {
  try {
    var logMoniker = "Copilot Navigator UI script: ";

    if (!globalThis.copilotNavigationWorkspaceListenerAdded) {
      console.log(logMoniker + "loading workspace navigator....");
      var payload = {
        url: globalThis.window.location.href,
        source: "workspaceUIScript",
        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: "workspaceUIScript",
          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);
  }

  function initialiseScript() {
    // do nothing
  }

  return initialiseScript;
})();

步驟 6：為經典 UI 導航器添加 UI 腳本

在您的 ServiceNow 環境中，請確保您位於全域工作區中：選擇右上角的地球圖示，然後驗證應用程式範圍是否已設定為全域。
選擇全部，然後搜索UI 腳本，然後選擇系統 UI>UI 腳本。
選擇新建，然後按如下所示填寫表單：
- API 名稱：Copilot open 框桌面腳本
- 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);
  }
})();

步驟 7：添加用於連結表的用戶端腳本

在您的 ServiceNow 環境中，請確保您位於全域工作區中：選擇右上角的地球圖示，然後驗證應用程式範圍是否已設定為全域。
選擇全部，然後搜尋用戶端指令碼，然後選擇系統定義>用戶端指令碼。
選擇新建，然後按如下所示填寫表單：
- 名稱：Copilot 打開框事件表腳本
- 表 Incident [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);
  }
}

再次選擇新建，然後按如下所示填寫表單：
- 名稱：Copilot 打開框電子郵件表腳本
- 表：電子郵件 [sys_email]
- 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);
  }
}

再次選擇新建，然後按如下所示填寫表單：
- 名稱：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);
  }
}

再次選擇新建，然後按如下所示填寫表單：
- 名稱：Copilot 打開框電子郵件表腳本
- 表：電子郵件 [sys_email]
- 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 環境中，選擇全部，搜尋 OpenFrame>Configurations。
在右上角選取+新增。
輸入 Microsoft Copilot 作為名稱和頭銜。
輸入 450 作為寬度，輸入 600 作為高度。
選擇您想要為其啟用服務用 Copilot的使用者群組。
選擇 URL 欄位旁邊的鎖定圖示以將其解鎖，然後貼上您先前從服務用 Copilot 管理頁面儲存的服務用 Copilot 小元件 URL。
選取送出。
重新整理頁面。服務用 Copilot 小工具應位於您選擇的圖示的頂部導覽列上。
在開啟服務用 Copilot 之前，請確保您允許 ServiceNow 頁面中的彈出視窗。

共用方式為

集成預配置的服務專員 ServiceNow

先決條件

步驟 1：複製服務用 Copilot 小組件 URL

第 2 步：安裝知識 API 外掛程式

第 3 步：安裝 Openframe 外掛程式

第 4 步：安裝客戶服務外掛程式

步驟 5：為工作區導航器添加 UI 腳本

步驟 6：為經典 UI 導航器添加 UI 腳本

步驟 7：添加用於連結表的用戶端腳本

步驟 8：在 ServiceNow 中設定介面控制項

意見反應

其他資源