Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Using Your Own SMS Provider


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


About Using Your Own SMS Provider

With SMS distributions, you can send surveys or survey links directly to your respondents’ phones through text. Many customers elect to use Qualtrics’ preconfigured setup, but if your company has a preexisting relationship with an SMS provider, you can use that to send SMS distributions in Qualtrics instead.

Qualtrics does not recommend any provider over another, but we do recommend that customers research the best service provider for their business. All providers listed on this page can be integrated with Qualtrics, but coverage and feature availability may vary in different regions and countries.

Attention: If you are using your own SMS provider, information on message costs will not be tracked in Qualtrics. All messages will be reflected with zero cost in the Qualtrics user interface. To get an accurate cost of your messages, please consult with your provider (e.g., Twilio).
Qtip: Regardless of the provider you use, the steps to send SMS distributions are the same. Once you’re finished with your provider setup, see the SMS Distributions support page.
Qtip: If you haven’t finished configuring your SMS provider, SMS traffic may continue to be processed by the Qualtrics supported SMS system.

Where in the Platform You Can Use Your Own SMS Provider

You can set up your own SMS provider for just about any project or feature compatible with SMS. This includes:

  • SMS in a survey project
  • XM Directory
  • XM Directory Lite
  • Compatible Employee Experience projects

Required Admin Setup in Qualtrics

Qtip: You must be a Brand Administrator to complete the steps outlined on this section.
  1. SMS distributions are an add-on feature not included in the standard Qualtrics license. Make sure your license has SMS. You can confirm this with your Account Executive.
  2. Contact your Account Executive and ask them to send you the plugin for your chosen SMS provider. The providers we currently support include:
    • Twilio
    • Link Mobility
    • Sinch LiveLink
    • Infobip
    • MessageMedia
    • Vonage
    • MessageBird
      Attention: If you are interested in using an SMS provider that is not listed, please talk to your Account Executive about enabling your preferred service provider.
  3. Log into your Qualtrics account.
  4. Use the navigation menu to go to Admin.
    using the navigation menu to go to admin, and then navigating to extensions
  5. Click Extensions.
  6. Use the search bar to find your SMS provider.
    searching for an sms provider to add
  7. Click the name of the extension.
  8. Click Add Account.
    adding an sms provider
  9. Fill out all the fields required to connect your account to Qualtrics. See the following guides for fields specific to your SMS Provider:
Qtip: You can only have 1 active SMS provider connection with Qualtrics at a time. If you add multiple connections in Qualtrics, Qualtrics will choose the first 1 in the list to connect to.
Qtip: If you want to change any of the details of a connection (including the sender number or ID), you will need to create a new connection and delete the old connection.

Twilio

This section describes steps to take to connect your Twilio Account to Qualtrics.

Qtip: Twilio is the default SMS service provider on Qualtrics. Connecting your own Twilio Account gives you access to extra features not available when using the default Qualtrics managed Twilio.
Qtip: We recommend using a Twilio SubAccount, if possible.

Steps in Qualtrics

Have a Brand Administrator complete the Required Steps in Qualtrics.

These are the fields your Brand Administrator will need to fill out to connect a Twilio account.

Picture of fields in Qualtrics

  • Name: Enter any name that will help you later identify what this connection is / what it’s for.
  • Account SID: Twilio Account SID used for API access. You can find this on the dashboard after logging into Twilio.
  • Auth Token: Twilio Auth Token used for API access. You can find this on the dashboard after logging into Twilio.
  • Phone Number, Sender ID or Twilio Messaging Service ID: The number or ID that will be used as the ‘FROM’ number when sending an SMS message. This may be 1 of the following:
    • A specific number, e.g., 13531234567. This must be a number purchased in your Twilio account. Always include the country code at the beginning of the number.
      Qtip: You can also use short codes. See Twilio’s documentation for more details.
    • An Alphanumeric senderId, e.g., Qualtrics. Please note this must be set up in Twilio to be supported. Please see Twilio’s documentation.
    • A Twilio Messaging Service ID. Please see Twilio’s documentation on Messaging Services. Messaging Service Ids start with MG and are found under the Properties section of the Messaging Service tab after logging into Twilio.
      Properties tab in Twilio

      Qtip: The Twilio Messaging Service ID gives you the most control over regional numbers and smart routing.

After connecting a Twilio account, follow these steps and select Give access to all users.

Qtip: You must give access to all users in the steps described here. If you’d like to restrict access for certain users in your license, try editing user or group permissions. The permission “Use SMS Distributions” controls who can distribute through SMS.

Steps in Twilio

You will need to set up webhooks for your numbers or messaging services. Please see additional information on webhooks from Twilio here.

Qtip: Qualtrics will set the status callback URL on each request of a message. If you wish to enable 2-way SMS (Interactive SMS), you must set up a message callback URL so Qualtrics will receive and process responses to an invite.
Warning: If you are using an alphanumeric sender id, opt out words will only opt the respondent out of your Twilio number distributions, not the Qualtrics contact list / directory. Please note that many countries have strict laws around allowing respondents to opt out of distributions. If you are using an alphanumeric sender id, it is therefore important that you include some sort of opt-out link inside the survey itself; please note that the piped text opt out link will not work inside a survey.

Configuring Webhooks

The URL for your webhook takes the following form. Note that several parameters must be edited with information from your Qualtrics license / brand.

https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/message/twilio-sms/<OrganizationID>

The method should be HTTP/POST.

Configuring Webhooks for Numbers

To configure the webhook in Twilio for a number:

Showing the Twilio page described in the steps below

  1. Select Manager Numbers.
  2. Got to the Active Numbers section.
  3. Select the number you wish to configure.
  4. Under the Messaging header, choose to configure with Webhooks.
  5. Set the message to Webhook, set the URL to the following, with the < > and everything inside replaced with you organization’s parameters:
    https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/message/twilio-sms/<OrganizationID>
  6. Ensure it is marked as a HTTP/POST method.
  7. You can also specify the backup URL (what to do if “Primary handler fails”) to be the same URL and method.

Configuring Webhooks for a Messaging Service

If you have configured your numbers to use a Messaging Service, you’ll add webhooks differently than you would for a single number.

In the Twilio Console:

Twilio page described in the steps below

  1. Select Programmable Messages.
  2. Select the Messaging Service you wish to configure or create a new one. Please see the Twilio Support documentation for more details.
  3. When you have selected your Messaging Service, select the Integration section.
  4. You must configure the Incoming messages to include the URL above with your organization parameters.
  5. Ensure it is marked as a HTTP/POST method.
  6. You can also specify the backup URL to be the same URL and method.

Link Mobility

This section describes steps to take to connect your Link Mobility account to Qualtrics.

Qtip: Link Mobility is based in Europe. While it offers global coverage, European customers also have the option to have all of their SMS messages processed in Europe only.

STEPS IN QUALTRICS

Have a Brand Administrator complete the Required Steps in Qualtrics.

These are the fields your Brand Administrator will need to fill out to connect a Link Mobility account.

Image of Link mobility fields, listed below

  • Name: Enter any name that will help you later identify what this connection is / what it’s for.
  • Username: The username of your Link Mobility account.
  • Password: ​​The password of your Link Mobility account.
  • Phone number / Sender ID: The number or ID that will be used as the ‘FROM’ number when sending an SMS message. This may be 1 of the following:
    • A specific number, e.g., +35312345678. Always include a plus sign ( + ) and the country code at the beginning of the number.
    • An Alphanumeric sender id, e.g., Qualtrics. Please note this must be set up in Link Mobility to be supported.
  • Platform ID provided by Link Mobility: The Platform ID provided to you by Link Mobility.
  • Platform Partner ID provided by Link Mobility: The Platform Partner ID provided to you by Link Mobility.
    Qtip: If you need help findings these IDs, we recommend reaching out to Link Mobility’s support team.
  • Endpoint host provided by Link Mobility: The endpoint host that is provided to you by Link Mobility. Only include the base host of the ur. For example, https://wsx.sp247.net/sms becomes wsx.sp247.net.
  • Gate ID provided by Link Mobility: The Gate ID provided to you by Link Mobility. The credentials for this GateID must match your Username and Password for authentication purposes.

After connecting a Link Mobility account, follow these steps and select Give access to all users.

Qtip: You must give access to all users in the steps described here. If you’d like to restrict access for certain users in your license, try editing user or group permissions. The permission “Use SMS Distributions” controls who can distribute through SMS.

This section describes steps to take to connect your Sinch account to Qualtrics.

Qtip: Sinch offers global coverage, as well as local number coverage for Qualtrics users in Japan.
Qtip: A Brand Administrator must complete these steps.

SETTING UP THE QUALTRICS EXTENSION

Have a Brand Administrator complete the Required Steps in Qualtrics.

SETTING UP YOUR SINCH ACCOUNT

To enable status reporting, go to the webhooks section of your Conversation API App and select ‘Add Webhook’.

  • Target Type should be HTTP.
  • Target URL should be in the format “https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/status/sinch/<OrganizationID>
  • Secret Token should be a secret which you should generate and use for both status reporting and 2-way SMS. Keep a note of this as you will need to use it when configuring your extension in Qualtrics.
  • Triggers should be EVENT_DELIVERY and MESSAGE_DELIVERY
Image of client secret Sinch fields, listed belowTo enable 2-way sms, go to the webhooks section of your Conversation API App and select ‘Add Webhook’

  • Target Type should be HTTP.
  • Target URL should be in the format “https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/message/sinch/<OrganizationID>
  • Secret Token should be a secret which you should generate and use for both status reporting and 2-way SMS. Keep a note of this as you will need to use it when configuring your extension in Qualtrics.
  • Triggers should be MESSAGE_INBOUND

Image of client secret Sinch fields, listed below

CONNECTING YOUR SINCH ACCOUNT TO QUALTRICS

Form to connect Since Account to QualtricsThese are the fields your Brand Administrator will need to fill out to connect a Sinch account.

  • Name: Enter any name that will help you later identify what this connection is / what it’s for.
  • OAuth Client ID: This can be created on the dashboard after logging into Sinch. You will create a client ID and Secret pair, the client ID should be put here, and the secret below.Sinch Access Keys Dashboard
  • OAuth Client Secret: The secret from the client ID/secret pair created above.
  • Sinch Account DataCenter (EU or US): The region your Conversation API App is located in. This can be found on the dashboard after logging into Sinch.
  • Sinch Account Project ID: Your Sinch Account Project ID. You can find this on the dashboard after logging into Sinch.
  • Phone number or Sender ID: The number or ID that will be used as the ‘FROM’ number when sending an SMS message. This may be 1 of the following:
    • A specific number, e.g. 35312345678. Always include the country code at the beginning.
    • An alphanumeric sender ID, e.g. Qualtrics.
  • Sinch Conversational App ID: The ID for your Conversation API App. You can find this on the dashboard after logging into Sinch.Sinch Conversation API Overview
  • Webhook Secret Token: This is the secret that you created when setting up your webooks for status reporting and 2-way messages.

After connecting a Sinch account, follow these steps and select Give access to all users.

Qtip: You must give access to all users in the steps described here. If you’d like to restrict access for certain users in your license, try editing user or group permissions. The permission “Use SMS Distributions” controls who can distribute through SMS.
Qtip: If you intend to use 2-way SMS, you’ll need to use a specific number and not an alphanumeric sender ID.

Infobip

This section describes steps to take to connect your Infobip account to Qualtrics.

Qtip: A Brand Administrator must complete these steps.

Steps in Qualtrics

These are the fields your Brand Administrator will need to fill out to connect an Infobip account.
adding an infobip account

  • Name: Enter any name that will help you later identify what this connection is / what it’s for.
  • Public API Key: Your Infobip API key. To generate a key, log in to your Infobip portal and click New API Key. If you already have an API key, copy the existing key instead of generating a new key.
    finding the api key in infobip
  • Webhook password: Please provide your Infobip username and password on the Webhook password and username fields. After you finish this setup, please contact Infobip support and ask them to set Basic Authentication for your webhook. You’ll need to provide them a username and a password to use. Do not use special characters in your username.
  • Webhook username: See webhook password above.
  • Base URL provided by Infobip: Your Infobip base URL. To find your URL, log in to your Infobip portal and copy the API Base URL. When pasting your URL into Qualtrics, remove the https:// portion of the URL.
    finding the api base url in infobip
  • Phone number or Sender ID: The number or ID that will be the “FROM” number when sending SMS. To find your phone number / sender ID, log into your Infobip portal. When adding your number or ID, do not add any prefixes (+ or 00). This may be 1 of the following:
    • A specific number, e.g., 13531234567. This must be a number purchased in your Infobip account. Always include the country code at the beginning of the number.
    • A unique sender ID, either alphanumeric or numeric, e.g., QUALTRICS or 868686.
      Qtip: If you intend to use 2-way SMS, you’ll need to use a specific number and not an alphanumeric ID.

When contacting Infobip support you will need to provide them with the webhook URL(s). To enable status reporting the webhook URL will be in the format:

  • https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/status/infobip-sms/<OrganizationID>

To enable 2-way SMS the webhook URL will be in the format:

  • https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/message/infobip-sms/<OrganizationID>

After connecting an InfoBip account, follow these steps and select Give access to all users.

Qtip: You must give access to all users in the steps described here. If you’d like to restrict access for certain users in your license, try editing user or group permissions. The permission “Use SMS Distributions” controls who can distribute through SMS.

MessageMedia

This section describes steps to take to connect your MessageMedia account to Qualtrics.

Setting up your MessageMedia Account

In order to get important credentials that will let you connect you Qualtrics, you must first create a new key in your MessageMedia account.

Follow these steps to create your key under Basic Authentication.

Save the API key and secret. The key will act as your username and the secret will act as your password when you connect to Qualtrics.

Setting up the Qualtrics Extension

Have a Brand Administrator complete the Required Steps in Qualtrics.

These are the fields your Brand Administrator will need to fill out to connect a MessageMedia account.

Image of window where you enter messagemedia connection information

  • Name: Enter any name that will help you later identify what this connection is / what it’s for.
  • Username: Your MessageMedia API Key.
  • Password: Your MessageMedia API Secret.
  • Phone number, Alphanumeric Sender: The number or ID that will be used as the ‘FROM’ number when sending an SMS message. This may be 1 of the following:
    • A specific number, e.g. 35312345678.
    • An alphanumeric sender ID, e.g. Qualtrics.
      Qtip: If you want to use 2-way SMS (Interactive SMS), you’ll need to use a specific number and not an alphanumeric sender ID.
  • Enterprise Webhook – Public Key: The public key used to verify callbacks and 2-way SMS. To get this key, reach out to your MessageMedia representative.

After connecting a MessageMedia account, follow these steps and select Give access to all users.

Qtip: You must give access to all users in the steps described here. If you’d like to restrict access for certain users in your license, try editing user or group permissions. The permission “Use SMS Distributions” controls who can distribute through SMS.

 

Vonage

This section describes steps to take to connect your Vonage account to Qualtrics.

Qtip: A Brand Administrator must complete these steps.

Steps in Qualtrics

These are the fields your Brand Administrator will need to fill out to connect a Vonage account.the setup for a vonage account

  • Name: Enter any name that will help you later identify what this connection is / what it’s for.
  • Account SID: Your Vonage account ID.
  • Auth Token: Vonage Auth Token used for API access. You can find this on your dashboard after logging into Vonage.
  • Phone number, Sender ID or Vonage MessageService ID: The number or ID that will be used as the ‘FROM’ number when sending an SMS message. This may be one of the following:
    • A specific number, e.g., 35312345678. Always include the country code at the beginning, but do not include other prefixes (+ or 00).
    • An alphanumeric sender ID, e.g., Qualtrics.
      Qtip: If you intend to use two-way SMS, you’ll need to use a specific number and not an alphanumeric sender ID.
  • Signature Secret: The secret that is used to generate your webhook signature.

After connecting a Vonage account, follow these steps and select Give access to all users.

Qtip: You must give access to all users in the steps described here. If you’d like to restrict access for certain users in your license, try editing user or group permissions. The permission “Use SMS Distributions” controls who can distribute through SMS.

MessageBird

This section describes steps to take to connect your MessageBird account to Qualtrics.

Qtip: A Brand Administrator must complete these steps.

Steps in Messagebird

A MessageBird administrator will need to perform the following steps before you connect your MessageBird account.

  1. Log into Messagebird.
  2. Go to the Developers tab.the developers tab in messagebird
  3. Click API settings.
  4. Enter your Status Reports URL. The URL should be in the following format: https://DatacenterID.qualtrics.com/distribution-providers/v1/receive/distribution/status/twilio-sms/OrganizationID.
    Qtip: To find your datacenter and organization IDs, see Finding Qualtrics IDs.

If you plan on using 2-way SMS, then you must complete the additional steps below:

  1. Go to the Flow Builder tab.
    clicking create new flow in the flow builder
  2. Click Create new flow.
  3. Select Templates.
    choosing templates
  4. Choose the Call HTTP endpoint with SMS template.
    the call HTTP endpoint with SMS option
  5. For the Method, choose POST.choosing POST and adding the URL
  6. For the URL, enter your URL in the following format. https://DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/message/twilio-sms/OrganizationID.
    Qtip: To find your datacenter and organization IDs, see Finding Qualtrics IDs.
  7. Click Save.
  8. Publish your flow.
    clicking publish

Steps in Qualtrics

These are the fields your Brand Administrator will need to fill out to connect a MessageBird account.setting up a messagebird account

  • Name: Enter any name that will help you later identify what this connection is / what it’s for.
  • Signing Key: MessageBird Signing Key used for verification of incoming messages. You can find this in the Developer section of your MessageBird account.
  • Access Token: MessageBird Access Token used for API access. You can find this on your dashboard after logging into MessageBird.
  • Phone number or Sender ID: The number or ID that will be used as the ‘FROM’ number when sending an SMS message. This may be one of the following:
      • A specific number, e.g., 35312345678. Always include the country code at the beginning, but do not include other prefixes (+ or 00).
      • An alphanumeric sender ID, e.g., QUALTRICS.
    Qtip: If you intend to use two-way SMS, you’ll need to use a specific number and not an alphanumeric sender ID.

After connecting a MessageBird account, follow these steps and select Give access to all users.

Qtip: You must give access to all users in the steps described here. If you’d like to restrict access for certain users in your license, try editing user or group permissions. The permission “Use SMS Distributions” controls who can distribute through SMS.

FAQs