Receiving messages
Inbound messages will be delivered to your platform as a DELIVER_SM. The table below shows what the PDU looks like for each mobile originated SMS sent to (one of) your short codes or long numbers.
Optionally, MCC and MNC indicators can be submitted for inbound traffic on short codes.
| Parameter | Description |
|---|---|
command_id |
Will always be DELIVER_SM |
service_type |
Will always be 0 |
source_addr_ton |
TON for the source address, will be INTERNATIONAL (1) for all mobile originated messages |
source_addr_npi |
NPI for the source address, will be MSISDN (1) for all mobile originated messages |
source_addr |
Source address - the MSISDN the SMS was sent from |
dest_addr_ton |
TON for the destination address, will be INTERNATIONAL (1) Long numbers and NATIONAL (2) for Short code |
dest_addr_npi |
NPI for the destination address, will always be MSISDN (1) |
destination_addr |
Destination address - the MSISDN the SMS was sent to (your Long Number or Short Code) |
esm_class |
Will always be 0 |
protocol_id |
Will always be 0 |
priority_flag |
Will always be 0 |
schedule_delivery_time |
Will always be 0 |
validity_period |
Will always be 0 |
registered_delivery |
Will always be 0 |
replace_if_present_flag |
Will always be 0 |
data_coding |
Encoding used. Default is GSM-7 (0), UCS-2 for messages containing characters outside GSM-7 (8) |
sm_default_msg_id |
Will always be 0 |
sm_length |
Short Message Length - number of characters in message content |
short_message |
Message content |
MCC + MNC in status reports
Include MCC + MNC information in SMPP delivery receipts as optional parameters. This information, optionally configured per SMPP account, is passed in a vendor-specific TLV (0x1403).
In the value field, you will receive the MCC + MNC of the destination operator.
Examples
Here are a few examples for both long numbers and short codes.
Inbound SMS sent to a long number
| Parameter | Example |
|---|---|
command_id |
DELIVER_SM |
service_type |
0 |
source_addr_ton |
1 |
source_addr_npi |
1 |
source_addr |
46706160585 |
dest_addr_ton |
1 |
dest_addr_npi |
1 |
destination_addr |
46737494630 |
esm_class |
0 |
protocol_id |
0 |
priority_flag |
0 |
schedule_delivery_time |
0 |
validity_period |
0 |
registered_delivery |
0 |
replace_if_present_flag |
0 |
data_coding |
0 |
sm_default_msg_id |
0 |
sm_length |
4 |
short_message |
Test |
Inbound SMS sent to a short code
| Parameter | Example |
|---|---|
command_id |
DELIVER_SM |
service_type |
0 |
source_addr_ton |
1 |
source_addr_npi |
1 |
source_addr |
46706160585 |
dest_addr_ton |
2 |
dest_addr_npi |
1 |
destination_addr |
71630 |
esm_class |
0 |
protocol_id |
0 |
priority_flag |
0 |
schedule_delivery_time |
0 |
validity_period |
0 |
registered_delivery |
0 |
replace_if_present_flag |
0 |
data_coding |
0 |
sm_default_msg_id |
0 |
sm_length |
4 |
short_message |
Test |
Additional resources
- SMPP Connectivity
- Prefer a REST API? Get started with the REST SMS API .
