---
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


---

# Create a smart link preference

# Create a smart link preference {#ariaid-title1}

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

Create smart links to specify where a URL should open. For example, the URL could
open in a new browser window, in a new browser tab, in the chat window, or in a pop-up
window.

## Vorbereitungen

Role required: virtual_agent_admin or admin

## Warum und wann dieser Vorgang ausgeführt wird

If you (as an admin) have enabled [URL navigation](https://servicenow-prod.fluidtopics.net/mFdbQf5Xlyy_X3eK4KesNA "Use URL navigation settings to specify where and how chat links open. You can configure certain links to open in a specific portal. You can also specify the link target, such as a popup window.") on the page, you can
specify patterns for where and how the links open in the chat windows. End users see
the URL links based on the patterns you've specified.

For example, you can set these URL "smart links" to open in a new browser window, in
a new browser tab, in the chat window, or in a pop-up window. If you specify a
pop-up window, you can set the size of the window your end users see.

Smart links can be used in chats with live agents.

Error messages display for channels that don't support smart links.

## Prozedur

1. Navigate to AllConversational InterfacesSettings.
2. Under the System actions section, select View All next to URL navigation.
3. Select the Target Location tab.
4. Select New.
5. On the form, fill in the fields.  
   {#create-smart-link-preference__table_hrj_m1m_gtb__entry__2}

   | Field | Description |
   |-|-|
   | Description | The purpose of the smart link. |
   | Where to open | Where to open the link. Choose one of the following options: * New Browser Tab: Opens the link in a new browser tab. * Load in Place:: Opens the link in the current location. * Parent: Opens the link at the highest or parent level. * Popup: Opens the link in a pop-up window and lets you specify the pop-up window size. * Raise Event: In the chat widget only, prevents the default select behavior, avoiding a page navigation (the chat is kept open). {#create-smart-link-preference__ul_zwm_tdm_gtb} |
   | Order | Number that indicates the order in which smart link preferences run. If there are multiple preferences, the system runs the first smart link preference found, from lowest to highest order. |
   | URL Pattern | URL pattern that uses regular expression quantifiers. If the regular expression is invalid, an error message is shown. ![Invalid regular expression message.]() |
   | Condition mode | Expression logic to specify a condition for applying the smart link preference. Select either: * Simple, or * Advanced {#create-smart-link-preference__ul_h3y_wdd_3vb} |
   | Set conditions Hinweis: Applies only if you select the Simple condition mode. | If you select the Simple condition mode, use the condition builder to add or edit the condition. The condition builder specifies that the smart link is only applicable to links in the Service Portal when they're accessed on the chat widget. * devicetype: Refers to the channel. In the Australia release, only the chat widget (mweb) is supported. The mobile chat widget isn't supported currently. * portal: Represents a specific portal. Specify the portal URL suffix in the condition. Navigate to AllService PortalPortals to view portals and their suffixes * Select Set. {#create-smart-link-preference__ul_k2l_ybd_3vb} |
   | Script Hinweis: Applies only if you select the Advanced condition mode. | If you select the Advanced condition mode, use the script editor to create or edit a JavaScript condition statement. When the end user selects the link, the component triggers a [Window: message event](https://developer.mozilla.org/en-US/docs/Web/API/Window/message_event). As a developer, if you see the [Window: message event](https://developer.mozilla.org/en-US/docs/Web/API/Window/message_event), you can decide how to handle the navigation. For example: window.addEventListener('message', e => { if (e.data.type === 'SMART_LINK_CLICKED') { console.log(e.data); /** { type: 'SMART_LINK_CLICKED', src: 'https://domain.com/link/src' } */ } }); |
   [ ]

   {#create-smart-link-preference__table_hrj_m1m_gtb}
6. Select Save.

## Nächste Maßnahme

If you would like to enable smart link preference for Microsoft Teams,
you must first [Configure link
authentication and opening experience in Microsoft Teams](https://servicenow-prod.fluidtopics.net/HmkhfmQ6pR4gTNP1I__k1w "Link authentication and opening experience in Microsoft Teams provides a seamless experience for end users to interact with ServiceNow links when you use Virtual Agent on Microsoft Teams.") and then [Configure smart links in Microsoft Teams](https://servicenow-prod.fluidtopics.net/ZquJvYXnLpL732lrK7SpKg "Configure smart links for your Virtual Agent app in Microsoft Teams to enable different link opening experiences.")