v3 SMS SMPP
Receiving MO Messages
To receive Mobile Originated (MO) messages, your account must have one of the following types of numbers provisioned:
- Short code (national)
- Long code or VMN
- Landline (US and Canada only)
- Toll-free number (US and Canada only)
End users in regions that support short codes (such as the US, Canada, and the UK) can text into national short codes. They cannot text into a short code that’s provisioned for another region. For all other types of numbers, end users can generally text into these regardless of region. However, if they are sending to another region (e.g. UK to US) they may incur additional charges, or international messaging may be blocked by their mobile operator.
Note that mobile operators cannot route messages to alphanumeric codes (nor do mobile phones generally allow this).
When receiving MO messages, the required parameters described in the following table are sent via a deliver_sm protocol data unit (PDU).
OpenMarket SMPP includes custom TLVs and, in particular, MO messages include the Carrier ID custom TLV. For more information about our custom TLVs, see TLVs returned with MO messages.
|
Parameter |
Description |
|---|---|
|
Source TON |
Indicates the type of number (TON); this value is set to international. Value: 0x01 (hex) |
|
Source NPI |
Indicates the address format of the phone number (Number Plan Indicator); this value is set to ISDN/E.164. Value: 0x01 (hex) |
|
Source Address |
Indicates the E.164 formatted address (phone number) of the originator. Value: maximum 20 digits (C Octet String) |
|
Destination TON |
Indicates the destination address type of number (TON); the value is set to network specific (0x03) for short codes or international (0x01) for virtual mobile numbers (VMN). Value: 0x01, 0x03 |
|
Destination NPI |
Indicates the destination numbering plan indicator (NPI); this value is set to unknown. Value: 0x00 (hex) |
|
Destination Address |
Your assigned short code or VMN. Value: maximum 20 digits (C Octet String) |
|
Receipted Message ID |
Contains the OpenMarket ticket ID of the MO. Value: 1-65 (C Octet String) |