Sending a WhatsApp Business API Message

The Syniverse CPaaS API service now supports WhatsApp Business API channel part of its Omni-channel API solution. It uses the same channel-agnostic API end-point as the other channels and utilizes majority of the resources as well as platform features available.

Please familiarize yourself with the Syniverse API reference guide, WhatsApp Business API Messaging guide and Engagement rules before invoking the APIs or using the message console to send WhatsApp messages.

WhatsApp Opt-In Requirements

One of the very first step in engaging user over WhatsApp Business API channel is to ensure the user has granted an explicit consent to receive messages from the Business over WhatsApp.  It is important to ensure Brand integrity and avoid a bad experience with your Brand.

WhatsApp requires that your Business application implement explicit user opt-ins/ consent gather in order to deliver messages over WhatsApp. You may gather this opt-in information either via a web page or a mobile app, such as during your application's sign-up flow, in your application's account settings, via SMS, etc. For more information, see https://developers.facebook.com/docs/whatsapp/guides/opt-in

Please note that sending messages to end users without an opt-in may result in users blocking your business as well as the suspension of your WhatsApp Business account. It is very important that Businesses familiarize themselves with the rules of engagement governing the use of WhatsApp Business as a communication channel. For more information on what is allowed and what’s not, please check out our article on Engagement rules.

Syniverse CPaaS API can currently support the following type of messages

1. Standard Text Message Templates
2. Text Messages
3. Media Messages

Other features that will be available: 

1. WhatsApp Contact Messages 
2. Location Messages 
3. Media messages templates
4. Interactive message templates

Formatting in Text Messages
WhatsApp allows some formatting in messages. To format all or part of a message, use these formatting symbols:

Formatting Symbol Example

Sending a Standard Text Notification (Template) Message

Prior to invoking the API, you must have complete the following prerequisite:

• Have a valid Sender ID
• Have an approved Template for the notification message you are sending (Details of your approved templates would be given to you by your Syniverse account manager)
  • whatsapp:name=name of your template
  • lang= Language code
• A recipient phone number (E.164 format)
• A bearer token for your Syniverse application

Note that characteristic of each template in the table below. Please note that the parameters are case sensitive.

If you are planning to support more than one language, you need to provide translations for all supported languages for all elements. 

Please note that the template message body has a max character limit of 1024.  

Sending a Notification message (Template message) via API

Please note the format of the recipient address. Add the recipient's address in the "To" address field in the following format :

 wa: <recipient_phonenumber>  e.g.wa:+14085551212

curl -X POST \
https://api.syniverse.com/scg-external-api/api/v1/messaging/messages\
-H 'Authorization: Bearer{TOKEN}' \-H 'Content-Type: application/json' \
-d
{
"from": "glXrXF2rFXauB2YK0RNyh7",
"to": "wa:+18471113232", "body": "#set($RECIPIENT=\"Kola\")\n#set($DATE_TIME=\"August, 30 at 5:00PM\")\n#parse(\"whatsapp:name=appointment_reminder:lang=en_US\")",
}

It is also important to note that for new accounts, there are message limits that are tied to Business behavior on the platform. It is very important that a Business maintains a good status on the platform by making sure the user's experience is optimal.  This behavior is determined by Meta and consequently determines the message rate limit assigned to each WhatsApp Business API account.  

Sending a media WhatsApp Business API Message

Customers can send media messages in response to a user-initiated message (MO). To send a non-templated media message, you have the option of...

…. using Media url

Insert a media url link using the {"media_urls"} attribute. Ensure the media url value is an absolute URL. URL redirects are not supported

curl -X POST \

https://api.syniverse.com/scg-external-api/api/v1/messaging/messages 
 \-H 'Authorization: Bearer Token'
 \ -H 'Content-Type: application/json' \
-d '{"from":"H4kWf18Wz985Xya2tMyFs","to":["wa:+14085551212"],
"body":"Check out these pictures!",
 "media_urls":["https://drive.google.com/uc?id=1Ef6ZyETMzSZQ2vIXaDUsBUgxWR173jtk"]}'

Supported Media type

Supported Post-processing media size

Sending Customer Care messaging

This type of messaging is typically in response to a user-initiated message. Please see for information in our guide on Customer care messages.

curl -X POST 'https://api.syniverse.com/scg-external-api/api/v1/messaging/messages'
Content-Type: application/json' -H' Authorization: Bearer {token}' --data-raw 
'{
 "from": "glXrXF2rFXauB2YK0RNyh7",
 "to": "wa:+1408555XXXX",
 "body": "Thank you for your business"
}'

Please note that a single WhatsApp message can support up to 4096 characters of text message.

Supported Languages

The following are the supported languages for message templates.