Link bot response control
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
| 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. |
| 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. |
Channel support
| 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 in the conversation. |
| SMS Twilio | Supported | None |
| LINE | Supported | None |
| 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. |
Example single-link bot response control
Note: Virtual Agent Designer controls may display and function differently in other channels.
| Single link bot response properties | Link bot response output |
|---|---|
Image omitted: va-link-output-properties.png Basic properties include node name, link list - single or multiple, header, label, and URL link. | Image omitted: va-link-output-web.png In this simple example, the header reads, "Here is a link," followed by a hyperlink that reads, "Click Here." |
Example multiple-link bot response control properties
| Multi-link bot response properties | Link bot response output |
|---|---|
Image omitted: va-multi-link-output-properties.png Basic properties with the Multiple links option selected. The link list is defined by a script. | Image omitted: va-multilink-web-output.png Example output that reads, "I found some information that might help you," followed by 3 links with titles and short descriptions.</p> Note: Multi-link bot output is also supported in Microsoft Teams, Slack, Workplace, and Facebook Messenger. |
Parent Topic:Assistant Designer bot responses