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

Table 1. Channel support for the Script bot response control
ChannelSupportConstraints
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
WhatsApp 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
Figure 1. Script bot response control basic properties
Basic properties include the node name, script output type, and the script itself.
Figure 2. Web UI Script bot response output
A sample script output in a chat window that reads, "This is my script output."