Essentials
API Essentials
National language shift

National language shift

Along with the standard features of SMPP 3.4, we also provide National Language Shift functionality, which enables you to use special characters from language-specific character sets. In addition to SMPP, national language shift functionality is also available over Broadcast and HTTP API.

National Language Shift Tables are character sets that are customized for specific characters according to the language. The following tables show list of supported languages.

Using the extended character sets, you can send messages with language-specific special characters at the same price as standard GSM-7 messages. As an example, Turkish locking shift characters like ğ, Ğ, are then at the cost of a single GSM-7 character⁠ - there is no need for Unicode messages that would limit the total message amount down to 70 characters. Using the User Data Header (UDH) we only reduce the message to 155 characters (since UDH takes up additional space in the message payload).

When a single shift of a particular character set is used, each extended letter will take up double space because an invisible space character has to be used to access the shift table.

For example, when using Spanish NLI Ú is only accessible in the single shift character set extension, which requires the use of an escape character. With each new single shift character introduced, the message length reduces by 1 respectively. This means in case there are 3 single shift characters, the default limit of 155 characters per NLI message is reduced to 152.

Example:

1B55 (1B is the escape character, 55 is Ú that is used from the extended character set)

Language selection is possible by using language identifiers within the UDH part of the message payload. The IEI (Information-Element-Identifier) specifies whether the single or locking shift will be used.

  • ESM class parameter, in this case, must be defined to 64.
  • Data coding values that can be used are 0 or 1.

Locking Shift example UDH

UDH Length

IEI (Information Element Identifier)

IE Length

Selected shift

03250101
Remaining UDH length in bytesNational Language Locking Shift Locking Shift - Turkish

Single Shift example UDH

UDH Length

IEI (Information Element Identifier)

IE Length

Selected shift

03240102
Remaining UDH length in bytesNational Language Single Shift Single Shift - Spanish

UDH Identifier reference

Below is a UDH reference for each language and here is a detailed character set reference for GSM 7 (opens in a new tab).

Language

Single Shift

Locking Shift

UDH Identifier

ReservedBasicBasic0x00
TurkishTurkishTurkish0x01
SpanishBasicSpanish0x02
PortuguesePortuguesePortuguese0x03
BengaliBengaliBengali0x04
GujaratiGujaratiGujarati0x05
HindiHindiHindi0x06
KannadaKannadaKannada0x07
MalayalamMalayalamMalayalam0x08
OriyaOriyaOriya0x09
PunjabiPunjabiPunjabi0x0A
TamilTamilTamil0x0B
TeluguTeluguTelugu0x0C
UrduUrduUrdu0x0D

Need assistance

Explore Infobip tutorials

Encountering issues

Contact our support

What's new? Check out

Release notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Service Terms & ConditionsPrivacy policyTerms of use