Skip to content
Release: Australia · Updated: 2026-07-09 · Official documentation · View source

Set up SMS integration on ServiceNow instance

Set up conversational SMS on a ServiceNow instance to enable customers to seamlessly talk to virtual or live agents.

Before you begin

Role required: admin

About this task

Procure an Amazon Web Services (AWS) account with the administrative access to complete the setup of SMS integration and ensure to set up integration on Amazon Web Services before this. To learn how to set up integration on AWS, see Set up SMS End User Messaging Service and AWS resources.

Procedure

  1. Create a Hash Message Verification record.

    1. In the navigation filter, enter hash_message_verification.list and select New.

    2. On the form, fill in the fields.

      FieldDescription
      NameName of the auth token, such as AWSSMSTestAppAuthToken
      DescriptionDescription of the auth token.
      SecretKey value generated while uploading the key material to KMS key during the AWS setup. To learn more about key value, see Set up SMS End User Messaging Service and AWS resources.
      DomainDomain of the hash message, such as global.
    3. Select Update.

  2. Create a Message Auth record.

    1. In the navigation filter, enter message_auth.list and select New.

    2. On the form, fill in the fields.

      FieldDescription
      NameName of the message auth, such as VA AWS SMS App Message Auth.
      ProviderProvider of the auth token. Enter Amazon.
      Group nameName of the recipient group. Leave this field blank.
      Service portalPortal that is associated with the message auth. Leave this field blank.
      Inbound message verificationHash message token that you created.
      Outbound message verificationHash message token that you created.
      Outbound service tokenAuthorized outbound service token. Leave this field blank.
    3. Select Update.

  3. Create a provider channel identity record.

    1. In the navigation filter, enter sys_cs_provider.list and select New Custom.

    2. Select the Provider Channel Identity related list and select New.

      FieldDescription
      NameName of the provider channel identity record, such as VA SMS AWS Adapter Provider.
      ChannelThe communication channel of the record, such as AWS EUM.
      Short DescriptionDescription of the provider channel identity record.
      Inbound IDThe phone number associated with Amazon Web Services that you created.
      Message AuthName of the message auth, such as VA AWS SMS Test App Message Auth.
      Default portalPortal that is associated with the channel identity record.
  4. Add the following provider properties in the Provider Properties related list.

PropertyValueDescription
aws\_end\_user\_messaging\_configuration\_set\_arnoptionalConfiguration to track the delivery of messages to the end user.
enable\_outbound\_mediatrueConfiguration to store the outbound media exchanged during a live or virtual chat.Note: The value of the field is Empty by default. If the value of the property is set to True, a bucket name must be provided and media is sent in its original form. If the value of the property is anything but True, bucket name is optional, and media is sent as a link.
aws\_eum\_api\_base\_urlAWS URLBase URL for the AWS End User Messaging APIs configured based on region.To learn how to create a base URL, see documentation
outbound\_media\_s3\_destination\_folderoptionalDestination folder to store media.
outbound\_media\_s3\_bucket\_namerequiredS3 bucket name for storing outbound media.
**Note:** The provider properties' values can be provided at a provider channel. However, to override any property to make it specific to a provider channel identity record, then you must add the corresponding provider property at the provider channel identity.
  1. Add the Identity Access Management (IAM) user credentials.

    1. In the navigation filter, enter Connection & Credential Aliases and add the AWS credentials for both AWS_EUM. and Amazon S3.

    2. Select New to create a new credential.

    3. Select the type of AWS credentials from the list and select Update to open the AWS Credentials New record form.

    4. On the form, fill in the fields.

FieldDescription
NameName of the credential.
ActiveWhether the credential is active or not.
Access Key IDAWS Access Key ID
Secret Access KeyAWS Secret Key ID
Credential AliasAlias for the credential, either EUM or S3.The credential alias is auto-selected.
AlgorithmAWS IAM Auth.
5.  Select **Submit**.

Parent Topic:Configuring Conversational SMS Integration with AWS End User Messaging