Virtual Agent conversations for Vaccination Status

  • Release version: Yokohama
  • Updated January 30, 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 Virtual Agent conversations for Vaccination Status

    The Vaccination Status Virtual Agent conversation enables users to report their vaccination status via SMS. This conversation guides users through providing whether they have been vaccinated, the vaccination date, and the vaccine type. It leverages ServiceNow’s Virtual Agent chatbot to facilitate this interaction efficiently through SMS.

    Show full answer Show less

    Installation and Setup Requirements

    • Your organization must have a Twilio account and phone number configured for SMS integration.
    • Install the Virtual Agent plugin (com.glide.cs.chatbot) and the Conversational SMS Integration with Twilio application (snvasmstwilio).
    • On-premise customers using Safe Workplace applications from the Rome release onward need a scoped admin role to create a Restricted Caller Access (RCA) record that allows cross-scoped access necessary for Twilio integration within Vaccination Status.
    • The RCA record requires specific field values to enable proper application scope access.

    Configuration

    • Users must have a mobile phone number in E.164 format listed on their user record to receive and send SMS messages.
    • Privacy consent for Vaccination Status must be configured and accepted by users before they can submit vaccination data via SMS. The Virtual Agent will prompt users to complete consent if not already provided.
    • Users must belong to an audience linked to a vaccine privacy consent outreach to complete consent via SMS.
    • An SMS outreach notifies users that they can report vaccination status via SMS. To configure this:
      • Add users to the placeholder Vaccination status request audience.
      • Add this audience to the placeholder Vaccination status request outreach and customize scheduling or messaging as needed.

    Customization and Use

    • The Vaccine conversation topic is ready to use out-of-the-box but can be customized in the Virtual Agent Designer (Collaboration > Virtual Agent > Designer) to suit organizational needs.
    • The vaccine types presented to users are managed in the Vaccine response definition table, where SMS-friendly display names can be set to ensure clarity during the conversation.

    Key Outcomes

    • Enable users to conveniently report vaccination status via SMS, increasing response rates and data accuracy.
    • Ensure compliance with privacy requirements by integrating consent capture within the SMS conversation flow.
    • Provide administrators with configurable tools to tailor the conversation and outreach strategy to their organization’s requirements.
    • Leverage existing ServiceNow Virtual Agent and Safe Workplace capabilities for a seamless user experience.

    Vaccination Status provides a Virtual Agent conversation that enables users to report their vaccination status via SMS.

    A ServiceNow® Virtual Agent conversation topic defines the dialog between the Virtual Agent (chatbot) and the user to accomplish a specific goal. The provided Vaccine conversation topic asks whether the user has been vaccinated, the date that they received the vaccine, and the type of vaccine that they received.

    Installation and setup requirements

    To use Virtual Agent with SMS, your organization must have a Twilio account and phone number. You must also install the Virtual Agent plugin (com.glide.cs.chatbot) and set up the Conversational SMS Integration with Twilio application (sn_va_sms_twilio). For more information, see Set up the Conversational SMS Integration with Twilio.

    On-premise customers who install the Safe Workplace applications in the Rome release for the first time require a scoped admin role to create an approved scope-to-scope Restricted Caller Access (RCA) record in Vaccination Status. This cross-scoped access is required for Conversational SMS Integration with Twilio to function in the Vaccination Status application.

    The RCA record should have the following values set:
    Field Value
    Source Scope Emergency Outreach
    Source Type Scope
    Status Vaccination Status
    Application Vaccination Status
    Target Type Scope

    For more information on creating caller access records, see Set application scope, application resource, and event access.

    Configuration

    To receive SMS messages for Vaccination Status, users must have a mobile phone number listed on their user record [sys_user]. Mobile numbers must be in E.164 format. For example, +18585551212.

    Privacy consent for Vaccination Status must be configured before users can report their vaccination status via SMS. For instructions, see Set up privacy consent for Vaccination Status.
    Note:
    Users must agree to the privacy consent before they can submit their vaccination status. The Vaccine conversation topic prompts users to complete the privacy consent via SMS if they haven't already submitted their consent. Users must belong to an audience associated with a vaccine privacy consent outreach to be able to complete the privacy consent via SMS.

    Vaccination Status uses an SMS outreach to let users know that they can report their vaccination status via SMS. The outreach provides users with the information that they need to begin interacting with the Vaccine Virtual Agent conversation. To configure the outreach, add users to the placeholder Vaccination status request audience. For detailed instructions about adding users to an audience, see Add a Safe Workplace audience. Then, add the audience to the placeholder Vaccination status request outreach and make any modifications to the outreach if needed, such as scheduling a time to send.

    Once users receive the SMS outreach, they can report their vaccination status through the Vaccine Virtual Agent conversation. The Vaccine conversation topic is ready to use without modifications, but can be customized to meet your organization's requirements. To view or edit the Vaccine conversation topic, navigate to Collaboration > Virtual Agent > Designer. For more information about updating conversation topics, see Virtual Agent Designer.

    The Vaccine conversation provides the user with options to select which type of vaccine they received. These options are pulled from the Vaccine response definition table [sn_imt_vaccine_vaccine_response_definition]. To set the display name for a vaccine type, enter the name in the SMS friendly name field on the vaccine response definition record.