{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5266,"path":"conversational-interfaces/virtual-agent/va-link-output.md","title":"Link bot response control","bundle":null,"doc_type":null,"release":"australia","body":"\n# Link bot response control\n\nUse 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.\n\n**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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/server-api-reference/MobileDeepLinkGeneratorAPI.md) API.\n\n## Link bot response control properties\n\n<table id=\"table_il2_n2r_sdb\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nNode name\n\n</td><td>\n\nName that identifies this Link bot response control node in the topic flow.\n\n</td></tr><tr><td>\n\nLink list\n\n</td><td>\n\nType of links returned in the output result.-   Select **Single Link** to return one item in the output results.\n-   Select **Multiple Links** to return up to three items in the output results.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nSingle link properties\n\n</td></tr><tr><td>\n\nHeader\n\n</td><td>\n\nMessage displayed above the URL link. The message can be a string with variables or a script.\n\n</td></tr><tr><td>\n\nLabel\n\n</td><td>\n\nText that identifies a single link in the bot bubble. The text can be a string with variables or a script.\n\n</td></tr><tr><td>\n\nLink\n\n</td><td>\n\nLink 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`.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nMultiple links properties\n\n</td></tr><tr><td>\n\nHeader Message\n\n</td><td>\n\nText prompt that is displayed above the list of links. The prompt can be a string with variables or a script.\n\n</td></tr><tr><td>\n\nLink List Value Expression\n\n</td><td>\n\nScript that creates a list of links to display. The script includes the following parameters: link URL, link display label, link description, and link context.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nAdvanced\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nHide this node\n\n</td></tr><tr><td>\n\nConditionally show this node if\n\n</td><td>\n\nNo-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.\n\n</td></tr></tbody>\n</table>## Channel support\n\n|Channel|Support|Constraints|\n|-------|-------|-----------|\n|Web UI|Supported|None|\n|Mobile UI|Supported|None|\n|ServiceNow Otto panel|Supported|None|\n|Microsoft Teams|Supported|None|\n|Slack|Supported|None|\n|Workplace|Supported|None|\n|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.|\n|SMS Twilio|Supported|None|\n|LINE|Supported|None|\n|WhatsApp|Supported|None|\n|Apple Messages for Business|Supported|Any URLs must be added to the allowed domain list \\[sys\\_cs\\_hostname\\_allow\\_list\\] table.|\n|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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-settings-for-alexa.md).|\n\n## Example single-link bot response control\n\n**Note:** Asset library controls may display and function differently in other channels.\n\n<table id=\"table_f1f_v2p_xdb\"><thead><tr><th>\n\nSingle link bot response properties\n\n</th><th>\n\nLink bot response output\n\n</th></tr></thead><tbody><tr><td>\n\n\\[Omitted image \"va-link-output-properties.png\"\\] Alt text: Basic properties include node name, link list - single or multiple, header, label, and URL link.\n\n</td><td>\n\n\\[Omitted image \"va-link-output-web.png\"\\] Alt text: In this simple example, the header reads, \"Here is a link,\" followed by a hyperlink that reads, \"Click Here.\"\n\n</td></tr></tbody>\n</table>## Example multiple-link bot response control properties\n\n<table id=\"table_frm_vxp_3kb\"><thead><tr><th>\n\nMulti-link bot response properties\n\n</th><th>\n\nLink bot response output\n\n</th></tr></thead><tbody><tr><td>\n\n\\[Omitted image \"va-multi-link-output-properties.png\"\\] Alt text: Basic properties with the Multiple links option selected. The link list is defined by a script.\n\n</td><td>\n\n\\[Omitted image \"va-multilink-web-output.png\"\\] Alt text: Example output that reads, \"I found some information that might help you,\" followed by 3 links with titles and short descriptions.\n\n **Note:** Multi-link bot output is also supported in Microsoft Teams, Slack, Workplace, and Facebook Messenger.\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Assistant Designer bot responses](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-bot-responses.md)\n\n"}}