WhatsApp Cloud API
Connecting a WhatsApp Cloud API account to chat with customers over WhatsApp.
Last updated
Connecting a WhatsApp Cloud API account to chat with customers over WhatsApp.
Last updated
Facebook announced the release of WhatsApp Cloud API on 20th May, and it’s available to any business of any size, big and small to communicate with customers using the official WhatsApp API.
This channel has a limited 24-hour messaging window due to WhatsApp regulations. Find out more !
To chat with your customers over WhatsApp Cloud API, connect a WhatsApp Business Profile and Facebook Business account.
Facebook App and Facebook Business Account are required and you must be the admin of both to connect.
From Settings Module, navigate to the menu item, Channels.
Press Add Channel and choose WhatsApp. The Connecting WhatsApp Cloud API dialog should open up.
Press the Connect With Facebook button.
Sign in using the Facebook account that has admin access to the Facebook App and Facebook Business Account.
You will be provided options on which number together with the WABA name you would like to connect. Select the number
Head back to the WhatsApp section in Facebook Developer App. Navigate to the Configuration subsection and set up the Callback URL. Add the generated Callback URL and verify token from Alexa360 to the corresponding fields at the webhook dialog.
At Facebook App, verify and save changes to the app.
At your Facebook App, select webhooks product and select WhatsApp Business Account in the dropdown list. Click on subscribe messages event.
Once you have completed the setup, any messages sent to your WhatsApp number will now be received in your Space.
From Settings Module, navigate to the menu item, Channels
Once you have located the WhatsApp Cloud API channel, press Configure
You can configure the following:
Channel Name - Name used internally to identify the account
Press Done to update the channel configuration
If there is a need to make a change or check your WhatsApp Business API Profile, it can be done in the Alexa360 platform.
From Settings Module, navigate to the menu item, Channels
Once you have located the WhatsApp Cloud API channel, press Profile
If the profile hasn't been synced, press Sync Profile to obtain the latest WhatsApp Business Profile information from WhatsApp
You may edit the information as needed.
Fields
Description
Profile Photo
Image shown as the profile picture of the WhatsApp Business Account
An image size of 640x640 is recommended.
Address
Address of the business. Maximum of 256 characters.
Description
Description of the business. Maximum of 512 characters.
Email address (in valid email format) to contact the business. Maximum of 128 characters.
Vertical
Industry of the business. Must be one of these accepted values:
Automotive
Beauty, Spa and Salon
Clothing and Apparel
Education
Entertainment
Event Planning and Service
Finance and Banking
Food and Grocery
Public Service
Hotel and Lodging
Medical and Health
Non-profit
Professional Services
Shopping and Retail
Travel and Transportation
Restaurant
Other
The business vertical cannot be set back to an empty value after it is created.
Website
URLs (including http:// or https://) associated with the business (e.g., website, Facebook Page, Instagram). Maximum of 2 websites with a maximum of 256 characters each.
Review the information and press SAVE when it is ready.
Before sending a Template Message to a contact at Alexa360 platform, please ensure that the template message is approved
From Settings Module, navigate to the menu item, Channels
Once you have located the WhatsApp Cloud API channel, press Templates
Press Sync Templates to begin the syncing process.
When the synchronization has completed, the message templates will be listed with their corresponding status and last synced date time will be updated. Rejection reason will be displayed underneath the rejected message template.
Status
Description
Submitted
The message template is submitted and pending for approval.
Approved
The message template is approved and can be sent to contacts.
Rejected
The message template is rejected and cannot be used.
You may use the search and filter at the top right corner of listing to find your templates easier!
From Settings Module, navigate to the menu item, Channels
Once you have located the WhatsApp Cloud API channel, press Templates
Press Submit Template to submit a Message Template for approval
Fill in the information needed to create a new template
Field
Description
Name
Name can only contain lowercase alphanumeric characters and underscores ( _ )
Category
The category of which the message template belongs to.
Language
The language that the template is written in.
Build the message by filling in the necessary components and check out the message on the preview section.
Building Block
Description
Header
The Header is optional and serves as the title or header of your template. It supports the following:
Text
Image
Video
Document
*Alexa360 Platform accepts uploads up to 20MB in size
Body
The Body should contain the most important text of your template. Only text is supported.
You may use markdown to format the content of this block
Footer
The Footer only supports text and can be used to provide less relevant information in your template message
Button
The button adds interactivity to your templates. There are two main types.
Quick Reply Button
Used for getting quick answers from your client
Max 3 Quick Reply Buttons per Template
Each Quick Reply cannot have more than 20 characters
Call to Action Button
Used to send your client to a website or call a Phone Number
Max one URL and Phone Number per Template
URL can have a parameter for personalization
This is only applicable if you have included any parameters in your message template content.
This can happen when message webhook is not subscribed.
Open the Facebook App and navigate to the Webhooks page.
Select Whatsapp Business Account and verify if messages event is subscribed.
Send a test message to the WhatsApp phone number and check if it arrived.
Occasionally, when the user who connected WhatsApp Cloud API changes their Facebook password and permission will be outdated. Permissions will need to be refreshed.
From Settings Module, navigate to the menu item, Channels
Once you have located the WhatsApp Cloud API Messenger channel, press Troubleshoot
Press Refresh Permission to refresh WhatsApp permissions.
Send a test message to the WhatsApp phone number and check if it arrived.
This can happen when contact has not agreed to WhatsApp terms and privacy policy
If your contacts cannot receive message from your WhatsApp Cloud API number, make sure that they have agreed to the latest WhatsApp terms and privacy policy.
If the number is already being used in the WhatsApp customer or business app, you will have to delete your account on the WhatsApp customer or business app.
The Phone number used for WhatsApp Cloud API can’t be used in the WhatsApp customer or business app.
You can still use the number for everyday purposes, such as calling and receiving messages after registering it on the WhatsApp Business Platform.
Once you use a phone for WhatsApp Cloud API you can no longer use that number on the WhatsApp Business App.
It isn’t mandatory to complete Facebook business verification to start sending messages on WhatsApp. Without business verification, your business will still be able to
Respond to unlimited customer-initiated conversations.
Send business-initiated conversations (template messages) to 50 unique customers in a rolling 24-hour period. You will need to complete business verification if you want to initiate more than 50 business-initiated conversations in a rolling 24-hour period.
Businesses can initiate Business Verification (BV) only when they are ready to scale business-initiated conversations or want to become an Official Business Account.
WhatsApp Business Platform conversations fall into two categories that are priced differently:
All conversations are measured in fixed 24-hour sessions. A conversation starts when the first business message in a conversation is delivered, either initiated by the business or in reply to a user message. Businesses and users can exchange any number of messages, including template messages, within a 24 hour conversation session without incurring additional charges. Each 24 hour conversation session results in a single charge.
You may use to fill in the message template parameter.
Yes, you can monitor your messaging and spending analytics in real-time for your WhatsApp business account in the Insights tab of your Meta WhatsApp Manager. Read more .
Messaging limits determine the maximum number of business-initiated conversations each phone number can start in a rolling 24-hour period. These limits do not apply to user-initiated conversations. A business-initiated conversation starts when the first message is delivered to a customer and ends 24 hours later. Read more .
Your first 1,000 conversations each month are free. If you want to exceed the free tier of 1,000 conversations per month, you need to add a payment method to your WhatsApp Business account in Business Manager. You can learn more
User-initiated: A conversation that initiates in response to a user message. Whenever a business replies to a user within the 24 hour , that message will be associated with a user-initiated conversation. Businesses can send free-form messages within this 24 hour customer service window.
Business-initiated: A conversation that initiates from a business sending a user a message outside the 24 hour customer service window. Messages that initiate a business-initiated conversation will require a .
Charges for conversations are based on the user’s country code. A user here is defined as the customer that your business is communicating with. Rates for business-initiated and user-initiated conversations vary by country or region. Read more
There are a few requirement and steps needed to delete a phone number, read more
