Intégrer un service préconfiguré agent dans ServiceNow
Vous pouvez intégrer des agents de service préconfigurés directement dans le ServiceNow Bureau avec une connaissance contextuelle de la plate-forme sous-jacente. Cette intégration aide l’application à fournir de meilleures réponses et contribue à rationaliser davantage le flux de travail de vos agents.
Conditions préalables
Avant de commencer, vous devez disposer de la console et des environnements suivants :
- Une instance Copilot pour les services connectée à un environnement ServiceNow.
- Un environnement de production ou un environnement d’essai ServiceNow.
De plus, pour que vos représentants service clientèle puissent utiliser des agents dans ServiceNow, vous devez leur attribuer le rôle agent. Pour plus d’informations sur l’attribution de ce rôle aux agents, consultez Attribuer un rôle de sécurité à un utilisateur.
Étape 1 : Copier l’URL du widget Copilot pour les services
- Connectez-vous à votre instance Copilot pour les services.
- Sur le plan du site, sélectionnez Canaux, puis sélectionnez ServiceNow.
- Copiez l’URL commençant après <iframe src=. Par exemple, https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com
- Enregistrez l’URL localement, où vous pourrez la copier et la coller ultérieurement.
Étape 2 : Installer le plug-in Knowledge API
- Dans votre environnement ServiceNow, sélectionnez Tout, recherchez les plug-ins, puis sélectionnez Définition du système>Plug-ins.
- Recherchez Knowledge API. Le système devrait renvoyer plug-in knowledge api (ID d’application : sn_km_api).
- Sélectionnez la carte Knowledge API.
- Sélectionnez Installer, puis sélectionnez la version la plus récente.
- Sélectionnez Installer maintenant, puis attendez la fin de l’installation du plug-in Knowledge API.
Étape 3 : Installer le plug-in Openframe
- Dans votre environnement ServiceNow, sélectionnez Tout, recherchez les plug-ins, puis sélectionnez Définition du système>Plug-ins.
- Recherchez Openframe. Le système devrait renvoyer plug-in openframe (ID de plug-in : com.sn_openframe).
- Sélectionnez Installer pour démarrer l’installation du plug-in.
- Sélectionnez Installer, puis attendez la fin du processus d’installation.
Étape 4 : Installer le plug-in Customer Service
- Dans votre environnement ServiceNow, sélectionnez Tout, recherchez les plug-ins, puis sélectionnez Définition du système>Plug-ins.
- Recherchez com.sn_customerservice. Le système devrait renvoyer Customer Service (ID de plug-in : com.sn_customerservice).
- Sélectionnez Installer pour démarrer l’installation du plug-in.
- Sélectionnez Installer, puis attendez la fin du processus d’installation.
Étape 5 : Ajouter le script d’interface utilisateur pour le navigateur de l’espace de travail
- Dans votre environnement ServiceNow, assurez-vous d’être dans l’espace de travail Global : sélectionnez l’icône de globe dans le coin supérieur droit, puis vérifiez que Portée de l’application est défini sur Global.
- Sélectionnez Tout, puis recherchez Scripts d’interface utilisateur, puis sélectionnez Interface utilisateur du système>Scripts d’interface utilisateur.
- Sélectionnez Nouveau, puis remplissez le formulaire comme suit :
- Nom de l’API : Copilot ouvre le script de l’espace de travail cadre
- Type d’interface utilisateur : Portail mobile/de service
- Script : Copiez le contenu du script suivant :
(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;
})();
Étape 6 : Ajouter le script d’interface utilisateur pour le navigateur de l’interface utilisateur classique
- Dans votre environnement ServiceNow, assurez-vous d’être dans l’espace de travail Global : sélectionnez l’icône de globe dans le coin supérieur droit, puis vérifiez que Portée de l’application est défini sur Global.
- Sélectionnez Tout, puis recherchez Scripts d’interface utilisateur, puis sélectionnez Interface utilisateur du système>Scripts d’interface utilisateur.
- Sélectionnez Nouveau, puis remplissez le formulaire comme suit :
- Nom de l’API : Copilot ouvrir le script cadre Bureau
- Type d’interface utilisateur : Bureau
- Activez la case à cocher Global.
- Script : Copiez le contenu du script suivant :
(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);
}
})();
Étape 7 : Ajouter des scripts client pour lier les tables
- Dans votre environnement ServiceNow, assurez-vous d’être dans l’espace de travail Global : sélectionnez l’icône de globe dans le coin supérieur droit, puis vérifiez que Portée de l’application est défini sur Global.
- Sélectionnez Tout, puis recherchez Scripts client, puis sélectionnez Définition du système>Scripts client.
- Sélectionnez Nouveau, puis remplissez le formulaire comme suit :
- Nom : Copilot ouvre le script de la table des incidents cadre
- Tableau Incident [incident]
- Type d’interface utilisateur : Bureau
- Tapez onLoad
- Script : Copiez le contenu du script suivant :
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);
}
}
- Sélectionnez Nouveau à nouveau, puis remplissez le formulaire comme suit :
- Nom : Copilot ouvre le script de table de courrier électronique cadre
- Tableau : E-mail [sys_email]
- Type d’interface utilisateur : Bureau
- Tapez onLoad
- Script : Copiez le contenu du script suivant.
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);
}
}
- Sélectionnez Nouveau à nouveau, puis remplissez le formulaire comme suit :
- Nom : Copilot ouvre le script de table de cas cadre
- Tableau : Cas [sn_customerservice_case]
- Type d’interface utilisateur : Bureau
- Tapez onLoad
- Script : Copiez le contenu du script suivant.
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);
}
}
- Sélectionnez Nouveau à nouveau, puis remplissez le formulaire comme suit :
- Nom : Copilot ouvre le script de table de courrier électronique cadre
- Tableau : E-mail [sys_email]
- Type d’interface utilisateur : Bureau
- Tapez onLoad
- Script : Copiez le contenu du script suivant :
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);
}
}
Étape 8 : Configurer un widget dans ServiceNow
- Dans votre environnement ServiceNow, sélectionnez Tout, recherchez OpenFrame, puis sélectionnez Openframe>Configurations.
- Dans le coin supérieur droit, sélectionnez Nouveau.
- Saisissez Microsoft Copilot pour le nom et le titre.
- Saisissez 450 pour la largeur et 600 pour la hauteur.
- Sélectionnez les Groupes d’utilisateurs pour lesquels vous souhaitez activer Copilot pour les services.
- Sélectionnez l’icône de verrouillage à côté du champ URL pour la déverrouiller, puis collez l’URL du widget Copilot pour les services que vous avez enregistrée précédemment à partir de la page d’administration de Copilot pour les services.
- Sélectionnez Soumettre.
- Actualisez la page. Le widget Copilot pour les services devrait être disponible dans la barre de navigation supérieure pour l’icône que vous avez sélectionnée.
- Avant d’ouvrir Copilot pour les services, assurez-vous d’avoir autorisé les fenêtres contextuelles dans votre page ServiceNow.