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)