Connecting WhatsApp to Conversational Connect (Jumper.ai) Dashboard via Vonage API Dashboard - Manual Method

Objective

Connecting Vonage’s WhatsApp Business Account to Jumper.ai Dashboard (via Vonage API Dashboard) - Manual Method

Applies To

• Conversational Connect (Jumper.ai)
• WhatsApp
• Channel
• Connection

Prerequisites

Before connecting your WhatsApp Business Account to Jumper.ai Dashboard, you will need the following:

• You must have access to your business Vonage Account, via the Vonage API Dashboard Vonage API Dashboard
• If you are a direct customer, i.e. you will be using WhatsApp for your own business’s usage, then you should complete the creation of the WhatsApp Business Account (WABA) using Embedded sign-up.
• If you are creating a WhatsApp Account on behalf of another business, for example as a Partner or Billing Agent, you’ll need to use Managed Onboarding Process and kick start by completing Vonage’s Application Form.
• If you get stuck at any point during the WABA onboarding process, please reach out to your Account manager, Customer Solution Architect (CSA), or Partner Manager.
• You will need to create an application on the Vonage API Dashboard after the above WABA onboarding process is completed and WhatsApp Business Account is connected to your Vonage API account and linked with the Phone Number.

Note:

• Jumper leverages Vonage Messages APIs for WhatsApp. Refer here to understand WhatsApp, coverage, rate limits, and other technical specifications.
• Find FAQs about WhatsApp here. 

Procedure

The following topics will be covered:

• Creating an Application under Vonage API Dashboard
• Connecting the WhatsApp channel within Jumper.ai
• Disconnecting the Channel or Updating the Private Key

Creating an Application under Vonage API Dashboard

1. Log in to your Vonage API dashboard, navigate to Applications, and click on + Create a new application.
   
   
    

2. Create and Configure the Application

   Name Your Application
   Choose a name for your application that reflects your business or use case.

   Generate Keys
   Click on Generate Public and Private Key.

   This will download a Private Key file.

   Important Note: Save this file securely. You will need it later when connecting to the Jumper.ai dashboard.

   Enable Messages Capabilities
   In the Messages Capabilities section:

   Toggle Messages to ON.

   Add the following placeholder URLs:
   Inbound URL: http://example.com/inbound

   Status URL: http://example.com/status
   Note: These URLs are temporary and will be automatically replaced by Jumper.ai after connection.

   Generate Application
   Click on Generate New Application to complete the setup.

   

3. Once the application is created, go to the Link External Accounts tab. Identify the WhatsApp Business account that you want to link to this application, and click on the Link option to complete the connection.

   

   4. Once linked, the application status will be updated to Linked to this application.
    

   

Connecting the WhatsApp channel within Jumper.ai

1. To connect your WhatsApp application to Jumper, follow the steps below:
   
   Navigate to Channels  → WhatsApp in the menu, select the Manual Setup option, and click Next
    
   
    
2. Fill in the required details in the connection form and click submit to establish the connection
   
   
    

Instructions to find the required information 

API Key & API Secret: You can locate your API Key and API Secret under the API settings page of your Vonage API dashboard.

Please note: For security reasons, the API Secret can no longer be copied or viewed. If you have forgotten the API Secret provided when creating your Vonage API Dashboard account, you can generate a new API Secret and use the new one.



Application Name, Application ID, WABA ID and Phone Number  : On your Vonage API Dashboard, navigate to the BUILD  → Applications → Select your application



Private Key: Kindly use the private key extracted from the downloaded file while creating the application within the Vonage API Dashboard. Make sure to copy the entire private key, including the lines that say Begin Private Key and  End Private Key.



Once your WhatsApp channel is connected successfully, it will show under Channels → WhatsApp


After the connection has been established, send one outbound and one inbound test message to ensure the connection is working properly and that messages are being sent and received successfully, before proceeding with bulk messaging.

Disconnecting the Channel or Updating the Private Key

1. To disconnect or to connect a new WhatsApp application, simply click on the Disconnect option & reconnect to the new application.
   
   
   
   Note: If you disconnect, all existing associations with customers, broadcasts, and bot builders will be lost. Therefore, exercise caution before disconnecting.  If there are no other changes, it is recommended to simply update the private key instead of disconnecting. 

2.  Updating the Private Key: If you’ve made any configuration changes to the application and are unable to send or receive messages, try updating the private key to restore connectivity instead of disconnecting completely and reconnecting again.

SMS FAILOVER

Failover refers to the capability to switch to an alternate communication channel when the primary channel cannot deliver a message.

Jumper.ai supports an SMS Failover mechanism. If you wish to use this feature, please enable and connect the SMS channel. Click here to learn more about connecting the SMS sales channel.

Note: If the SMS channel is unavailable under the Jumper.ai account, connect with your Account Manager to enable the SMS channel as per your plan.