Virtual Agent URL-Parameter

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer

    • Virtual Agent bietet verschiedene Systemparameter, 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 ( https://)URL-Parameter hinzufügen.<instancename> .service-now.com .

    Systemparameter für das Chat-Widget Virtual Agent

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

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

    Wert: Brandingschlüssel für die Konfiguration
    • Wenden Sie die Branding-Konfiguration auf eine Zielseite an: https://<instancename.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=acme
    • Wenden Sie die Branding-Konfiguration auf ein eingebettetes Chat-Widget an: https://<instancename.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=acme
    sysparm_default_topic Legt das Standardthema beim Start über die sys_IDdes Themas fest. https://<instancename> .service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=1f5ac6dfc34020105a61d7de76400001
    sysparm_domain_id Beschränkt den Chat auf die angegebene Sys-ID für eine Domäne. https://<instancename> .service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=c90d4b084a362312013398f051272c0d
    sysparm_live_agent_only Leitet den Anwender direkt zu einem Servicemitarbeiter weiter, falls verfügbar. https://
    sysparm_load_active_only Lädt die derzeit aktive Konversation.
    Werte:
    • true: 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://<instancename.service-now.com> $sn-va-web-client-app.do?sysparm_load_active_only=wahr
    sysparm_search_text Legt den Suchtext für die Konversation fest. https://<instancename> .service-now.com/$sn-va-web-client-app.do?sysparm_search_text=request&laptop
    sysparm_skip_load_history Überspringt den vorherigen Nachrichtenverlauf und startet eine neue Konversation.
    Werte:
    • „wahr“: Der Nachrichtenverlauf wird nicht geladen
    • „falsch“: Lädt den Nachrichtenverlauf
    Hinweis:
    Wenn der Parameter „sysparm_skip_load_history“ auf „false“ und der Parameter sysparm_load_active_only auf „true“ festgelegt ist, lädt sysparm_load_active_only den aktuell aktiven Dialog.
    		 https://<instancename.service-now.com> $sn-va-web-client-app.do?sysparm_skip_load_history=wahr
    sysparm_preview_mode Zeigt die Konversation im Testmodus an. //https://<instancename.service-now.com> $sn-va-web-client-app.do?sysparm_preview_mode=wahr
    sysparm_requester_session_language Gibt die Sprache der anfordernden Person für die Konversationssitzung an https://<instancename.service-now.com> $sn-va-web-client-app.do?sysparm_requester_session_language=<two-letter language code>