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 customers 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. For a source of SMPP specifications, please refer to this page.

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 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, please refer to our 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.