Script bot response control
Use the Script bot response control in a Virtual Agent topic to run a script that returns a single response or a multi-part response.
Use the Script bot response control when creating a more complex response that relies on scripted calculations or requires a multi-part response. Scripted output can include text, image, cards, links, and HTML to create a versatile response.
Script bot response control properties
| Property | Description |
|---|---|
| Node name | The name that identifies this Script bot response control node in the topic flow. |
| Script output type | The type of output returned by the script, either single-part or multi-part. |
| Script response message | The script that generates the selected output type. |
| 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 | Not supported | Not applicable |
| Microsoft Teams | Supported | None |
| Slack | Supported | None |
| Workplace | Supported | None |
| Facebook Messenger | Not supported | Not applicable |
| SMS Twilio | Not supported | Not applicable |
| LINE | Not supported | Not applicable |
| Not supported | Not applicable | |
| Apple Messages for Business | Not supported | Not applicable |
| Alexa (Voice) | Partial support | Support depends on the type of response. For example, images and links may only be available on devices with screens. For details, see Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience. |
Example script
In this example, the script calculates the time two hours from the current time and outputs a multi-part message that includes this information.
(function execute() {
var gdt = new GlideDateTime();
var gt = new GlideTime();
gdt.addSeconds(7200);
gt = gdt.getTime();
var multiOutMsg = new sn_cs.MultiPartOutMsg();
multiOutMsg.addPlainTextPart('Thank you for submitting an incident.');
multiOutMsg.addPlainTextPart('You should receive a response from a technician by ' + gt.getByFormat('HH:mm'));
return multiOutMsg;
})()
Example Script bot response control
Note: Virtual Agent Designer controls may display and function differently in other channels.
| Script properties | Script bot response output |
|---|---|
Image omitted: va-script-output-properties.png Basic properties include the node name, script output type, and the script itself. | Image omitted: va-script-output-web.png A sample script output in a chat window that reads, "This is my script output." |
Parent Topic:Assistant Designer bot responses