Konfigurieren Sie das tragbare Gerät Virtual Agent Chat-Widget

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Konfigurieren Sie das tragbare Gerät Virtual Agent Auszuführendes Chat-Widget Virtual Agent Auf Webseiten von Drittparteien.

    Vorbereitungen

    Hinweis:
    Für das Onboarding neuer Kunden ab Vancouver ist das Chat-Widget standardmäßig nur für authentifizierte Anwender zugänglich. Damit nicht authentifizierte Anwender auf das Chat-Widget zugreifen können, müssen Sie die Seite „sn_va_Web_Client_App_embed“ für den öffentlichen Zugriff aktivieren. Weitere Informationen finden Sie unter Make UI pages public or private.

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    ServiceNow Unterstützt nur tragbare Geräte Virtual Agent Wenn Domäne und Domänenname der obersten Ebene mit der Website übereinstimmen, die das Chat-Widget lädt. SSO wird nur über die URL service-now.com unterstützt. Alles darüber hinaus erfordert eine anwenderdefinierte Lösung und Implementierung.

    Prozedur

    1. Navigieren Sie zu Alle , Und geben Sie dann ein sys_properties.list Im Filter.
    2. Suchen Sie in der Tabelle „Systemeigenschaften“ [sys_properties] nach com.glide.cs.embed.csp_frame_ancestorsEigenschaft nach Name.
    3. Klicken Sie auf den Eigenschaftsnamen, um das Formular zu öffnen und die Anweisungswerte anzugeben.
      Feld Beschreibung
      Typ Zeichenfolge

      Dies ist der Standardwert.
      Wert Quellwert der HTTP-Headeranweisung: Content-Security-Policy:Frame-ancestors <source>Diese Eigenschaft gilt für die meisten wichtigen Browser, mit Ausnahme von Internet Explorer.
      Geben Sie eine oder mehrere Quellen an, einschließlich der folgenden:
      • „Selbst“ : Gibt an, dass der Ursprung mit der Seite identisch ist, die bedient wird. Beispiel: Wenn der Wert ist 'self' http://mywebsite.com, Dann wird der iFrame in die übergeordnete Domäne sowie in mywebsite.com eingebettet. Dies ist der Standardwert.
      • Hostquelle : Die Domänen, in die die externe Webseite eingebettet werden kann. Geben Sie die Internet-Host-Site anhand des Namens, der IP-Adresse oder der optionalen URL und/oder Portnummer an. Die Site-Adresse kann mit einem Platzhalterzeichen (Sternchen) beginnen. Beispielwert: http://*.example.com
      • Schemaquelle : Ein Schema. Beispiel: http: Oder https:
      • Keine : Keine übereinstimmenden URLs.
    4. Kehren Sie zur Tabelle „Systemeigenschaften“ [sys_properties] zurück, um nach zu suchen com.glide.cs.embed.xframe_optionsEigenschaft nach Name.
    5. Klicken Sie auf den Eigenschaftsnamen, um das Formular zu öffnen und die Anweisungswerte anzugeben.
      Feld Beschreibung
      Typ Zeichenfolge

      Dies ist der Standardwert.
      Wert Wert der Headeranweisung „X-Frame-Options“, um anzugeben, ob der Browser eine externe Webseite in einem Frame rendern kann.
      Geben Sie einen der folgenden Werte an:
      • Sameursprung : Zeigt die Seite in einem Frame an, der denselben Ursprung hat wie die Seite selbst. Dies ist der Standardwert. Diese Eigenschaft gilt für ältere Browser, z. B. Internet Explorer 11. Beispielwert: allow from https://example.com
      • Ablehnen : Zeigt die Seite nicht in einem Frame an.
      • Von URI zulassen : Zeigt die Seite nur in einem Frame am angegebenen Ursprung an.
        Hinweis:
        Dieser Wert funktioniert in modernen Browsern nicht mehr.
    6. Konfigurieren Sie CORS-Regeln für die REST-API, um domänenübergreifenden Zugriff zu gewähren.
      Diese Regel gibt der Webdomäne, die Sie angeben, die Rechte zum Aufrufen der API, die ihr Zugriff auf das Chat-Widget auf der Webseite ohne Sicherheitseinschränkung gewährt. Alle Domänen müssen eine gemeinsame übergeordnete Domäne teilen. Außerdem müssen Sie für jede Unterdomäne, die Sie unterstützen möchten, eine neue CORS-Regel erstellen.
      1. Navigieren zu Alle > System-Webservices > REST > CORS-Regelnan.
      2. Klicken Sie auf Neu.
      3. Füllen Sie die Felder des Formulars aus.
        Feld Beschreibung
        Name Eindeutiger Name für die Regel.
        Anwendung Umfang der Anwendung. Global Ist der Standardwert.
        REST-API Name der REST-API. Wählen Sie Aus Konversation – Verbraucheraccount [now/cs] .
        Domäne Die Domäne für Ihre Website. Beispiel: https://mycompany.com

        Wenn Sie mehrere Subdomänen für Ihre Website haben, müssen Sie für jede eine CORS-Regel erstellen. Beispiel: support.mycompany.com Und products.mycompany.com Erfordert zwei separate CORS-Regeln.

        Hinweis:
        Platzhalter sind nicht zulässig.
        Max. Alter Die Anzahl der Sekunden, die die Clientsitzung zwischengespeichert werden soll. Nach einer anfänglichen CORS-Anforderung erfordern weitere Anforderungen von demselben Client innerhalb der angegebenen Zeit keine Preflight-Nachricht.

        Wenn Sie keinen Wert angeben, der Standardwert von 0 Gibt an, dass für alle Anforderungen eine Preflight-Nachricht erforderlich ist.
      4. Auf der HTTP-Methoden Wählen Sie die Registerkarte aus ABRUFEN .
        Das Widget für tragbare Chats empfängt nur Anforderungen.
      5. Klicken Sie auf Absenden.
      6. Wahlweise: Wiederholen Sie diese Schritte, wenn Sie das Widget für tragbare Chats einer anderen Subdomäne auf Ihrer Website hinzufügen möchten.
    7. Wahlweise: Erstellen Sie ein JavaScript-Skript, das verwendet window.postMessage()Methode (Web-API) zum Definieren von Ereignisbedingungen, die die SSO-Authentifizierung auf einer Anwenderoberflächenseite auslösen und Anwender zu einer von Ihnen angegebenen Chat-Widget-Seite zurückgeben.
      Um Anwender zu einer Chat-Widget-Seite umzuleiten, verwenden Sie die folgende Zeichenfolge: „https://<your-instance>.service-now.com/sn_va_web_client_login.do?sysparm_redirect_uri=’ + encodeURIComponent(<your-page>)
      Hinweis:
      Bevor Sie das Skript ausführen, verwenden Sie com.glide.cs.web_client_login_redirect_urlsSystemeigenschaft zur Angabe der URLs, die im Skript übergeben werden können. Die Umleitung funktioniert nur, wenn Sie eine oder mehrere zulässige URLs im Eigenschaftswert angeben. Geben Sie die vollständigen Umleitungs-URLs oder den Hostteil der URL an. Beispiel: https://example.com .
      Beispiel-Skript
      <script>
    window.addEventListener("message", function(e) {
       // redirect to SSO login if the chat widget logs in but is logged in as a guest user(unauthenticated)
      if(e.data.type==="SESSION_CREATED" && e.data.authenticated === false)
        window.location.href = "https://<your-instance>.service-now.com/sn_va_web_client_login.do?sysparm_redirect_uri=<’ + encodeURIComponent(<your-page>);
      
      // redirect to SSO login if the ServiceNow platform logs out from underneath the chat widget
      if(e.data.type==="SESSION_LOGGED_OUT")
        window.location.href = "https://<your-instance>service-now.com/"https://<your-instance>service-now.com/sn_va_web_client_login.do?sysparm_redirect_uri=’ + encodeURIComponent(<your-page>);
    });
  </script>

      In diesem Beispiel wird die Authentifizierung in der angegebenen Instanz ausgelöst, wenn die Ereignisse SESSION_CREATED oder SESSION_LOGGED_OUT auftreten. Nach der Authentifizierung (wenn die SSO-Anmeldeinformationen für Anwender akzeptiert werden) werden Anwender zur Seite „eingebettetes Chat-Widget“ weitergeleitet, die Sie in angegeben haben sn_va-Web_Client_login.do?sysparm_redirect_URI=„ + encodeURIComponent(<your-page>) , Solange Sie auch die Seiten-URL im angegeben haben com.glide.cs.web_client_login_redirect_urlsEigenschaft.

    Nächste Maßnahme

    Fügen Sie das tragbare Element hinzu Virtual Agent Chat-Widget zu einer Drittpartei-Website.