Exploring Conversational SMS Integration with Twilio

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 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 Exploring Conversational SMS Integration with Twilio

    Conversational SMS Integration with Twilio enables ServiceNow users to engage Virtual Agent conversations via SMS by messaging a dedicated Twilio phone number. This integration facilitates initiating and continuing conversations through SMS, with seamless handoff to live agents who can respond within Agent Workspace. It is important to use separate Twilio numbers for this integration rather than sharing numbers used by ServiceNowTwilioDirect or Twilio Notify.

    Show full answer Show less

    Supported Conversation Controls and Responses

    The integration supports a subset of Virtual Agent Designer’s user input controls and bot responses tailored for SMS:

    • User Input Controls: Text, Static Choice, Dynamic Choice, Boolean (e.g., yes/no), and File Picker (limited to image files only).
    • Bot Responses: Text messages, Images, Links, and Cards presenting record information from the ServiceNow instance.

    Live agents can use Text, Card, and Image responses to communicate with users during SMS conversations.

    User SMS Notification Management

    Starting with version 1.1.1, ServiceNow users (sysuser profiles) can opt in or out of receiving SMS update notifications for their conversations. Notifications are disabled by default to comply with privacy regulations. Users can manage their notification preferences by sending specific SMS commands:

    • Send "Notification" to check current SMS notification settings.
    • Send "START" to enable SMS notifications.
    • Send "STOP" to disable SMS notifications.

    Note that only users with ServiceNow accounts can receive these notifications; guest users such as consumer or customer contacts cannot.

    Next Steps

    After setting up the integration, ServiceNow customers can create SMS conversation topics using Virtual Agent Designer to customize the SMS chat experience. For detailed instructions, customers should refer to documentation on configuring the integration and Virtual Agent Designer usage.

    Conversational SMS Integration with Twilio enables users to initiate conversations with Virtual Agent by messaging your Twilio phone number.

    Note:
    Do not use the same ServiceNowTwilioDirect or Twilio Notify phone number for Conversational SMS Integration with Twilio. Instead, use separate Twilio numbers for Conversational SMS Integration with Twilio and ServiceNowTwilioDirect.
    Figure 1. Example SMS conversation with Virtual Agent
    The user texts, "I have an issue." Virtual Agent asks for additional information and offers 4 choices for the user to select: Product issue, Order support, Billing, and Other.

    If a bot transfers the conversation to a live agent, the agent can respond to SMS messages in Agent Workspace.

    After you set up the Conversational SMS Integration with Twilio, you can create SMS conversation topics in Virtual Agent Designer. For more information about using the tool, see Getting started with Virtual Agent Designer.

    Capturing information from a user in an SMS chat conversation

    Supported controls

    The Conversational SMS Integration with Twilio does not support all the available controls in Virtual Agent Designer.

    The following user input controls are supported in Twilio SMS conversations:
    Table 1. Supported user input controls
    User input control Description
    Text

    User enters a plain text string in the conversation.

    User enters text in a conversation: "I need help!"
    Static Choice

    User selects an item from a predefined list.

    User enters "CHANGE." The bot displays 3 additional timeslots and an "Other" option. The user enters the number for a new timeslot. Appointment is confirmed.
    Dynamic Choice

    User selects an item from a list that is created dynamically. For example, the user can select from a list of cases that they opened.

    The bot displays the user's 7 open cases. The user enters 6, and the bot provides a link to view that case.
    Boolean

    User enters a Boolean response to the bot. For example, the user can reply "Yes" or "No" in the conversation.

    The bot congratulates the user on their purchase and offers to display more information. The user enters "Yes," so the bot provides a link to a KB article.
    File picker User sends a file to the bot.
    Note:
    Conversational SMS Integration with Twilio doesn't support all file types. Only images can be sent in an SMS conversation.

    The bot displays an example image that indicates the serial number location. The user uploads a photo of their product's serial number.

    For more information on configuring user input controls, see Virtual Agent Designer user input controls.

    The following bot responses are supported in Twilio SMS conversations:
    Table 2. Supported bot responses
    Bot response Description
    Text Bot sends a plain text string to the user.

    Bot sends a text: "Your order is scheduled for install on Dec 25th between 10am and 1pm. Is this ok?" The user enters YES, and the bot confirms their choice.
    Image Bot sends an image to the user.

    The bot sends an image that shows the user where to find their product's serial number.
    Link Bot sends a web link to the user.

    The bot sends an appointment confirmation to the user, who enters CHANGE. The bot responds with a link where the user can view new appointment options.
    Card Bot sends selected information from a record on your instance.

    When the user says their router is on fire, the bot creates a case and sends the card with the number, priority, assigned agent, and a link.
    For more information on configuring bot responses, see Virtual Agent Designer bot responses.

    Live agents can use the Text, Card, and Image response controls to reply to users in SMS conversations.

    User subscriptions for SMS update notifications

    Beginning with version 1.1.1, your users with ServiceNow accounts (sys_user profiles) can choose to start or stop receiving SMS updates in their conversations.
    Note:
    Notifications in messaging channels can be sent to users with ServiceNow accounts. Other recipients, such as consumer and customer contacts, are considered to be guests and cannot receive notifications on messaging channels.
    To comply with privacy regulations, user notifications are turned off by default. Users can opt in or change their settings in the following ways:
    • To check SMS notification settings for the account, send this text: Notification
    • To receive SMS notifications, send this text: START
    • To stop receiving SMS notifications, send this text: STOP
    Figure 2. Changing SMS notification settings
    The user enters "notifications" to view settings, which are currently on. The user enters STOP, and the bot unsubscribes them. When the user enters START, the bot confirms the re-subscription.

    To learn more about Virtual Agent notifications, see Configuring Virtual Agent notifications.

    For details about creating content for a messaging notification, see Define Virtual Agent notification contents.

    What to explore next

    To learn more about configuring and using , see: