---
sourceDocument: Australia Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/conversational-interfaces

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Virtual Agent URL parameters

# Virtual Agent URL parameters {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Virtual Agent provides various system parameters that admins can add to
an instance URL to control how page content is rendered.

## Virtual Agent URL structure {#va-sysparm__section_lf4_vfn_yqb}

You can control the page rendered for an instance by adding URL parameters to the instance URL, which is `https://<instancename>.service-now.com`.

## System parameters for Virtual Agent chat widget {#va-sysparm__section_r3z_r3q_yqb}

The Virtual Agent chat widget is supported for use in portals or embedded in third-party pages. The following system parameters control the conversation content rendered in the Virtual Agent chat widget.{#va-sysparm__table_qf4_djq_yqb__entry__3}

| Parameter | Description | Example |
|-|-|-|
| sysparm_branding_key | Applies a chat branding configuration to the web chat client. Value: branding key for the configuration | * Apply the branding configuration to a destination page:`https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=<branding_key>` * Apply the branding configuration to an embedded chat widget: ` https://<instance_name>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=<branding_key>` {#va-sysparm__ul_g1h_bdk_wrb} |
| sysparm_default_topic | Sets the default topic on launch via topic `sys_ID`. | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=<topic_sys_id>` |
| sysparm_domain_id | Restricts the chat to the specified sys ID for a domain. | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=<domain_sys_id>` |
| sysparm_live_agent_only | Takes user directly to a live agent, if available. | `https://<instance_name>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_live_agent_only=true` |
| sysparm_load_active_only | Loads the current active conversation. Values: * true: Loads only the active conversation * false: Doesn't load active conversations {#va-sysparm__ul_dfl_434_hrb} Hinweis: If the sysparm_skip_load_history and sysparm_load_active_only parameters are both set to true, the existing sysparm_skip_load_history parameter takes precedence. | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_load_active_only=true` |
| sysparm_search_text | Sets the search text for the conversation. | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_search_text=<search_text>` For example, \<search_text\> is request\&laptop. |
| sysparm_skip_load_history | Skips the previous message history and starts a new conversation. Values: * true: Doesn't load message history * false: Loads message history {#va-sysparm__ul_xxb_lh4_hrb} Hinweis: If the sysparm_skip_load_history parameter is set to false and the sysparm_load_active_only is set to true, the sysparm_load_active_only loads the current active conversation. | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_skip_load_history=true` |
| sysparm_ preview_mode | Displays the conversation in test mode. | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_preview_mode=true` |
| sysparm_requester_session_language | Specifies the requester's language for the conversation session when Dynamic Translation for Virtual Agent is installed and configured. | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_requester_session_language=<two-letter language code>` |
[ ]

{#va-sysparm__table_qf4_djq_yqb}
**Zugehörige Konzepte**   

* [Domain separation and Virtual Agent](https://servicenow-prod.fluidtopics.net/9agZErmivfWd92DxKvZEhQ "Domain separation is supported in the Virtual Agent application. Domain separation enables you to separate data, processes, and administrative tasks into logical groupings called domains. You can control several aspects of this separation, including which users can see and access data.")
* [Virtual Agent interaction records](https://servicenow-prod.fluidtopics.net/4W2Ed2c1cbvENbIcWYvIKw "Each time a Virtual Agent conversation occurs, an interaction record captures the entire conversation in the Interactions [interaction] table. The record includes all topic elements used in the conversation, as well as live agent transfers.")
* [Virtual Agent scripts](https://servicenow-prod.fluidtopics.net/g1qhUl24oFZIN52Kr3w37Q "Use ServiceNow Virtual Agent script methods and variables to write chat scripts, such as response, trigger, and flow scripts. Variables can also provide context for your live support topics and conversations.")  
**Zugehörige Verweise**   

* [Input data types in Virtual Agent topics](https://servicenow-prod.fluidtopics.net/CdTekiP9928J3jnVyodkRQ "You can define inputs of commonly used Glide Virtual Agent (com.glide.cs.chatbot) data types in Assistant Designer without writing a script. Define the input data type on the Start node of a custom control or topic block.")
* [NLU system entities](https://servicenow-prod.fluidtopics.net/JKmncAulkWJiXY_9Lw~vqw "Use globally defined NLU entities to identify system information that Virtual Agent can extract from the conversation. You can define entities as \"nodeless\" input variables for a topic. These variables can be slot-filled from NLU service provider predictions or provided outside of the scope of the topic.")
* [Latency feedback in Virtual Agent](https://servicenow-prod.fluidtopics.net/1EdgfAr1ipfGdVHd9G2YEw "The com.glide.cs.message.processing.enabled system property notifies requesters whenever the generative AI large language model (LLM) is processing their request in the Virtual Agent chat widget and Now Assist panel.")