Integrujte předkonfigurovanou službu agent in ServiceNow
Předkonfigurované servisní agenty můžete vložit přímo do ServiceNow desktopu s kontextovým povědomím o základní platformě. Tato integrace pomáhá aplikaci poskytovat lepší reakce a pomáhá dále zefektivnit pracovní postup pro vaše agenty.
Předpoklady
Než začnete, musíte mít následující prostředí a konzoli:
- Instance Copilot pro Service připojená k prostředí ServiceNow.
- Produkční nebo zkušební prostředí ServiceNow.
Navíc, aby vaši zástupci služby zákazníkům mohli používat agenty v ServiceNow, musíte jim přiřadit roli agent. Informace, jak přidělit tuto roli agentům, najdete v části Přiřazení role zabezpečení uživateli.
Krok 1: Zkopírujte adresu URL widgetu Copilot pro Service
- Přihlaste se do své instance Copilot pro Service.
- Na mapě webu vyberte Kanály a poté vyberte ServiceNow.
- Zkopírujte adresu URL od <iframe src=. Například https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com
- Uložte adresu URL lokálně, kde ji můžete zkopírovat a vložit v pozdějším kroku.
Krok 2: Nainstalujte plugin Knowledge API
- Ve svém prostředí ServiceNow vyberte Vše, vyhledejte pluginy a poté vyberte Definice systému>Pluginy.
- Vyhledejte Knowledge API. Systém by měl vrátit knowledge api plugin (ID aplikace: sn_km_api).
- Vyberte kartu Knowledge API.
- Vyberte Nainstalovat a poté vyberte nejnovější verzi.
- Vyberte Nainstalovat nyní a poté počkejte na dokončení instalace Knowledge API.
Krok 3: Nainstalujte plugin Openframe
- Ve svém prostředí ServiceNow vyberte Vše, vyhledejte pluginy a poté vyberte Definice systému>Pluginy.
- Vyhledejte Openframe. Systém by se měl vrátit openframe plugin (ID pluginu: com.sn_openframe).
- Vyberte Nainstalovat ke spuštění instalace pluginu.
- Vyberte Nainstalovat a poté počkejte na dokončení instalace.
Krok 4: Nainstalujte plugin Customer Service
- Ve svém prostředí ServiceNow vyberte Vše, vyhledejte pluginy a poté vyberte Definice systému>Pluginy.
- Vyhledejte com.sn_customerservice. Systém by se měl vrátit Customer Service (ID pluginu: com.sn_customerservice).
- Vyberte Nainstalovat ke spuštění instalace pluginu.
- Vyberte Nainstalovat a poté počkejte na dokončení instalace.
Krok 5: Přidejte skript uživatelského rozhraní pro navigátor pracovního prostoru
- Ve vašem prostředí ServiceNow se ujistěte se, že jste v globální pracovní ploše: Vyberte ikonu zeměkoule v pravém horním rohu a ověřte, že Rozsah aplikace je nastaven na Globální.
- Vybrat Všechno a poté vyhledejte Skripty uživatelského rozhraní a poté vyberte Uživatelské rozhraní systému>Skripty uživatelského rozhraní.
- Vyberte Nový a poté vyplňte formulář takto:
- Název API: Copilot skript pracovního prostoru otevřeného rámce
- Typ uživatelského rozhraní: Mobilní/servisní portál
- Skript: Zkopírujte obsah následujícího skriptu:
(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;
})();
Krok 6: Přidejte skript uživatelského rozhraní pro klasického uživatelského rozhraní
- Ve vašem prostředí ServiceNow se ujistěte se, že jste v globální pracovní ploše: Vyberte ikonu zeměkoule v pravém horním rohu a ověřte, že Rozsah aplikace je nastaven na Globální.
- Vybrat Všechno a poté vyhledejte Skripty uživatelského rozhraní a poté vyberte Uživatelské rozhraní systému>Skripty uživatelského rozhraní.
- Vyberte Nový a poté vyplňte formulář takto:
- Název rozhraní API: Copilot desktopový skript pro otevřený rámec
- Typ uživatelského rozhraní: Desktop
- Zaškrtněte políčko Globální.
- Skript: Zkopírujte obsah následujícího skriptu:
(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);
}
})();
Krok 7: Přidejte klientské skripty pro propojení tabulek
- Ve vašem prostředí ServiceNow se ujistěte se, že jste v globální pracovní ploše: Vyberte ikonu zeměkoule v pravém horním rohu a ověřte, že Rozsah aplikace je nastaven na Globální.
- Vybrat Všechno a poté vyhledejte Klientské skripty a poté vyberte Definice systému>Klientské skripty.
- Vyberte Nový a poté vyplňte formulář takto:
- Název: Copilot skript tabulky incidentů otevřeného rámce
- Tabulka Incident [incident]
- Typ uživatelského rozhraní: Desktop
- Zadejte onLoad
- Skript: Zkopírujte obsah následujícího skriptu:
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);
}
}
- Znovu vyberte Nový a poté vyplňte formulář takto:
- Název: Copilot skript tabulky e-mailů s otevřeným rámcem
- Tabulka: E-mail [sys_email]
- Typ uživatelského rozhraní: Desktop
- Zadejte onLoad
- Skript: Zkopírujte obsah následujícího skriptu.
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);
}
}
- Znovu vyberte Nový a poté vyplňte formulář takto:
- Název: Copilot skript tabulky případů otevřeného rámce
- Tabulka: Případ [sn_customerservice_case]
- Typ uživatelského rozhraní: Desktop
- Zadejte onLoad
- Skript: Zkopírujte obsah následujícího skriptu.
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);
}
}
- Znovu vyberte Nový a poté vyplňte formulář takto:
- Název: Copilot skript tabulky e-mailů s otevřeným rámcem
- Tabulka: E-mail [sys_email]
- Typ uživatelského rozhraní: Desktop
- Zadejte onLoad
- Skript: Zkopírujte obsah následujícího skriptu:
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);
}
}
Krok 8: Nakonfigurujte widget v ServiceNow
- Ve svém prostředí ServiceNow vyberte Vše, vyhledejte OpenFrame a poté vyberte Openframe>Konfigurace.
- V pravém horním rohu vyberte Nový.
- Zadejte Microsoft Copilot jako název a nadpis.
- Zadejte 450 pro šířku a 600 pro výšku.
- Vyberte skupiny uživatelů, pro které chcete Copilot pro Service zapnout.
- Vyberte ikonu zámku vedle pole Adresa URL, abyste ho odemkli, a poté vložte adresu URL widgetu Copilot pro Service, kterou jste si dříve uložili na stránce správce Copilot pro Service.
- Vyberte položku Odeslat.
- Aktualizujte stránku. Widget Copilot pro Service by měl být k dispozici na horním navigačním panelu pro ikonu, kterou jste vybrali.
- Než otevřete Copilot pro Service, ujistěte se, že jste na své stránce ServiceNow povolili vyskakovací okna.