Verwenden Sie zum Hinzufügen das Widget für tragbare Chats Virtual Agent Zu Ihrer Webseite

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

    • Das Widget für tragbare Chats kann auf Webseiten von Drittparteien, im Serviceportal oder in ausgeführt werden UI Builder Portale.

    Das Widget für tragbare Chats ist eine neue seismische Komponente, die das Hinzufügen vereinfacht Virtual Agent Chatten Sie mit Ihrer Seite. Es vereinfacht die Konfiguration und bietet die folgenden Funktionen:
    • Einfach konfigurierbar
    • Einfacherer Authentifizierungs-Flow für Single Sign-on (SSO)
    • Stellen Sie eine Verbindung zum Serviceportal her Mitarbeiterchat
    • Systemparameter und Kontextvariablen funktionieren wie zuvor

    Voraussetzungen für die Verwendung des tragbaren Geräts Virtual Agent Chat-Widget

    Das Widget für tragbare Chats verwendet ein Inline-Frame-Element (iFrame). Die Drittpartei-Website muss sich in derselben übergeordneten Domäne wie Ihr befinden ServiceNow® Instanz. Beispiel: site1.company.com Und site2.company.com Geben Sie dieselbe übergeordnete Domäne frei. Wenn Sie das Chat-Widget in eine Subdomäne einbetten, die nicht für Ihren freigegeben ist ServiceNow Instanz, die URL muss eine anwenderdefinierte Instanz-URL sein. Aufgrund der erhöhten Browsersicherheit kann das Chat-Widget möglicherweise nicht geladen werden, wenn Sie keine anwenderdefinierte URL verwenden.

    Bevor Sie beginnen, gehen Sie wie folgt vor:
    1. Aktivieren Sie das anwenderdefinierte URL-Plugin (com.snc.customurl) in Ihrer Instanz.
    2. Fügen Sie Ihrer Instanz die anwenderdefinierte URL (die Sie zuvor erworben und registriert haben) hinzu.
    Hinweis:
    Weitere Informationen zur Verwendung anwenderdefinierter URLs finden Sie unter Zuordnen anwenderdefinierter URLs zu Ihrer Instanz .

    Verwenden der SSO-Authentifizierung mit dem tragbaren Gerät Virtual Agent Chat-Widget

    Nachdem Sie den Virtual Agent-Client eingebettet haben, können Sie optional SSO-Authentifizierung über das Chat-Widget auslösen, aber nur, wenn Ihre Instanz für die Verwendung eines externen SSO-Providers eingerichtet ist. Außerdem muss die Host Website denselben SSO-Provider wie Ihre Instanz verwenden. Weitere Informationen zum Festlegen von SSO-Anbietern finden Sie unter Externes Single Sign-on (SSO) .

    Um die SSO-Authentifizierung auszulösen, erstellen Sie ein JavaScript-Skript, das Bedingungen für die Ausführung der Authentifizierung definiert und Anwender zu einer von Ihnen angegebenen Chat-Widget-Seite umleitet. Sie geben auch die zulässigen URLs an, die in diesem Skript übergeben werden können, indem Sie sie in identifizieren com.glide.cs.web_client_login_redirect_urlsSystemeigenschaft. Geben Sie die vollständigen Umleitungs-URLs oder den Hostteil der URL an, z. B. https://example.com .

    Dieses Verfahren erfordert, dass Sie Werte für die folgenden beiden Systemeigenschaften festlegen:
    • com.glide.cs.embed.csp_frame_ancestors
    • com.glide.cs.embed.xframe_options (Nur IE 11)
    Diese Eigenschaften bestimmen die Sicherheitsrichtlinie für das eingebettete Chat-Widget, d. h. wie Browser HTML-Inhalte für rendern und sichern Virtual Agent Und Servicemitarbeiter Chat in einem iFrame, bevor Sie den Webchat-Client einbetten. Die von Ihnen angegebenen HTTP-Headerrichtlinien teilen dem Browser mit, ob eine Seite in bestimmte Domänen eingebettet werden kann, um Klickjacking-Versuche zu vermeiden. Durch das Festlegen beider Eigenschaften wird sichergestellt, dass Sicherheitsrichtlinien für wichtige Browser und auch ältere Browser wie Internet Explorer vorhanden sind.
    Hinweis:
    Wenn Sie die Anwendung Content Management System (CMS) verwenden, um anwenderdefinierte Schnittstellen für zu erstellen ServiceNow AI Platform Und ServiceNow® Anwendungen. Beachten Sie, dass dies nicht unterstützt wird Virtual Agent.