Vonage WhatsApp
Connecting a Vonage WhatsApp API account to chat with customers over Whatsapp.
Last updated
Connecting a Vonage WhatsApp API account to chat with customers over Whatsapp.
Last updated
In addition to providing SMS services, Vonage is also an API provider that works directly with WhatsApp as an official partner. Vonage also provides other services such as phone number purchases and WhatsApp Official API account management.
By integrating Vonage WhatsApp API, the platform can enable you to respond to WhatsApp messages directly.
This channel has a limited 24-hour messaging window due to WhatsApp regulations.
From Settings Module, navigate to the menu item, Channels
Press Add Channel and choose WhatsApp. Select Vonage on the second step
Sign in with your user credentials at Vonage
Find the API Key and API Secret on the Dashboard and add it to the corresponding fields at Alexa360 platform.
After you have filled in both values, follow through the instructions by pressing NEXT.
Enable Messages by enabling the toggle and select version v1.0
Add the generated URLs from Alexa360 to the corresponding fields at Vonage.
Scroll down and press Generate New Application
Open the Linked External Accounts tab and press Link next to the Nexmo WhatsApp Number.
After you have done the above, follow through the instructions by pressing NEXT.
At Alexa360, select the enabled WhatsApp number from the dropdown.
Press Edit and then press Generate Public and Private Key
Add the Private Key field to the corresponding field at Alexa360 platform
At Vonage, save changes to the dashboard
Press DONE to complete the setup
Once you completed the setup, any messages sent to your Vonage WhatsApp Number will now be received in your Space.
From Settings Module, navigate to the menu item, Channels
Once you have located the Vonage WhatsApp channel, press Configure
You can configure the following:
Channel name - Name used internally to identify the account
WhatsApp Business Account ID - This is required to sync and submit Message Templates. Contact your Vonage Customer Solution Architect to get this credential.
User Access Token - This is required to sync and submit Message Templates. Contact your Vonage Customer Solution Architect to get this credential.
Important: As for the other credentials, please do take extra when updating them as changing these credentials may cause failure in receiving or sending messages from your Vonage WhatsApp account.
Press DONE to update the channel configuration
Before sending a Template Message to a contact at Alexa360 platform, please ensure you did the following:
Submitted the message template for approval
Added the approved message template to Space
Before syncing Template Message at Alexa360 platform, please ensure you did the following : - Added WhatsApp Business Account ID and User Access Token at channel configuration dialog.
From Settings Module, navigate to the menu item, Channels
Once you have located the Vonage WhatsApp channel, press Templates
Press Sync Templates to begin the syncing process
When the synchronisation 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 Vonage WhatsApp 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 in 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
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.
If you are encountering issues sending and receiving messages, we recommend you to check the application version of your Vonage application.
Sign in with your user credentials at Vonage
Navigate to your Application and click on edit. Verify if you have selected v1 and
If you are encountering issues message status is not updated, we recommend you to check the Status URL of your Vonage application.
Sign in with your user credentials at Vonage
Navigate to your Application and click on edit. Verify if your Status URL
At Vonage, navigate to and create an application. Give the application a suitable name.
At Vonage, navigate to and select the WhatsApp application to connect.
You may use to fill in the message template parameter.
Having trouble with the channel? Contact us !
