Customer Experience
Employee Experience
Brand Experience
Product Experience
Core XM
Design XM

WhatsApp Distributions

What's on This Page:

About Distributing Surveys through WhatsApp

WhatsApp is one of the most widely used messenger apps in the world. With WhatsApp, your Qualtrics survey can reach a wider audience.

There are two ways you can use WhatsApp to send surveys to your respondents:

2-way WhatsApp message: Also called an interactive survey. Qualtrics will send the survey questions directly inside WhatsApp, and the recipient will message back all their responses.
1-way WhatsApp link: Send a WhatsApp message that includes a survey link. When the recipient clicks the link, they’ll be taken to the survey in their mobile browser.

Qtip: WhatsApp is available to all licenses with XM Directory.

Overview of WhatsApp Setup

Before you can start sending WhatsApp distributions in Qualtrics, there are a few setup steps you need to complete. Click a linked section for information, or continue scrolling to start at the beginning.

Become eligible to send WhatsApp distributions using the self-service or sub-account model.
Create your survey.
Qtip: For 2-way distributions, be sure to follow the survey design guidelines to ensure it is compatible with direct messages. If you’re distributing a survey link through WhatsApp, there are no limits to your survey design.
Create your survey messages.
- Instructions for sub-account model
- Instructions for self-service model
Create a WhatsApp distribution.
- Import WhatsApp numbers to XM Directory
  Qtip: Required for both 2-Way and Survey Link distributions.
- Instructions for 2-Way Distributions
- Instructions for Survey Link Distributions
Upgrade your WhatsApp business account to an official one (Optional)

Steps Required Before WhatsApp Distribution

Before you can distribute your survey through WhatsApp, you will need to complete some preliminary setup steps. First, you need to decide if you are using the self-service model or the sub-account model. Pricing for these models may differ, so make sure you talk to your Account Representative or Customer Success Representative.

Sub-account model: The default model and our recommendation. Leverage Qualtrics’ existing relationship with Twilio, the cloud communication platform through which WhatsApp and SMS distributions in Qualtrics are made possible. Benefits of this model include assistance onboarding, maintaining, and troubleshooting the integration with help from your Qualtrics Customer Success Representative.
Self-service model: Recommended if your company has an existing own relationship with Twilio and a dedicated support team that can handle issues directly with Twilio. This model affords your own control over onboarding, maintaining, and troubleshooting the integration with WhatsApp.

Please complete the steps described on one of the two support pages linked above before you proceed with the instructions on the rest of this page.

WhatsApp Messages Pricing

Qtip: The pricing of WhatsApp distributions is managed by Twilio in the self-service model and Qualtrics in the sub-account model.

Sub-Account Model

In the sub-account model, you need to purchase WhatsApp credits to send WhatsApp surveys through Qualtrics. Credit use depends on the recipient’s country/region. See the below table for an explanation of credit by country.

Click here to view a table of credit consumption by country.

Note that credits are consumed based on the type of message:

Initial Credits: Outbound messages sent via Qualtrics that use one of the pre-approved templates.
Subsequent Credits: All incoming messages, or outgoing replies to template messages within 24-hours. A messaging session starts when a user sends your application a message, and lasts for 24 hours from the most recently received message.

Country/Region Name	Country Code	Initial Credits	Subsequent Credits
Afghanistan	AF	6	0.4
Albania	AL	7	0.4
Algeria	DZ	7	0.4
Angola	AO	7	0.4
Argentina	AR	5	0.4
Armenia	AM	7	0.4
Australia	AU	6	0.4
Austria	AT	8	0.4
Azerbaijan	AZ	7	0.4
Bahrain	BH	6	0.4
Bangladesh	BD	6	0.4
Belarus	BY	7	0.4
Belgium	BE	8	0.4
Benin	BJ	7	0.4
Bolivia	BO	6	0.4
Botswana	BW	7	0.4
Brazil	BR	6	0.4
Bulgaria	BG	7	0.4
Burkina Faso	BF	7	0.4
Burundi	BI	7	0.4
Cambodia	KH	6	0.4
Cameroon	CM	7	0.4
Canada	CA	2	0.4
Chad	TD	7	0.4
Chile	CL	7	0.4
China	CN	6	0.4
Colombia	CO	2	0.4
Congo	CG	7	0.4
Costa Rica	CR	6	0.4
Croatia	HR	7	0.4
Czech Republic	CZ	7	0.4
Denmark	DK	8	0.4
Dominican Republic	DO	6	0.4
DR Congo	CD	7	0.4
Ecuador	EC	6	0.4
Egypt	EG	8	0.4
El Salvador	SV	6	0.4
Ethiopia	ET	7	0.4
Finland	FI	8	0.4
France	FR	9	0.4
Gabon	GA	7	0.4
Gambia	GM	7	0.4
Georgia	GE	7	0.4
Germany	DE	9	0.4
Ghana	GH	7	0.4
Greece	GR	7	0.4
Guatemala	GT	6	0.4
Guinea-Bissau	GW	7	0.4
Haiti	HT	6	0.4
Honduras	HN	6	0.4
Hong Kong	HK	6	0.4
Hungary	HU	7	0.4
India	IN	1	0.4
Indonesia	ID	3	0.4
Iraq	IQ	6	0.4
Ireland	IE	8	0.4
Israel	IL	3	0.4
Italy	IT	5	0.4
Jamaica	JM	6	0.4
Japan	JP	6	0.4
Jordan	JO	6	0.4
Kenya	KE	7	0.4
Kuwait	KW	6	0.4
Laos PDR	LA	6	0.4
Latvia	LV	7	0.4
Lebanon	LB	6	0.4
Lesotho	LS	7	0.4
Liberia	LR	7	0.4
Libya	LY	7	0.4
Macedonia	MK	7	0.4
Madagascar	MG	7	0.4
Malawi	MW	7	0.4
Malaysia	MY	5	0.4
Mali	ML	7	0.4
Mauritania	MR	7	0.4
Mexico	MX	2	0.4
Moldova	MD	7	0.4
Mongolia	MN	6	0.4
Morocco	MA	7	0.4
Mozambique	MZ	7	0.4
Namibia	NA	7	0.4
Nepal	NP	6	0.4
Netherlands	NL	9	0.4
New Zealand	NZ	6	0.4
Nicaragua	NI	6	0.4
Niger	NE	7	0.4
Nigeria	NG	4	0.4
Norway	NO	8	0.4
Oman	OM	6	0.4
Pakistan	PK	3	0.4
Panama	PA	6	0.4
Papua New Guinea	PG	6	0.4
Paraguay	PY	6	0.4
Peru	PE	5	0.4
Philippines	PH	6	0.4
Poland	PL	7	0.4
Portugal	PT	8	0.4
Puerto Rico	PR	6	0.4
Qatar	QA	6	0.4
Romania	RO	7	0.4
Russia	RU	6	0.4
Rwanda	RW	7	0.4
Saudi Arabia	SA	3	0.4
Senegal	SN	7	0.4
Serbia	RS	7	0.4
Sierra Leone	SL	7	0.4
Singapore	SG	6	0.4
Slovakia	SK	7	0.4
Slovenia	SI	7	0.4
South Africa	ZA	3	0.4
South Sudan	SS	7	0.4
Spain	ES	5	0.4
Sri Lanka	LK	6	0.4
Sudan	SD	7	0.4
Swaziland	SZ	7	0.4
Sweden	SE	8	0.4
Switzerland	CH	8	0.4
Taiwan	TW	6	0.4
Tajikistan	TJ	6	0.4
Tanzania	TZ	7	0.4
Thailand	TH	6	0.4
Togo	TG	7	0.4
Tunisia	TN	7	0.4
Turkey	TR	2	0.4
Turkmenistan	TM	6	0.4
Uganda	UG	7	0.4
Ukraine	UA	7	0.4
United Arab Emirates	AE	3	0.4
United Kingdom	GB	5	0.4
United States	US	2	0.4
Uruguay	UY	6	0.4
Uzbekistan	UZ	6	0.4
Venezuela	VE	6	0.4
Vietnam	VN	6	0.4
Yemen	YE	6	0.4
Zambia	ZM	7	0.4
Zimbabwe	ZW	5	0.4

Self-Service Model

In the self-service model, WhatsApp message cost is handled directly by customers with Twilio. You can check how much it costs to send and receive WhatsApp messages with Twilio on the Twilio site.

Survey Design for 2-Way Distributions

Qtip: If you are distributing a survey invitation through WhatsApp instead of distributing it through 2-way messaging in WhatsApp, you don’t need to follow the guidelines in this section when you design your survey.

Not all Qualtrics features are compatible with 2-way WhatsApp distribution. Only three question types are supported: NPS©, single answer multiple choice, and text entry. Additionally, you cannot have HTML formatting on your questions. However, branch logic, display logic, and custom end of survey messages (in the survey flow and in the default end of survey settings) are all compatible.

WhatsApp surveys are distributed one question at a time. If a participant answers a question, the next question will be sent. Page breaks are ignored when distributing a survey via WhatsApp. Although longer surveys are possible, we recommend keeping WhatsApp surveys simple with no more than two or three questions.

WhatsApp distributions won’t split into multiple messages, and the character limit is higher at 65536. There are no GSM-7/USC-2 encoding concerns.

Qtip: If you are sending survey invites and are not using 2-way WhatsApp distributions, you can design your survey however you want.

Importing WhatsApp Numbers

Phone numbers for a WhatsApp survey distribution are uploaded by creating a mailing list. Please note that even if you do not plan on emailing this distribution, mailing lists often require an “Email” column since they are traditionally used for email distributions.

A column for the phone number connected to the WhatsApp account should also be included. This column must be called whatsapp. Capitalization does matter.

Qtip: You will not be charged for distributing to invalid numbers.

Format for US Numbers

For phone numbers based in the United States, you are allowed to use spaces, dashes, and parentheses, provided that you remember to use the country code. The following are valid formats:

1(XXX)-XXX-XXXX
1-XXX-XXX-XXXX
1-(XXX)-XXX-XXXX
1XXXXXXXXXX
1-XXXXXXXXXX
1 (XXX) XXX-XXXX
1-(XXX) XXX-XXXX
1(XXX) XXX-XXXX

Format for UK Numbers

Numbers based in the United Kingdom must not contain spaces, dashes, or parentheses. Remove the leading 0 after the country code (44) if there is one. The following are valid formats:

44XXXXXXXXXX

Format for Other Countries

Write the country code, then the number. Be sure to remove any 0’s after the country code. Do not include spaces or dashes.

WhatsApp Message Rate Limits

WhatsApp limits the rate at which you can send messages. If you exceed the rate limit, then your messages will fail. WhatsApp contains different rate limit tiers that are automatically assigned by WhatsApp. Neither Qualtrics or Twilio can verify your current rate limit tier.

You can check your tier using your Facebook Business Manager Account. More information about message rate limits can be found on this WhatsApp support page.

Sending a 2-Way WhatsApp Survey

When sending an interactive survey through WhatsApp, Qualtrics will send the survey questions directly inside WhatsApp, and the recipient will message back all their responses.

Qtip: WhatsApp distributions can only be sent from XM Directory. You cannot send them straight from the survey, like with SMS distributions.

Go to Directories.
Go to the Distributions tab.
Select Create distribution.
Review your WhatsApp credits to ensure you have enough to send your distribution.
Select 2-way WhatsApp message.
Click Continue.
Select the survey you want to distribute.
Click Send this Survey.
Select the mailing list you want to distribute to.

Qtip: Remember to format your WhatsApp numbers correctly!
Click Send to List.
Determine the date and time the distribution should send.
Click Continue.
Click Message.
Click Load Message.
Choose your message from the library.
If you have WhatsApp downloaded and would like to send a test message to yourself, click Send Test Message and enter your number.

Qtip: Piped Text for fields such as names and Embedded Data will appear as typed in the message instead of populating with real values, since there’s not a contact to pull this information from.
When ready, click Continue.
Take a moment to review your distribution. If you want to change any part of it, click Edit next to the part you want to change. You also have another chance to send a test message to a WhatsApp number of your choosing.
If you’re ready to send the distribution, click Schedule Surveys.

Sending a Survey Link through WhatsApp

You can also send a WhatsApp message that includes a survey link. When the recipient clicks the link, they’ll be taken to the survey in their mobile browser.

Go to Directories.
Go to the Distributions tab.
Select Create distribution.
Review your WhatsApp credits to ensure you have enough to send your distribution.
Select 1-way WhatsApp link.
Click Continue.
Select the survey you’d like to distribute.
Click Send this Survey.
Select the mailing list you’d like to distribute to.
Select Send to List.
Select when you’d like the survey to go out.
Click Continue.
Click Message.
Click Load Message.
Select the message you made from the library.
If you have WhatsApp downloaded and would like to send a test message to yourself, click Send Test Message and enter your number.

Qtip: You can only run this test with a U.S. number. Piped Text for fields such as names and Embedded Data will appear as typed in the message instead of populating with real values, since there’s not a contact to pull this information from.
When ready, click Continue.
Take a moment to review your distribution. If you want to change any part of it, click Edit next to the part you want to change. You also have another chance to send a test message to a WhatsApp number of your choosing.
When ready, click Schedule Surveys.

Upgrading to a WhatsApp Official Business Account

Although not required, we recommend this step because it adds legitimacy to your WhatsApp distributions and lets respondents know your business can be trusted.

Open a Twilio Support Ticket

In order to upgrade, you must reach out to Twlio’s support team. Log into your Twilio account and navigate to https://www.twilio.com/console/support. Select Submit a ticket and provide the information described in the Twilio documentation.

Qtip: Note that approval for a WhatsApp Official Business Account is not guaranteed and is subject to approval by WhatsApp. Generally, Facebook reserves Official Business accounts for internationally recognized brands.

Benefits of Having a WhatsApp Official Business Account

Having an Official Business Account status will:

Mark your business profile as verified and official by WhatsApp.
Display business name as a contact (instead of a phone number) even if the business is not in the user’s contact list.
Display a green “verified” badge visible next to the business’s name in the WhatsApp profile.
Make survey links clickable by default.
Removes the warning that the recipient is chatting with a business account outside their contact list.

WhatsApp Official Business Account

WhatsApp Business Account

Viewing Past Distributions

WhatsApp distributions can be managed in the Mobile section of the Distributions tab. Click a distribution to view error messages, response rate, cost, and more.

Downloading Distribution History

You can download the distribution history for a specific WhatsApp distribution. This allows you to see each respondent in the distribution and view their status for the survey. More information about downloading distribution history can be found on this page.

Consenting to and Unsubscribing from WhatsApp Communications

When starting a WhatsApp survey, there are several things a respondent can say to either consent to a survey, stop the survey, or unsubscribe from all future surveys. One of each must be included in the message you send in WhatsApp distributions.

1, y, or yes: Confirms that the respondent would like to continue with the survey.
2, n, or no: The respondent would not like to take the survey. They refuse further messages from this survey, but are not opted out of future surveys.
3, stop, stopall, optout, opt-out, opt out: Unsubscribes the respondent from the mailing list, but not the directory.