{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5296,"path":"conversational-interfaces/virtual-agent/va-text-response.md","title":"Text bot response control","bundle":null,"doc_type":null,"release":"australia","body":"\n# Text bot response control\n\nUse the Text bot response control in a Virtual Agent topic to display a bot response as text. You can format the Text bot responses using the text editor controls. For example, you can bold or italicize the text, as well as include links, bulleted lists, and emojis.\n\n## Text bot response properties\n\nUse the Text response properties panel to design bot responses to the user.\n\n\\[Omitted image \"bot-text-response.png\"\\] Alt text: Bot text response properties.\n\n<table id=\"table_gzl_msz_hdb\"><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 Text bot response node in the topic flow.\n\n</td></tr><tr><td>\n\nResponse message\n\n</td><td>\n\nThe Text bot response to the user. The response can be one of the following:-   Rich text message.\n-   Script, which can include Glide record variables or script variables.\n\n**Note:** The script can also include a temporary password for the end user.\n\n\nYou can format the text messages using the text editor controls. For example, you can use the icons on the **Response Message** field to bold or italicize the text, as well as include links, bulleted lists, numbered lists, and emojis.\n\n\\[Omitted image \"rich-text-response-message-options.png\"\\] Alt text: Text bot response message options: Open an incident in the Support Portal, or call for immediate assistance.\n\nYou can also include an input variable, such as a temporary password, in the response message.\n\n\\[Omitted image \"temp-password-text-bot.png\"\\] Alt text: Temporary password text response message.\n\nTo include a link, do one of the following:\n\n-   Select the link icon: \\[Omitted image \"link-icon.png\"\\] Alt text: Link icon..\n-   Add your response message. Select the text to use as a link, and then select the link icon.\n\nFill in the fields in the Confirmation window. Enter the text to use as the link, and then enter the URL in the Link field.\n\nEnter the display label for the link and a static URL, or use the data pill picker to create a dynamic URL.\n\n</td></tr><tr><td>\n\nAdd alternate message\n\n</td><td>\n\nAdd one or more alternate response messages for the user. Virtual Agent randomly chooses one of your responses for each conversation.\\[Omitted image \"rich-text-response-multiple-message-options.png\"\\] Alt text: Three defined alternate response messages: \"User, sounds great,\" \"Excellent choice,\" and \"Let's proceed with Chosen Option, then.\"\n\n</td></tr></tbody>\n</table><table id=\"table_vfq_y2s_z2c\"><tbody><tr><td class=\"sub-head\" colspan=\"2\">\n\nShorten responses\n\n</td></tr><tr><td>\n\nEnable\n\n</td><td>\n\nWhen turned on, long bot responses are shortened. A **Show more** link is shown along with the truncated response. When the option is turned off, the entire response is used. By default, this option is turned on.\n\n</td></tr><tr class=\"sub-head\"><td class=\"sub-head\" colspan=\"2\">\n\nMake this response secure\n\n</td></tr><tr><td>\n\nEnable\n\n</td><td>\n\nWhen enabled, the bot response is displayed to the user, but thereafter securely masked and not viewable by others.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nRequest feedback\n\n</td></tr><tr><td>\n\nEnable\n\n</td><td>\n\nWhen turned on, thumbs up and down icons are displayed next to bot responses for feedback.\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\nA 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.\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|Plain text string only|\n|SMS Twilio|Supported|None|\n|LINE|Supported|None|\n|WhatsApp|Supported|None|\n|Apple Messages for Business|Supported|None|\n|Alexa \\(Voice\\)|Supported|For screen devices, full support. For nonscreen devices, the header is read.|\n\n## Example Text bot response script\n\nIn this example, the script returns a string that greets the user. The **gs.getUser\\(\\).getFirstName\\(\\)** property is used to append the first name of the current user.\n\n```\n(function execute() {\n    return 'Hello ' + gs.getUser().getFirstName();\n})()\n```\n\nIn this example, the script returns links to three instances in the response. Use **Markdown** to include multiple links in the script.\n\n```\n(function execute() {\n    var output = 'Hello\\n';\n    output += '\\n- [Instance 1](http://instance1.com)';\n    output += '\\n- [Instance 2](http://instance2.com)';\n    output += '\\n- [Instance 3](http://instance3.com)';\n    return output;\n})()\n```\n\n## Example Text bot response control\n\n**Note:** Assistant Designer controls may display and function differently in other channels.\n\n<table id=\"table_f1f_v2p_xdb\"><thead><tr><th>\n\nResponse properties\n\n</th><th>\n\nText bot response output\n\n</th></tr></thead><tbody><tr><td>\n\n\\[Omitted image \"va-rich-text-bot-properties.png\"\\] Alt text: Basic properties include the node name and a rich text response message area.\n\n</td><td>\n\n\\[Omitted image \"rich-text-example-web-ui.png\"\\] Alt text: Text response with emojis that reads, \"We could not find any assets currently assigned to you.\" A phone number, additional steps, and a link are included.\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"}}