Virtual Agent URL-Parameter

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer

    • Virtual Agent Stellt verschiedene Systemparameter bereit, die Administratoren einer Instanz-URL hinzufügen können, um zu steuern, wie Seiteninhalte gerendert werden.

    Virtual Agent URL-Struktur

    Sie können die für eine Instanz gerenderte Seite steuern, indem Sie der Instanz-URL URL URL-Parameter hinzufügen, die lautet https://<instancename>.service-now.com .

    Systemparameter für Virtual Agent Chat-Widget

    Die Virtual Agent Das Chat-Widget wird für die Verwendung in Portalen oder eingebettet in Seiten von Drittparteien unterstützt. Die folgenden Systemparameter steuern den Konversationsinhalt, der in gerendert wird Virtual Agent Chat-Widget.
    Parameter Beschreibung Beispiel
    Sysparm_Branding_key

    Wendet eine Chat-Branding-Konfiguration auf den Webchat-Client an.

    Wert: Branding-Schlüssel für die Konfiguration
    • Branding-Konfiguration auf eine Zielseite anwenden: https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=<branding_key>
    • Wenden Sie die Branding-Konfiguration auf ein eingebettetes Chat-Widget an: https://<instance_name>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=<branding_key>
    Sysparm_default_topic Legt das Standardthema beim Starten über das Thema fest sys_ID . https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=<topic_sys_id>
    Sysparm_Domain_ID Beschränkt den Chat auf die angegebene SYS-ID für eine Domäne. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=<domain_sys_id>
    Sysparm_live_Agent_only Leitet den Anwender direkt zu einem Servicemitarbeiter, falls verfügbar. https://<instance_name>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_live_agent_only=true
    Sysparm_load_Active_only Lädt die aktuell aktive Konversation.
    Werte:
    • Wahr: Lädt nur die aktive Konversation
    • Falsch: Lädt keine aktiven Konversationen
    Hinweis:
    Wenn die Parameter „sysparm_Skip_load_history“ und „sysparm_load_Active_only“ beide auf „wahr“ festgelegt sind, hat der vorhandene Parameter „sysparm_Skip_load_history“ Vorrang.
    		 https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_load_active_only=true
    Sysparm_search_Text Legt den Suchtext für die Konversation fest. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_search_text=<search_text>

    Beispiel: <search_text> ist Request&Laptop.
    Sysparm_Skip_load_history Überspringt den vorherigen Nachrichtenverlauf und startet eine neue Konversation.
    Werte:
    • Wahr: Lädt den Nachrichtenverlauf nicht
    • Falsch: Lädt den Nachrichtenverlauf
    Hinweis:
    Wenn der Parameter „sysparm_Skip_load_history“ auf „falsch“ und „sysparm_load_Active_only“ auf „wahr“ festgelegt ist, lädt „sysparm_load_Active_only“ die aktuelle aktive Konversation.
    		 https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_skip_load_history=true
    Sysparm_ preview_Mode Zeigt die Konversation im Testmodus an. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_preview_mode=true
    Sysparm_Requester_Session_language Gibt die Sprache der anfordernden Person für die Konversationssitzung an, wenn dynamische Übersetzung für verwendet wird Virtual Agent Ist installiert und konfiguriert. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_requester_session_language=<two-letter Sprachcode>