How do I configure my SMPP connection for Bandwidth gateways?

Follow

Chase Greiser

Updated

What is SMPP?

Short Message Peer-to-Peer (SMPP) is a protocol for exchanging SMS messages between Short Message Service Centers (SMSCs) and/or External Short Messaging Entities (ESMEs).

How do I connect to Bandwidth’s SMPP platform?

Bandwidth allows you to connect to our SMPP platform as an ESME via Transceiver.

How do I configure my SMPP connection for Bandwidth gateways?

Bandwidth uses SMPP v.3.4 Protocol, an open-source flexible data communication interface used for the transfer of short message data. Please refer to this document for SMPP specifications.

If you haven’t already established your own SMS gateway, we recommend using Kannel, which is a compact open-source WAP and SMS gateway.

Note: Please review Sample: Basic Kannel SMSC connection section below for gateway IPs.

Example connection configurations

Sample: Basic Kannel SMSC connection

Connection 1

group = smsc
smsc = smpp
smsc-id = <user determined>
host = 67.231.1.30
port = 2775
smsc-username=<Provided System ID>
smsc-password=<Provided Password>
system-type=SMPP
transceiver-mode=true
dest-addr-ton=1  
dest-addr-npi=1

Connection 2

group = smsc
smsc = smpp
smsc-id = <user determined>
host = 67.231.4.201
port = 2775
smsc-username=<Provided System ID>
smsc-password=<Provided Password>
system-type=SMPP
transceiver-mode=true

Sample SMS Box Configuration  

group = smsbox
bearerbox-host = 127.0.0.1
sendsms-port = 13013
sendsms-chars = “0123456789 +-”

Sample Send SMS-User Configuration

group = sendsms-user
username = tester
password = foobar
default-sender=+1234567890
concatenation =true
max-messages=5

Does Bandwidth support DNS?

No, Bandwidth doesn’t currently support DNS names for inbound messaging.

What type of source_addr_ton can I send to Bandwidth?

The following are supported:

  • 0 – Automatic      
  • 1 – International      
  • 2 – National           

If you send Bandwidth source_addr_ton = 1 or 2, Bandwidth will send the same source_addr_ton to our upstream provider. If 0 is sent, we'll autodetect what format is being sent in and send that to our upstream provider.

Can I have multiple binds to the same Data-center from one IP?

The default is 1 bind, but we can support between 1-10 binds per IP. Each request for additional binds must be reviewed, similar to a request for an increase in MPS. If you'd like to increase the number of binds on your account, please open a ticket with your Bandwidth Support Team indicating how many max connections you'd like configured. If approved, you must use a different port on your server for each bind; however, you'll use the same bandwidth IP and port for all connections on the Bandwidth SMSC.

When sending concatenated messages, can I send different parts of the messages to different data centers?

No, when sending concatenated messages you must send all parts of the message to the same data center over the same bind. For more information on concatenation, check out this support article.

Questions? Please open a ticket with your Bandwidth Support Team or hit us up at (855) 864-7776!

Article is closed for comments.