Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Secure Text user input control

The Secure Text control provides a means to encrypt sensitive information provided as simple text or other formats. Use this control to encrypt sensitive information in topics that use large language model (LLM) discovery.

Use this control to gather and encrypt user information for topics using large language model (LLM) topic discovery. The Secure Text input also avoids sensitive information from being sent through an LLM.

Secure Text user input control properties

PropertyDescription
Node nameName that identifies this Secure Text user input control node in the topic flow.
PromptText string or script that returns text. This value is used only when the default value isn’t specified. For example: `What is your password?`
Input formatText format that is validated when a user enters certain text items. When the input isn’t valid, the bot asks the user to reenter the text. Choose the format of the text item to be validated: - Text: Any text string \(no validation\). - Email: Format that consists of an email prefix \(user name\), the @ symbol, and domain. - IP address \(IPV4, IPV6\): Data communication delivery format for internet Protocol version 4 or version 6. - Phone number \(E.164\): Internationally recognized standard phone number format. - URL: Web address format. - Custom: A script that provides a validation rule for a custom text format. The script should include related error messages that are displayed when the expected format isn’t entered. For phone and IP address format examples, see E.164 phone formats and IP address field types.
Hash functionThe method digest algorithm based on the standard WS-Security specification.
Encryption saltRandom data that is used as an additional input to a one-way function that hashes data.
Advanced
Default valueA value for the user response to the prompt. For example, if you already know the user name, the default value might be `(Script Variables > Last username)`.
Confirmation messages
Input completion confirmationBot response shown to the user when the node interaction is complete. The message can be either a text string or a script that returns text. For example, if you're using dot-walking: `Thanks, (Input Variables > Username)!` Or if you're using a script, the acknowledgement might be: `Thanks, {{vaInputs.username}}!`
Default value confirmationMessage that asks the user to verify that the value in the Default value field is correct. This message is used instead of a value in the Prompt field. For example: `Are you (Script Variables > Username)?`
Hide or skip this node
Conditionally show this nodeNo-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.
Allow user to skip this nodeNo-code condition statement or low-code script that specifies a condition for letting users skip this node in the conversation. The condition must evaluate to true. You can set this field using either the condition builder or a script.
Skip repromptingNo-code condition statement or low-code script that specifies a condition for letting users skip reprompting in the conversation. When a preceding node is revisited through a topic loopback or Dialog Act, the Virtual Agent bypasses this node and automatically retain its original value.

Example Secure Text user input control

Input propertiesInput prompt
Image omitted: va-secure-text-input.png
Secure Text user input basic properties include node name, prompt, input format, hash function, and encryption salt. Advanced options include Default value, Confirmation message, and Hide or skip this node.
Image omitted: va-secure-text-input-web.png
Secure Text input shown in the web client. The text reads, “What is your first and last name?” and the user response is automatically hidden.

Channel support

Note: Virtual Agent Designer controls may display and function differently in other channels.

ChannelSupportConstraints
Web UISupportedNone.
Mobile UISupportedNone.
Now Assist panelSupportedNone.
Microsoft TeamsSupportedNone.
SlackSupportedSlack users can edit text previously entered in a conversation. However, Virtual Agent processes messages as they’re first entered. If a Slack user edits text input, such as a comment to update a case, then Virtual Agent doesn’t evaluate the edited update.
WorkplaceSupportedNone.
Facebook MessengerSupportedThe maximum character limit is 5000 characters.
SMS TwilioSupportedNone.
LINESupportedThe maximum character limit is 5000 characters.
WhatsAppSupportedNone.
Apple Messages for BusinessSupportedNone.
Alexa (Voice)SupportedFor screen devices, character limits may apply. For more information, see the Alexa developer documentation.

Parent Topic:Assistant Designer user input controls