Restcomm comes with SMPP integration that allows sending messages from multiple SMPP endpoints. This tutorial will explain how to connect Restcomm SMPP to Nexmo. You can also connect Restcomm to any SMPP endpoint, for example, by using the Telscale SMSC gateway.


  • Latest version of Restcomm

  • Nexmo Account

Step 1 - Get Nexmo Account Details

Go into your Nexmo account dashboard and get the following data

  • In the screenshot below, you need the

  • Callback System-type = text


You also need the API Settings

  • Key :

  • Secret :


You also need to get the Nexmo gateway and the port as explained HERE  

Step 2 - Configure Restcomm to Use SMPP

Edit the file  $RESTCOMM_HOME/bin/restcomm/smpp.conf You must set the SMPP_ACTIVATE variable to true for SMPP to be activated

# Connection details for SMPP Restcomm integration
SMPP_ACTIVATE='true'            #default SMPP activate is always false. Set to true to activate SMPP
SMPP_SYSTEM_TYPE='xxxxxxx'  #This is required when working with Nexmo for inbound SMS
SMPP_PEER_IP='xxxxxxxx'  #use IP or DNS name of peer SMPP server

Step 3 - Configure Restcomm IP and Required Features

The next step is to configure the IP address and other features required to start Restcomm as explained Starting Restcomm-Connect.

If SMPP is correctly started, you should see an output similar to the one below in the console.

08:19:22,697 INFO  [org.restcomm.connect.smpp.SmppClientOpsThread] (Thread-602) SmppClientOpsThread started.
08:19:22,697 INFO  [org.restcomm.connect.smpp.SmppService] ( SMPP Service started
08:19:22,796 INFO  [] (Controller Boot Thread) JBAS015961: Http management interface listening on
08:19:22,797 INFO  [] (Controller Boot Thread) JBAS015951: Admin console listening on
08:19:22,797 INFO  [] (Controller Boot Thread) JBAS015874: JBoss AS 7.2.0.Final "Janus" started in 10923ms - Started 477 of 557 services (79 services are passive or on-demand)

Step 4 - Start Restcomm and Send inbound Messages

  • Start Restcomm and make sure SMPP is correctly bound to Nexmo

  • Create a new SMS RVD Application that will receive incoming SMS from Nexmo

  • Attach your Nexmo Number to the application (See below)


  • See the screenshot below (The number below is the one to attach to your RVD application)


  • Send an SMS message to the Number registered in your Nexmo Dashboard.

  • The Nexmo Callback System-type setting lets Nexmo know that the message should be sent to this particular instance of Restcomm

Step 5 - Send Outbound SMS through Nexmo SMPP

To send an outbound message through Restcomm SMPP endpoint, you must specify the DID using as SIP phone or you can also build an app using Restcomm Visual Designer.

Restcomm will check to see if there is a local application attached to that number. If there is none, the message will be forwarded through the SMPP connection to the provider, in this case, NEXMO.

Example, if you want to send an SMS to the number 3399999999, you send it to 3399999999@RESTCOMM_IP:5080

See screenshot below: