De ingesloten ervaring instellen in ServiceNow

Je kunt Service in Microsoft 365 Copilot-agenten direct in de ServiceNow-desktop inbedden met contextuele kennis van het onderliggende platform. Dankzij deze integratie kan de toepassing betere antwoorden geven en de werkstroom voor uw AI-agenten verder stroomlijnen.

Voorwaarden

Voordat u begint, moet u over de volgende omgevingen en console beschikken:

Een Service in Microsoft 365 Copilot-instantie die verbonden is met een ServiceNow-omgeving.
Een ServiceNow-productieomgeving of proefomgeving.

Bovendien moet u om ervoor te zorgen dat uw klantenservicemedewerkers agenten in ServiceNow kunnen gebruiken, aan hen de rol van Basisgebruiker en Omnichannel-agent toewijzen. Als je Copilot voor meerdere gebruikers inschakelt, wijs dan de benodigde rollen toe aan alle beoogde gebruikers en neem hun gebruikersgroepen mee bij het configureren van de widget in ServiceNow. Meer informatie in Een beveiligingsrol aan een gebruiker toewijzen

De agent in ServiceNow integreren

Voer de stappen in Navigatie uit om de URL van de insluitbare widget van Copilot te kopiëren, beginnend na <iframe src=>. Bijvoorbeeld: https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com. Je gebruikt deze URL in de Configure widget in ServiceNow.
De Knowledge API-invoegtoepassing installeren
1. Selecteer in uw ServiceNow-omgeving Alle, zoek naar invoegtoepassingen en selecteer vervolgens Systeemdefinitie>Invoegtoepassingen.
2. Zoek naar Knowledge API. Het systeem zou de Knowledge API-plug-in (App-ID: sn_km_api) moeten retourneren.
3. Selecteer de Knowledge API kaart.
4. Selecteer Installeren en selecteer vervolgens de nieuwste versie.
5. Selecteer Nu installeren en wacht tot de installatie van de Knowledge API is voltooid.
De Openframe-invoegtoepassing installeren
1. Selecteer in uw ServiceNow-omgeving Alle, zoek naar invoegtoepassingen en selecteer vervolgens Systeemdefinitie>Invoegtoepassingen.
2. Zoek naar Openframe. openframe plugin (Plugin id: com.sn_openframe) wordt geretourneerd.
3. Selecteer Installeren om de invoegtoepassingsinstallatie te starten.
4. Selecteer Installeren en wacht tot de installatie is voltooid.
De invoegtoepassing Customer Service installeren
1. Selecteer in uw ServiceNow-omgeving Alle, zoek naar invoegtoepassingen en selecteer vervolgens Systeemdefinitie>Invoegtoepassingen.
2. Zoek naar com.sn_customerservice. Customer Service (Plugin id: com.sn_customerservice) wordt geretourneerd.
3. Selecteer Installeren om de invoegtoepassingsinstallatie te starten.
4. Selecteer Installeren en wacht tot de installatie is voltooid.

Het UI-script toevoegen voor de klassieke UI-navigator

Zorg ervoor dat u zich in uw ServiceNow-omgeving in de werkruimte Algemeen bevindt: selecteer het wereldbolpictogram in de rechterbovenhoek en controleer of Toepassingsbereik is ingesteld op Algemeen.
Selecteer Alle en zoek vervolgens naar UI-scripts en selecteer Systeem-UI>UI-scripts.

Selecteer Nieuw en vul het formulier als volgt in:

API-naam: Copilot-script voor open frame-bureaublad
UI-type: Bureaublad
Schakel het selectievakje Algemeen in.

Script: kopieer de inhoud van het volgende script:

(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);
  }
})();

Het clientscript voor werkruimtenavigator toevoegen

Zorg ervoor dat u zich in uw ServiceNow-omgeving in de werkruimte Algemeen bevindt: selecteer het wereldbolpictogram en controleer vervolgens of Toepassingsbereik is ingesteld op Algemeen.
Selecteer Alle, zoek naar Client-scripts en selecteer vervolgens Systeemdefinitie>Client-scripts.
Selecteer Nieuw en vul het formulier als volgt in:

Naam: Copilot-script voor open frame-werkruimtenavigatie
Tabel: Algemeen [algemeen]
UI-type: Mobiel/serviceportal
Type: onLoad

Script: kopieer de inhoud van het volgende script:

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);
    }
}

Zorg ervoor dat u zich in uw ServiceNow-omgeving in de werkruimte Algemeen bevindt: selecteer het wereldbolpictogram in de rechterbovenhoek en controleer of Toepassingsbereik is ingesteld op Algemeen.

Selecteer Alle, zoek naar Client-scripts en selecteer vervolgens Systeemdefinitie>Client-scripts.
Selecteer Nieuw en vul het formulier als volgt in:

Naam: Copilot-script voor open frame-incidenttabel
Tabel: Incident [incident]
UI-type: Bureaublad
Type: onLoad

Script: kopieer de inhoud van het volgende script:

  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. Selecteer opnieuw Nieuw en vul het formulier als volgt in: - Naam: Copilot-script voor open frame-e-mailtabel - Tabel: E-mail [sys_email] - UI-type: Bureaublad - Type: onLoad

Script: kopieer de inhoud van het volgende script:

  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. Selecteer opnieuw Nieuw en vul het formulier als volgt in:

Naam: Copilot-script voor open frame-casetabel
Tabel: Case [sn_customerservice_case]
UI-type: Bureaublad
Type: onLoad

Script: kopieer de inhoud van het volgende script:

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);
    }
}

Widget configureren in ServiceNow
1. Selecteer in uw ServiceNow-omgeving Alle, zoek naar OpenFrame en selecteer vervolgens Openframe>Configuraties.
2. Selecteer Nieuw in de rechterbovenhoek.
3. Typ Microsoft Copilot voor de naam en titel.
4. Voer 450 in voor de breedte en 600 voor de hoogte.
5. Selecteer de gebruikersgroepen waarvoor je Service wilt inschakelen in Microsoft 365 Copilot.
6. Selecteer het slotpictogram naast het URL-veld om het te ontgrendelen, en plak vervolgens de Service in Microsoft 365 Copilot widget URL die je eerder hebt opgeslagen van de Service in Microsoft 365 Copilot adminpagina.
7. Selecteer Verzenden.
8. Vernieuw de pagina. De Service in Microsoft 365 Copilot-widget zou beschikbaar moeten zijn in de bovenste navigatiebalk voor het pictogram dat je hebt gekozen.
9. Voordat je Service opent in Microsoft 365 Copilot, zorg ervoor dat je pop-ups hebt toegestaan vanaf je ServiceNow-pagina.

Feedback

Is deze pagina nuttig?

Last updated on 2025-12-11

Delen via

De ingesloten ervaring instellen in ServiceNow

Voorwaarden

De agent in ServiceNow integreren

Feedback

Aanvullende resources