Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience

  • Release version: Zurich
  • Updated July 31, 2025
  • 3 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience

    This guide explains how ServiceNow customers can optimize their Virtual Agent configurations and topics specifically for Alexa voice chat interactions. Using the Virtual Agent Designer, customers create and manage conversation blueprints called topics that enable natural dialogue between users and the Virtual Agent over Alexa devices. Proper channel selection and message customization ensure an effective voice-first experience.

    Show full answer Show less

    Configuring Alexa Channel and Bot Messages

    • Specify Alexa as the applicable channel in the Additional channel support field for topics to function on Alexa devices.
    • Customize bot messages, including greetings and system-generated prompts, to enhance voice interaction. These messages are accessible via syscsproviderapplication.list for the Alexa application profile.
    • Use the Custom Greeting and Setup page to tailor messages specifically for voice channels.
    • System messages filtered by com.glide.cs in sysproperties.list control key voice interactions such as topic picking, account linking, and confirmations.

    Compatibility and User Input Controls

    • Most Virtual Agent components work on both screen-based and screen-less Alexa devices, but some elements (like file picker and pause) are unsupported for voice-only devices.
    • Presentation of cards and images is limited on screen-enabled Alexa devices due to Alexa skill kit specifications.
    • Supported user input controls include text input/output, static and dynamic choice selections, Boolean responses, date/time inputs, carousel selection, images, links, HTML outputs, video cards, and tables—with variations in interaction mode depending on device capabilities (touch or voice).

    Editing Bot Messages and Contextual Actions

    • Bot messages such as error messages, video/audio prompts, and table interactions can be edited via syscsproviderapplication.list under the Alexa > Bot Messages section.
    • Boolean confirmation messages can be added by configuring the message with values [0] or [1] if a message is empty.
    • Contextual actions enable the Virtual Agent to respond appropriately during custom chat integrations by mapping user inputs to specific actions, enhancing conversational relevance.

    Practical Benefits for ServiceNow Customers

    By following these guidelines, customers can ensure their Virtual Agent deployed on Alexa provides a smooth, engaging, and intuitive voice experience. Fine-tuning messages and topic settings tailored for Alexa’s capabilities maximizes user satisfaction, supports multiple interaction modes, and leverages contextual responses for more effective conversations.

    Fine-tune your Virtual Agent settings and topics provided by the Virtual Agent Designer for the best voice chat experience with Alexa.

    • Virtual Agent Designer is a diagram tool for creating and managing topics, which are blueprints for conversation between a Virtual Agent and a user. For more information, see Getting started with Virtual Agent Designer.
      Note:
      Be sure that you specify Alexa as the applicable channel in the Additional channel support field if you want the topics that you designed using the Virtual Agent Designer to work on Alexa. For more information about the channel selection, see Deploying Virtual Agent topics in other channels.
    • Bot messages help you to interact with Alexa. You can change the bot messages for interaction in a voice chat conversation. To access the bot messages, enter sys_cs_provider_application.list in the navigation filter and navigate to your Alexa application profile to find the bot messages.
      Figure 1. Bot messages for Alexa
      Provider Channel Identity settings window for Alexa, next to Alexa Provider Channel Identity window with Bot Messages highlighted.
    • You can change the greeting message and other messages only for the voice channels using the Custom Greeting and Setup page. For example, you can create a custom topic, edit it, and assign it to be used if the end user is on a voice channel. For more information about accessing the Custom Chat and to change the greeting section of the message, see Configure a Virtual Agent chat experience.

    • You can also change the system-generated messages by entering sys_properties.list in the navigation filter, and filter them by the criteria com.glide.cs to confirm that these messages work for voice channels. You can review the following key messages:
      • com.glide.cs.topic_picker_msg
      • com.glide.cs.no_topic_found_message
      • com.glide.cs.no_topic_sorry_message
      • com.glide.cs.link_account_msg
      • com.glide.cs.topic_choice_list_message
      • com.glide.cs.topic_confirmation_message
      Note:
      Most of the messages unique to the voice channels are listed in the Bot Messages section of the Provider Channel Identity record.
      For more information, see Change the Virtual Agent greeting messages in the Greeting setup topic.
    • Most components work for screen-based and screen-less devices accessed in Alexa. However, some components are not compatible especially for the screen-less devices.

      Note:
      On the screen-based Alexa enabled devices, the presentation of cards and images has limitations as per the Alexa skill kit specification.

      The Conversational Integration with Alexa application supports the following user input controls in Virtual Agent Designer.

      Note:
      Conversational Integration with Alexa also supports touch input for screen-based devices.
      Table 1. User input controls
      User input control Description Screen No screen
      Text input/output Text format that is validated when a user enters certain text items. Yes. Yes.
      Static Choice User selects an item from a predefined list. Yes, touch scroll. Yes, voice pagination.
      Dynamic Choice User selects a choice from the list of dynamically created choices. Yes, no clicking links. Yes, voice pagination.
      Boolean User enters a Boolean response to the bot. For example, the user can reply Yes or No in a chat conversation. Yes. Yes.
      Date Time User selects a calendar date, time (hours and minutes), or both. Yes (NLU recommended at the node). Yes (NLU recommended at the node).
      File Picker User sends a file to the bot. No. No.
      Pause Breaks the conversation with Alexa. No. No.
      Carousel User selects a single item from the carousel. Yes, touch scroll. Yes, reading labels.
      Image/Link/HTML output Bot sends an image, a link, or an HTML to the user. Yes, no clicking links. error_msg
      Video User can choose a video card from the header card. video_screen_device_msg video_audio_device_msg
      Card Type of header card. Choose the contents:
      • Large image with text
      • Small image with text
      • YouTube Video Card
      The fields in the dialog box change based on your choice.
      Yes, no clicking. Yes, reading labels.
      Table If you selected Record as the Reference Type, select the table to be searched. Yes

      Shows the table headers, followed by rows with column header: value pair, Speak (Table header). Please say Done to continue.

      No, reading labels

      Unfortunately, I cannot show you the content on this device. Please say Done to continue.

      Note:
      To edit or change any of the following bot messages, enter sys_cs_provider_application.list in the navigation filter of your ServiceNow instance, select Alexa > Bot Messages, and click the name of the bot message that you want to edit.
      • error_msg
      • video_screen_device_msg
      • video_audio_device_msg
      • table_msg
      If you find the message name <EMPTY> and want to add a Boolean confirmation message to the end users, you can configure the bot message with the value [0] or [1].
    • Conversational Integration with Alexa supports contextual actions that serve an appropriate response from custom chat integrations when user input is mapped to them. For more information, see Contextual actions for Alexa.