Local Mail Docs
  • Overview
  • Reference
    • Common Error Codes
  • ℹ️Localmail Insights - Lookup
    • Email Lookup Service
    • Phone Number Lookup Service
    • IP Lookup Service
  • Messaging
    • Learn more about SMS
      • SMS Character Limit
      • UCS-2
      • GSM-7
      • Alphanumeric Sender ID prefixes for SMS
      • support for International Alphanumeric Sender ID
    • SMPP Specification
      • Submitting Messages Through SMPP
      • TLV Configuration for SMPP DLT Implementation
      • SMPP error codes
  • Voice
    • Porting Number Into Local Mail
  • Regulations
    • DLT Guide - India
      • DLT Template Registration Process
      • Content template creation guidelines
      • Consent and Content Templates Registration
      • Letter of Authorization (LOA) for DLT?
      • Sending messages on behalf of another company?
      • Frequenty Asked Questions
  • Legal
    • Vulnerability Reporting
    • Terms of Service
    • Privacy Policy
Powered by GitBook
On this page
  • GSM-7 Encoding Quirks
  • How Localmail Encodes Your Messages
  • Need More Help?

Was this helpful?

  1. Messaging
  2. Learn more about SMS

GSM-7

PreviousUCS-2NextAlphanumeric Sender ID prefixes for SMS

Last updated 3 years ago

Was this helpful?

GSM-7 is a character encoding standard which packs the most commonly used letters and symbols in many languages into 7 bits each for usage on GSM networks. As SMS messages are transmitted 140 8-bit octets at a time, GSM-7 encoded SMS messages can carry up to 160 characters.

GSM-7 Encoding Quirks

GSM-7 is the standard alphabet for SMS messages, written up in the standard . It is always supported on networks. In languages with more than 128 commonly used symbols, GSM-7 is mandated. However, local language support is implemented with shift tables or by changing text encoding to (16-bit) encoding.

The basic character set for GSM-7 .

For some characters, such as '{' and ']', an escape code is required - so even in a GSM-7 encoded message these characters will be encoded using two characters.

SMS messages contain 140 8-bit octets, so up to 160 GSM-7 characters may be transmitted: (140*8)/7 = 160.

How Localmail Encodes Your Messages

When sending SMS messages with Localmail, we'll automatically send messages in the most compact encoding possible. If you include any non GSM-7 characters in your message body, we will automatically fall back to encoding (which will limit message bodies to 70 characters each).

Additionally, for long messages--greater than 160 GSM-7 characters or 70 UCS-2 characters--Localmail will split the message into multiple segments. Localmail also prepends a of six (6) Bytes to instruct the receiving device on how to re-assemble messages. For multi-segment messages, this leaves 153 GSM-7 characters or 67 UCS-2 characters per segment.

Note that this may cause more message segments to be sent than you expect - a body with 152 GSM-7-compatible characters and a single unicode character will be split into three (3) messages because the unicode character changes the encoding into less-compact UCS-2. This will incur charges for three outgoing messages against your account.

How Do I Check if My Message Can Be Encoded in GSM-7?

contains an interactive tool which can check if encoding your message in GSM-7 is possible, or if UCS-2 is needed.

How Can I Avoid My Messages Being Split When I Expect Them to be in GSM-7?

Unfortunately, GSM-7 is not a supported character encoding in many text editors. Even setting encoding to ASCII (or US_ASCII, or UTF-8) will not guarantee that text you write will be limited to GSM-7. You can use the to quickly check the number of segments - that is, total messages - some text will be divided into.

If you are writing in an editor with Unicode support you'll need to be particularly careful. Text editors designed for writing might automatically add angled smart quotes, non-standard spaces, or punctuation which looks similar to GSM-7 but is a different Unicode character.

Need More Help?

If you need any further Help During your Integration or questions related to technical know-how, you can reach out to our support team at support@localmail.io

GSM 03.38
GSM
UCS-2
can be found here
UCS-2
User Data Header
This page
linked tool