SMPP Connectivity Bulk SMS API Documentation

SMPP Connectivity

Introduction General

The Short Message Peer-to-Peer (SMPP) is an open, industry standard protocol used by the telecommunication industry for exchanging SMS messages between Short Message Service Center (SMSC) and SMS application systems.

The protocol is a level-7 TCP/IP protocol, which allows fast delivery of SMS messages.

The connection between the application and the SMSGatewayCenter Enterprise Messaging Gateway SMPP Server is SMPP version 3.4.

Purpose

This SMPP Interface document shall help understand the settings and and needs to establish SMS connection between SMSGatewayCenter Enterprise Messaging Gateway and customer.

We assume a level of close acquaintance with SMPP Protocol functionality and required to follow the SMPP 3.4 specification.

If you require further assistance, please do not hesitate to contact your Sales/Project Manager.

Objective

This document is meant to outline the requirements from the service provider/mobile operator technical connectivity of SMS to the SMSGatewayCenter Enterprise Messaging Gateway system. This connectivity is used receiving SMS messages from the client to the SMSGatewayCenter Enterprise Messaging Gateway system.

The connection settings explained here are based on connectivity using the SMPP protocol.

Please note that connectivity using other protocols is possible as well - for further assistance please contact your sales/project manager.

 

SMPP Illustration between SMSC and EMSE

 

Glossary

Name Value
SMPP Short Message Peer to Peer Protocol
SMSC Short Message Service Center
ESME External Short Message Entity
PDU Protocol Data Unit

Connecting to SGC EMG SMPP Service

SMPP Parameters

Name Description
system_id Required. Configured on our platform.
password Required. Configured on our platform.
IP address Will be given by your Sales/Project ManagerWill be given by your Sales/Project Manager
Port Will be given by your Sales/Project Manager
Timeout (Keep Alive) 30 Seconds (Recommended)

Important: You are allowed to bind as transmitter, receiver or transceiver. In order to receive delivery reports, you must bind as transceiver or receiver.

You’ll receive delivery reports only if your route provides delivery reporting. Delivery reports will be sent equally over all of your currently available sessions capable of receiving them (transceiver or receiver).

By default, you are allowed to bind with 5 sessions. There are no other throughput (TPS) limitations besides internet speed.

PDUs Supported

  • bind_transmitter
  • bind_receiver
  • bind_transceiver
  • unbind
  • submit_sm
  • deliver_sm
  • enquire_link

Delivery Report Format

id:7563423917286768871 sub:001 dlvrd:001 submit date:1812272114 done date:1812272114 stat:DELIVRD err:000 text:Hello World, this is a test message.

Delivery Statuses (message_stat)

  • Delivrd
  • Expired
  • Undeliv
  • Acceptd
  • Unknown
  • Rejectd

Data Coding Scheme

Name Value
DCS 01
DCS 02
Default GSM7 Encoding (SMSC Default Alphabet or IA5)
DCS 08 Unicode (UCS2 (ISO/IEC-10646))

SMPP Command Status and GSM Error Codes

Name Description
Invalid System ID 0x0000000F
Invalid Password 0x0000000E
Invalid Source Address 0x0000000A
Session Exceeded 0x00000005
ESME has exceeded allowed message limits 0x00000058
Error in the optional part of the PDU Body 0x000000C0

GSM Error Codes

The list of GSM Error codes are same as Delivery Error Codes which has mentioned on the API Documentation site here.

Send a Message:

Messages should be sent with submit_sm, using either the short_message or message_payload fields.

The above flow chart illustrates a typical SMPP request/response sequence between an SMSC and an ESME bound as a Transmitter.

Download SMPP Interface Manual

Save this Page on your Favorite Social Media