Nexmo (SMS)

Connecting Rocketbots to SMS messaging via Nexmo.

Owned by Vonage, Nexmo allows you to programmatically send and receive SMS in practically every country through their API.

The Nexmo Logo

For a detailed list of features against the other channels, you can take a look at the comparison table.

Setting Up Nexmo

In order to connect Nexmo to your Space, you will need the following:

Purchasing a Virtual Number

Note that you will have to upgrade to a paid Nexmo account in order to purchase a Virtual Number.

Navigate to the Nexmo Developer Dashboard. If you are not already signed in, you may have to log in with your Nexmo account first.

Under the Numbers section of the sidebar, select "Buy numbers".

Buying a Virtual Number on Nexmo

In the search fields, select the options that you need. Note that you may want to pick a country where most of your contacts will be located. Be sure that your number will be able to support SMS.

Once you have completed the fields, press the blue "Search" button. Nexmo will display a list of available virtual phone numbers based on your criteria.

Choosing a Virtual Number

From the list of numbers, find one to your liking and press its respective orange "Buy" button and validate your purchase. A new dialog should open asking you to confirm your purchase.

The Confirm Purchase Dialog

Confirm the purchase of your virtual phone number by pressing the orange "Buy" button.

Your virtual phone number most have SMS compatibility to work with Rocketbots.

Connecting to Nexmo

To add a new channel to an existing Space, navigate to Settings and select the blue "Add Channel" button under Channel Settings.

Under the Channel Connection menu, select the Nexmo logo and press the blue "Next" button.

Once you have done so, you should be asked for the Channel Name, Greeting Message, and other fields specific to Nexmo.

Connecting to Nexmo on the Rocketbots Platform

Enter a suitable name for the new channel. Note that the Channel Name is private and will only be used within the Rocketbots Platform.

You may enter an optional Greeting Message. This will be shown when a new member of your audience first contacts you.

Nexmo Phone Number

In the Nexmo Phone Number field, enter the virtual phone number that you purchased from Nexmo.

If you do not remember the number, you can navigate to the Your Numbers page under the Numbers section on the sidebar of Nexmo.

Your Numbers Page on Nexmo

On the Your Numbers page, you can find a list of all of your virtual numbers.

API Key and Secret

On the Nexmo Dashboard, navigate to the Settings page. Under your account section, select "Settings".

The Settings page on Nexmo

On the Nexmo Settings page, you can find the API Key and the API secret. Copy these and paste them into their respective fields on the Rocketbots Platform.

Connecting to the Platform

Once you have filled in the fields on the Rocketbots Platform, you will have to paste the Webhook URL into Nexmo.

Go back to the Your Numbers page on Nexmo. Find the virtual phone that you are connecting to Rocketbots and press its configure button under the "Manage" column. Look for the button with the cog icon.

The Configure Number Dialog on Nexmo

Paste the Webhook URL from the Rocketbots Platform into the SMS "Inbound Webhook URL" field.

Once you have done so, press the blue "Ok" button.

Return to the Rocketbots Platform and press the blue "Done" button. Your Space will now be connected to your Nexmo virtual phone!

All future SMS messages sent to your virtual phone number will appear on the Rocketbots Platform.