WhatsApp Client Handbook
WhatsApp Client Handbook
Why Clickatell
Clickatell is a WhatsApp BSP (Business Solution Provider) and will
facilitate your company’s onboarding process with WhatsApp, as
well as help you launch programs within the channel. We’ll also help
to ensure that you comply with the WhatsApp brand requirements
and experience a smooth approval process for your programs.
Important:
Read this guidebook in its entirety. It’s important to understand how WhatsApp provides a channel
for business communication with consumers. Usage of the WhatsApp Business solution needs to
be structured and tailored specifically around customer care and two-way communication between
brands and consumers.
Important:
The WhatsApp Business solution has moved into a post-beta phase and some of the manual processes still
need to be enhanced and automated.
180 Countries
WhatsApp
More than 1 billion people in over 180 countries use WhatsApp to stay in touch with friends and family- anytime and anywhere.
WhatsApp is free and offers simple, secure, and reliable messaging and calling, and is available on phones all over the world.
Using the app, small businesses can interact with customers easily by using tools to automate, sort, and quickly respond to
messages.
Using Clickatell’s One API, larger brands can integrate with other enterprise systems to provide a richer set of digital
communication experiences, using a single API.
Important:
The WhatsApp Business Solution may not be used to send messages to or from the following countries and
regions: Crimea, Cuba, Iran, North Korea, and Syria.
Customer-initiated conversations
Consumers can reach out to your business on WhatsApp. This will initiate a 24-hour
conversation session. A business may then send non-template messages (plain text,
rich text, media) to the consumer as a response, only during this 24-hour window.
Typical use cases for customer-initiated conversations are customer support, status
update enquiries, or chat banking.
Re-engagement conversations
Messages sent from a business to a consumer for the first time, or more than 24
hours after the consumer last messaged the business, are known as “Re-Engagement
conversations”. This is a variation of the business-initiated conversation. All such
messages are required to make use of a template message. Typical use cases for
re-engagement conversations include status updates on support tickets after more
than 24 hours of enquiry by the consumer, or confirmations of issue resolution after
24 hours.
IMPORTANT
Key things to consider when choosing a number: In certain markets, toll-free numbers are not supported.
In South Africa, 0800 numbers do not work and should not be selected.
type for business-initiated and re-engagement conversations. Businesses can register Banking USA
2
Online
content for their most commonly used messages and simply send the relevant variable
parameters instead of recreating the entire message during the API call each time it is Today
used. It should be a string of no more than 1024 characters.
Banking USA
For the consumers who receive a notification message from your verified business for the Hi Andrew. How can we help you
today?
first time, and do not have the business number saved as a contact in their phone book, 9:35
the WhatsApp application will recognize the registered template and display the message I lost my bank card. 9:35
without any warnings. This will reduce the likelihood of your messages being marked as
Banking USA
spam by the consumer. Sorry to hear. We have two cards on
record. Which one should we stop?
Applying for Message Templates 9:35
When creating a new message template, business must follow the below best practices: 5949 xxxx xxxx 9004. 9:35
• Template name: Unique name to identify the template use case for the business. Banking USA
It should be all in lower case, with no spaces. You can use underscore to indicate a One moment please... 9:35
space.
• Template parameters: A Template Message will contain at least one parameter,
and all message formatting options will apply. Parameters cannot have new line/tab
characters or more than 4 consecutive spaces.
Example Welcome Template:
Clickatell_Welcome_message: “ Hello {{1}}. This is a demo welcome message from {{2}}”
• Templates that threaten customers with a legal course of action will be rejected. 2 Banking USA
Online
Tier 1: Allows your business to send Tier 2: Allows your business to send Tier 3: Allows your business to send
messages to 1K unique customers in a messages to 10K unique customers in a messages to 100K unique customers in a
rolling 24-hour period. rolling 24-hour period. rolling 24-hour period
Businesses start with Messaging Limit Tier 1 and will be Below is an example illustrating the upgrade from one Messaging Limit
Tier to the next:
upgraded to the next tier if:
• The business maintains high conversation and
messaging quality
• The cumulative number of users it sends notifications
to adds up to twice its current messaging limit
within a 7-day period. Once the business reaches
this threshold, it will be moved to the next tier. The
minimum amount of time in which this upgrade can
occur is 48 hours, when the business is sending
messages up to their current limit every day.
3. Email Opt-In:
If you are interested in an email campaign, your business can contact consumers with details of the newly available
WhatsApp channel and include a clear call to action on the available opt-in methods like website or SMS.
Opt-in methods are not limited to the list above and can be defined per the business process with sufficient
compliance. www.clickatell.com | 18
ON
Below are the details for the various business quality statuses:
Flagged
◦ Messaging quality is determined to be low
◦ Messaging quality will be monitored closely for an additional 7 days, and the business is required to
maintain high or medium messaging quality
◦ If the messaging quality rating does not improve, lower message limits will be imposed on the business
phone number for notification messages
◦ Businesses will be able to respond to user-initiated messages within the 24-hour customer care
window.
For example:
In a banking environment, if a user saves the phone number of the bank brand in their contact
list when they first engage with the brand, it is prudent that the customer is recognized in
that conversation by the bank. This is achieved by the bank correctly authenticating the
user by checking to see if the user is an existing or new customer to the brand.
In the following customer journey, the financial services company, Absa, automatically
addressed its customer by their first and last name. This is an excellent example of customer
authentication and verification, as well as a rich chat experience for the consumer.
Important:
It is required to review the WhatsApp Brand Guidelines: https://whatsappbrand.com. Your positioning and
messaging need to be clear and acceptable to WhatsApp, as its intellectual property is being showcased.
We strongly recommend that you Once this is done, roll out to 1-5% From there, you can periodically
start sending and receiving messages of your users and make sure that any increase the rollout to 10%, 25%,
with internal employees first to check technical issues are fixed. 50%, 75%, and then 100% of your
that the system is working and to user base.
prevent negative experiences for your
customers.
Also, a campaign can be broken down into geographic regions or by age or socio demographics.
• Campaign AA
◦ Campaign AA.1 ◦ Campaign AA.2
> Target customers from ages 19 -24 > Target customers form ages 25 to 50
> Channels: Twitter, Facebook > Channels: Email, SMS
Examples:
• Come say Hi to us on WhatsApp
• See how we deliver amazing customer service by adding
+2712345678 and saying “Hi” on WhatsApp
• We are also on WhatsApp for Business, please add +12345678 as
a WhatsApp contact for customer service help.
The main use cases supported are around customer care and therefore
out-of-channel messaging should be around customer care and
notifications.
As all campaigns are subject to WhatsApp and in some cases the Facebook
Marketing and PR team, the following best practices should be noted:
• Do not use WhatsApp in a promotional way or incentivize the channel
with prizes and competitions
• Promotional offers and discounts should be avoided in your
messaging when WhatsApp is being mentioned
• Within their branding (and their associated promos), there needs to
be a clear separation of products from WhatsApp Business Solution
which is about giving customers a channel for customer care and
engagement in the approved use cases for your business.
WhatsApp cannot be used as an adjective like “WhatsApp Banking”.
Here are examples of allowed call to action messages via SMS, email or
web pages.
Video
You can submit large video files for review in the following ways:
• YouTube, Vimeo or 3rd party video platform via provider link.
• Raw video file for viewing (.mp4) via a Dropbox or WeTransfer link.
• If you submit a video ahead of time, WhatsApp prefers voice over (for context) for demonstrating the channel
experience and journey versus no voice over or no captioning.
• Final video approvals usually take 1 to 2 weeks. However, it’s best to share video scripts or storyboards with
WhatsApp ahead of time (40 to 60 days prior to launch) to receive early feedback before incurring expenses
on video shooting/production.
• Transcripts are okay (Word docx, Google doc, etc.)
• A quick story board is okay too. PDF file formats are preferred, as are PowerPoint slides (.pptx) wireframes.
Here is an example by KLM Royal Dutch Airlines using the WhatsApp brand in an acceptable use case. Please not
this video has no voice over sound: https://news.klm.com/klm-launches-family-updates-on-whatsapp/
5949 xxxx©2019
xxxx 9004.
Clickatell.
9:35 All rights reserved. 29
Approval Process for Drafted
Press Releases:
• Send drafts of any public-facing materials to pr@clickatell.com.
• The Clickatell team will provide edits and/or approval within one week. When it’s
ready to go to the WhatsApp team, we will facilitate approvals. The WhatsApp
team will usually respond within one week.
• Please share a press plan (timing of announcement, media targets, etc. if
appropriate)
• Materials cannot be distributed without written approval from the WhatsApp
team.
7th Floor
900 Island Drive 545 King Street West Wings Office Complex
Manhatten Plaza
Suite 202 Toronto, Ontario 17a Ozumba Mbadiwe Road
100 Edward Street
Redwood City, CA 94065 M5V 1M1 Victoria Island, Lagos
Bellville, 7530
United States Canada Nigeria
Cape Town, South Africa
©2019 Clickatell. All rights reserved. 32