Vonage WhatsApp

Connecting a Vonage WhatsApp API account to chat with customers over Whatsapp.

To connect Vonage WhatsApp, a Vonage WhatsApp API account is required. Read our guide to create a Vonage WhatsApp API account.

Vonage

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. Find out more here!

Connecting Vonage WhatsApp

Step 1: Navigate to Channel Settings From Settings Module, navigate to the menu item, Channels

Step 2: Add Channel Press Add Channel and choose WhatsApp. Select Vonage on the second step

Step 3: Sign in to Vonage Sign in with your user credentials at Vonage

Step 4: Locate the API Key & API Secret Find the API Key and API Secret on the Dashboard and add it to the corresponding fields at respond.io platform.

Settings Page on Vonage Dashboard

Step 5: Follow through the instructions After you have filled in both values, follow through the instructions by pressing NEXT.

Step 6: Create an Application At Vonage, navigate to Your Applications and create an application. Give the application a suitable name.

Step 7: Enable Messages Enable Messages by enabling the toggle

Step 8: Add the Generated URLs Add the generated URLs from respond.io to the corresponding fields at Vonage.

Step 9: Generate New Application Scroll down and press Generate New Application

Step 10: Link a Vonage WhatsApp Number Open the Linked External Accounts tab and press Link next to the Nexmo WhatsApp Number.

Step 11: Follow through the instructions After you have done the above, follow through the instructions by pressing NEXT.

Connecting Vonage WhatsApp

Step 12: Select the Enabled WhatsApp Number At respond.io, select the enabled WhatsApp number from the dropdown.

Step 13: Connect the WhatsApp application to respond.io At Vonage, navigate to Applications and select the WhatsApp application to connect.

Step 14: Generate Public and Private Key Press Edit and then press Generate Public and Private Key

Step 15: Add the generated Private Key file Add the Private Key field to the corresponding field at respond.io platform

Step 16: Save changes At Vonage, save changes to the dashboard

Step 17: Complete the setup at respond.io 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.

Channel Configuration

Vonage WhatsApp channel can be configured with a unique: - Channel Name - Greeting Message

Step 1: Navigate to Channel Settings From Settings Module, navigate to the menu item, Channels

Step 2: Locate the Vonage WhatsApp channel Once you have located the Vonage WhatsApp channel, press Configure

Channel Settings

Step 3: Make the necessary configuration You can configure the following:

  • Channel Name - Name used internally to identify the account

  • Greeting Message - This message is the first message sent to contact when they message you through Vonage WhatsApp.

Important: As for the other details, take extra note while updating as it might fail to receive messages from your Vonage WhatsApp account.

Configure Vonage

Step 4: Update the configuration Press DONE to update the channel configuration

Managing WhatsApp Message Templates

Before sending a Template Message to a contact at respond.io platform, please ensure you did the following:

  • Submitted the message template for approval

  • Added the approved message template to space

Submitting Message Template for Approval

If you do not have an approved message template or would like to submit a new message template, please refer to the following guide.

Step 1: Navigate to WhatsApp Manager From Facebook Business Manager, open WhatsApp manager from the drop-down menu.

Step 2: Create Message Template Press on Message Templates tab and press Create Message Template

Detailed instruction for submitting Template Messages for approval are available in the Vonage Documentation.

Adding the Approved WhatsApp Message Template to the Space

Once your Message Template has been approved on Vonage, you may proceed to add the message template on the respond.io platform.

Step 1: Navigate to Channel Settings From Settings Module, navigate to the menu item, Channels

Step 2: Locate the Vonage WhatsApp channel Once you have located the Vonage WhatsApp channel, press Templates

Step 3: Fill in the required information

Fields

Type

Description

Template Name

Text

A name used to identify the template

Template Content

Text

The message template approved by WhatsApp and to be sent to the contact

Namespace

Text

The unique identifier provided by the WhatsApp Partner API

Category

Single select

In which category does this template belong to.

Language

Single select

In which language this template is written in

Step 4: Save changes Review the information and press SAVE when it is ready.

Troubleshooting

Having trouble with the channel? Contact us here!