We offer SMPP connection for select customers. Contact firstname.lastname@example.org to get access. We use SMPP version 3.4, which should be backwards compatible with version 3.3.
Use the following to connect. We recommend to connect to two hosts. When we do maintainence, only one host is restarted at a time. By keeping a connection to two hosts, constant connectivity can be achieved.
You can connect as a transceiver/receiver more than once. Delivery reports will be distributed evenly among your binds, each report only through one bind.
We regurlarily deploy improvements to the SMPP software, so you may experience a session being disconnected, but you can reconnect immediately. As long as your client can reconnect automatically, no downtime or sevice disruption will occur.
|Bind type||Transceiver or transmitter and receiver.|
|Enquire link||Every 30 seconds|
|Reconnect delay||30 seconds|
|System type||Not required|
Supported SMPP commands¶
The following commands are supported
We currently do not support Schedule Delivery Time on submit_sm.
Only TON values of 0 and 1 are supported for destination address. 0 will be interpreted as 1.
Connect with at least one transceiver or receiver to receive delivery reports. A maximum of 25.000 unacknowledged reports will be kept for 48 hours.
The order of the delivery reports are not guaranteed, so in some cases, you may get an ENROUTE before a DELIVRD.
The delivery report format is as in the following examples:
id:1390125333 sub:001 dlvrd:000 submit date:2011181054 done date:2011181054 stat:DELIVRD err:000 text:user_message_reference id:1390125333 sub:001 dlvrd:000 submit date:2011181145 done date:2011181145 stat:UNDELIV err:019 text:user_message_reference
The fields sub and dlvrd can be ignored.
The text is the first 20 characters of the user_message_reference TLV if submitted with submit_sm. The full reference is added in the TLV as well.
The err field is a base 10 representation of our error codes listed in SMS Errors. Since we only have three digits available we take a SMS error code like 0x107E, keep the 07E and format in base 10 to 126. If you need to convert back, simply add 0x1000 to the SMPP error code, and format as hex.
The stat field is the following status types:
Following DCS values are supported
|0||IA5 / GSM7|
|3||Latin1 / ISO-8859-1|
We support the following common TLV fields for submit_sm as well as one our own custom for use with message classes.
|0x0005||dest_addr_subunit||1 byte||For “flash” sms|
|0x0204||user_message_reference||2 bytes||User assigned reference for delivery reports|
|0x0424||message_payload||1 byte||For sending messages longer than 255 octets|
|0x2900||message_class||octetstring||To send with a specific GatewayAPI messageclass|