Connecting SMS to Conversational Connect (Jumper.ai) - Manual Method

Objective

Connecting SMS to Conversational Connect (Jumper.ai)

Applies To

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

Prerequisites:

Before connecting your SMS  to the Jumper.ai Dashboard, you will need the following:

• You must have access to your business Vonage Account via the Vonage API Dashboard 
• Log in to your Vonage API dashboard, navigate to API Settings, and select Messages API under SMS settings.
  
  

Note:

• Jumper leverages Vonage Messages APIs for SMS. Refer here to understand SMS, coverage, rate limits, and other technical specifications.
• You can find the frequently asked questions about SMS here.

Procedure

The following topics will be covered:

• Creating an Application under Vonage API Dashboard
• Connecting the SMS 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:

   1. Inbound URL: http://example.com/inbound
   2. 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 Numbers tab. Identify the Number 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 SMS channel within Jumper.ai

To connect your SMS application to Jumper, follow the steps below:

1. Navigate to Channels  → SMS in the menu.
   
   
    
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 ID, Application Name:  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 SMS channel is connected successfully, it will show under Channels → SMS

After the connection has been established, send one outbound 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 SMS 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.
   
   
   
   In case you want to use Sender IDs, Jumper allows you to connect up to 30 Sender IDs without needing to integrate multiple applications. This can be configured based on your business requirements. You can read more about Sender Identity guidelines here