Using Your Own SMS Provider
What's on This Page:
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.
Required Admin Setup in Qualtrics
- 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 Customer Success Representative.
- Contact your Customer Success Representative and ask them to send you the plugin for your chosen SMS provider. The providers we currently support include:
- Twilio
- Log into your Qualtrics account.
- Go to Admin.
- Click Extensions.
- Find the extension for your chosen SMS provider.
- Click the name of the extension.
- Click Add an account.
- Fill out all the fields required to connect your account to Qualtrics. See a guide to Twilio fields.
- 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.
Twilio
This section describes steps to take to connect your Twilio Account to Qualtrics.
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.
- 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 one of the following:
- A specific number, e.g., +135312345678. This must be a number purchased in your Twilio account. Always include a plus sign ( + ) and 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.
Qtip: The Twilio Messaging Service ID gives you the most control over regional numbers and smart routing.
- A specific number, e.g., +135312345678. This must be a number purchased in your Twilio account. Always include a plus sign ( + ) and the country code at the beginning of the number.
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.
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:
- Select Manager Numbers.
- Got to the Active Numbers section.
- Select the number you wish to configure.
- Under the Messaging header, choose to configure with Webhooks.
- 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> - Ensure it is marked as a HTTP/POST method.
- 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:
- Select Programmable Messages.
- Select the Messaging Service you wish to configure or create a new one. Please see the Twilio Support documentation for more details.
- When you have selected your Messaging Service, select the Integration section.
- You must configure the Incoming messages to include the URL above with your organization parameters.
- Ensure it is marked as a HTTP/POST method.
- You can also specify the backup URL to be the same URL and method.