---
sourceDocument: Yokohama Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Link bot response control

# Link bot response control {#ariaid-title1}

Release version: Yokohama  
Updated January 30, 2025  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Link bot response control

The Link bot response control in Virtual Agent topics allows you to present bot responses containing clickable URL links.
It supports displaying either a single link or multiple links (up to three) with a header prompt above them.
This feature helps guide users to relevant resources directly from the conversation.
Show full answer Show less  
For Virtual Agent interactions on Now mobile apps, links open in the mobile browser by default. To open links within the native mobile app interface, you need to implement deep links using the MobileDeepLinkGenerator - Global API.

## Key Features

* **Node name:** Identifies the Link bot response control node in the topic flow.
* **Link list options:**
  * **Single Link:** Returns one URL link with customizable header, label, and URL. The header and label can include strings with variables or scripts, and the link must be a valid URL string or script.
  * **Multiple Links:** Returns up to three URL links with a header message and a script-generated list of links, each including URL, display label, description, and context.
* **Advanced configuration:** You can conditionally show or hide the control node using no-code or low-code conditions that evaluate to true.
* **Channel support:** The control is supported across many channels including Web UI, Mobile UI, Now Assist panel, Microsoft Teams, Slack, Workplace, Facebook Messenger, SMS Twilio, LINE, WhatsApp, Apple Messages for Business, and Alexa devices with screens.
* **Channel constraints:**
  * Facebook Messenger displays the link as a URL button.
  * Apple Messages for Business requires URLs to be on the allowed domain list table.
  * Alexa voice-only devices provide a verbal message instead of clickable links.

## Practical Use

Use the Link bot response control to direct users from Virtual Agent conversations to important web pages or records easily. Customize the header and link labels to provide clear context and relevant descriptions. For mobile app users, consider deep linking for a seamless experience within the app.

This control helps improve user engagement by enabling quick access to resources, enhancing the Virtual Agent's functionality across multiple communication channels.  
Use the Link bot response control in a Virtual Agent topic to present a
bot response. The response contains a header prompt with either a single URL link to an item or
multiple URL links for up to three items.
Note:  
If you are using the link bot response control for Virtual Agent conversations on Now mobile apps, web links open in the mobile browser. If you want links to open in a native mobile screen within the mobile app, create deep links for items in your conversation topics. For details about deep linking in mobile apps, see the MobileDeepLinkGenerator - Global API.

## Link bot response control properties {#va-link-output__section_w4l_mth_yrb}

{#va-link-output__table_il2_n2r_sdb__entry__2}

| Property | Description |
|-|-|
| Node name | Name that identifies this Link bot response control node in the topic flow. |
| Link list | Type of links returned in the output result. * Select Single Link to return one item in the output results. * Select Multiple Links to return up to three items in the output results. {#va-link-output__ul_qv5_2lt_ssb} |
| Single link properties ||
| Header | Message displayed above the URL link. The message can be a string with variables or a script. |
| Label | Text that identifies a single link in the bot bubble. The text can be a string with variables or a script. |
| Link | Link to a single item, such as a website page or a particular record. The link can be a string with variables or a script that returns a valid URL as a string. For example, you can enter the complete URL, such as `https://servicenow.com`. |
| Multiple links properties ||
| Header Message | Text prompt that is displayed above the list of links. The prompt can be a string with variables or a script. |
| Link List Value Expression | Script that creates a list of links to display. The script includes the following parameters: link URL, link display label, link description, and link context. |
| Advanced ||
| Hide this node ||
| Conditionally show this node if | No-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true. |
[ ]

{#va-link-output__table_il2_n2r_sdb}

## Channel support {#va-link-output__section_yky_plt_ssb}

{#va-link-output__table_im1_rlt_ssb__entry__3}

| Channel | Support | Constraints |
|-|-|-|
| Web UI | Supported | None |
| Mobile UI | Supported | None |
| Now Assist panel | Supported | None |
| Microsoft Teams | Supported | None |
| Slack | Supported | None |
| Workplace | Supported | None |
| Facebook Messenger | Supported | The web link appears as a [URL button](https://developers.facebook.com/docs/messenger-platform/send-messages/buttons#url) in the conversation. |
| SMS Twilio | Supported | None |
| LINE | Supported | None |
| WhatsApp | Supported | None |
| Apple Messages for Business | Supported | Any URLs must be added to the allowed domain list \[sys_cs_hostname_allow_list\] table. |
| Alexa (Voice) | Partial support | Supported on devices with screens. For nonscreen devices, the user receives a message: We found a link. For details, see [Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience](https://servicenow-prod.fluidtopics.net/2aG~8E93QEms4qm56DKb4A "Fine-tune your Virtual Agent settings and topics provided by the Virtual Agent Designer for the best voice chat experience with Alexa."). |
[Table 1. Channel support for the Link bot response control]

{#va-link-output__table_im1_rlt_ssb}

## Example single-link bot response control {#va-link-output__section_xsp_p2r_sdb}

Note:  
Virtual Agent Designer controls may display and function differently in other channels.  
{#va-link-output__table_f1f_v2p_xdb__entry__2}

| Single link bot response properties | Link bot response output |
|-|-|
| Figure 1. Single Link bot response control basic properties | Figure 2. Web UI Link bot response output |
[ ]

{#va-link-output__table_f1f_v2p_xdb}

## Example multiple-link bot response control properties {#va-link-output__section_ysk_l2r_sdb}

{#va-link-output__table_frm_vxp_3kb__entry__2}

| Multi-link bot response properties | Link bot response output |
|-|-|
| Figure 3. Multi-link bot response control basic properties | Figure 4. Web UI Link bot response output - multiple URL links Note: Multi-link bot output is also supported in Microsoft Teams, Slack, Workplace, and Facebook Messenger. |
[ ]

{#va-link-output__table_frm_vxp_3kb}