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

Objective

Connecting Google RCS to Jumper.ai (Manual Method)

Applies To

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

Prerequisites

• Have an account within the Vonage API dashboard.
• Have an account within Jumper.ai.
• For the Google RCS onboarding process, refer to Setting up a RBM Agent for RCS Messaging or please reach out to your Account manager, Customer Solution Architect (CSA), or Partner Manager.
• Have Google RCS connected under the Vonage API dashboard.

Note

• Jumper leverages Vonage Messages APIs for RCS. Refer here to understand RCS, coverage, rate limits, and other technical specifications.
• Find FAQs about Rich Communication Services (RCS) here.

Procedure

The following topics will be covered:

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

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

   B. 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.

   C. 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.

   D. 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 RCS agent 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 Google RCS channel within Jumper.ai

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

1. Navigate to Channels  → Google RCS 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
   
   
   
    

   S.No	Information Required	Where to find them
   1	RCS Agent Name	Vonage API Dashboard → BUILD → Applications → Link External Accounts
   2	API Key	Vonage API dashboard → API Settings
   3	API Secret	Vonage API dashboard → API Settings
   4	Application ID	Vonage API Dashboard → BUILD → Applications
   5	Application Name	Vonage API Dashboard → BUILD → Applications
   6	Private Key	Vonage API Dashboard → BUILD → Applications

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, & RCS Agent Name: On your Vonage API Dashboard, navigate to the BUILD  → Applications → Select your application

Private Key: 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 Google RCS channel is connected successfully, it will show under Channels → Google RCS.

When the connection is 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 RCS 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 update the private key instead of simply 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.