Ozeki 10 SMS Gateway

Nexmo SMS service provider

The Nexmo SMS service provider allows you to send and receive text and binary SMS messages. You may purchase phone numbers for different countries. Their API is HTTP/HTTPS based. For incoming delivery reports and incoming messages you will need to open a port in your firewall. Ozeki provides the implementation of their API.

How to create a Nexmo account

To use the Nexmo service first of all you need to create a Nexmo account. In the below section we guide you how to do it.

On the main page of Nexmo please click on the 'Sign up' button.

sign up
Figure 1 - Clicking 'Sign up'

Then you need to provide your account details.

provide accouhnt details
Figure 2 - Providing account details

If you are finished then click on 'Sign Up' and wait until Nexmo sends the verification code to your phone.

verify phone number
Figure 3 - Phone number verification

Now check your mail box and verify your E-mail address.

verify e-mail
Figure 4 - E-mail verification

Finally Login to your new Nexmo account.

log in
Figure 5 - Logging in

If everything is fine you will see the 'Getting started' page.

getting started page
Figure 6 - Getting started page

How to setup Ozeki 10 and Nexmo for outbound SMS messages

This chapter provides you detailed information on how to install and configure Nexmo Connection for SMS sending in the Ozeki 10 SMS Gateway software.

At first, please Log in to Ozeki 10 with your username and password.

log in to ozeki 10
Figure 7 - Logging in to Ozeki 10

Then open the 'SMS Gateway' App

open sms gateway
Figure 8 - Opening the SMS Gateway App

Click on 'Add new connection' on the left.

create new connection
Figure 9 - Creating a new connection

Select the 'Nexmo Connection' from the list and click on install next to it.

install nexmo connection
Figure 10 - Installing the Nexmo connection

Provide your Nexmo API credentials and specify telephone number on the Install connection page.

configure nexmo connection
Figure 11 - Providing Nexmo credentials

Now it is time to send a test message (see Figure 12).

sent test message
Figure 12 - Sending a test message

How to setup Ozeki 10 and Nexmo for incoming delivery reports

Before you can receive incoming delivery reports and inbound SMS, you need to forward ports in order to route the external traffic to your network.

1. Open a Web browser and type your Default Gateway number into the address bar then press Enter.

2. Enter your username and password to access the interface of your router. The default username and password should be listed in the documentation of your router or on a sticker on the side of your router. If the default username and password have been changed and you do not remember them, you will need to reset your router.

3. To forward ports on your router, look for a tab or menu named 'Port Forwarding/Port Triggering' or something similar.

4. No matter what type of router or interface you have, you will need to enter the same basic information. Enter the port you want to open under External (Port 1) and Internal (Port 2), or enter a range of ports to open under Start and End.
In this case Ozeki 10 uses port 9505 by default so you may also provide that in the 'Internal' section.

5. Select the Protocol (TCP, UDP, or both).

6. Enter the Private IP address of your PC where your Ozeki 10 installed.

7. Be sure you saved the changes.

prot forwarding
Figure 13 - Port Forwarding

After having the changes saved, please copy the callback URL of the Nexmo connection which you will find on the left.

copying callback url
Figure 14 - Copying the callback URL

Now we will enter the above in the Nexmo settings.

nexmo settings
Figure 15 - Nexmo Settings

Enter your Public IP and the port you forwarded to the Ozeki 10 PC then save them.

nexmo settings
Figure 16 - Nexmo Settings

We are ready to send a Test Message as seen in Figure 17.

send test message
Figure 17 - Sending a test SMS

If you have forwarded the port properly you will see the delivery report received.

delivery report
Figure 18 - Delivery report received

How to buy a Nexmo SMS number

In the below section we will demonstrate how to buy Nexmo number to receive SMS messages.

Please navigate to the 'Buy numbers' menu, select a number and click on the buy button next to it.

select a number
Figure 19 - Selecting a number

After having the number selected, you need to confirm the purchase.

confirm purchase
Figure 20 - Confirming the purchase

In the 'Your numbers' menu you can see your own Nexmo phone numbers.

view your numbers
Figure 21 - Viewing your numbers

How to setup Ozeki 10 and Nexmo for incoming SMS messages

After you have purchased a Nexmo number you can set it up to forward the messages to the Ozeki 10 machine.

In the 'Your Numbers' menu click 'Manage' to edit the number you would like to receive SMS messages to.

edit your numbers
Figure 22 - Editing your number

Copy the callback URL from the Nexmo connection.

copy callback url
Figure 23 - Copying the callback URL

Enter your Public IP and the port you forwarded to the Ozeki 10 PC then click 'Update'.

provide webhook url
Figure 24 - Providing webhook URL

Send a Test Message to this number and you will see the message received in Ozeki 10.

test message received
Figure 25 - Test message received