Concatenation and Encoding

When you send or receive an SMS message you need to be aware of the overall length of the message because it determines whether the message arrives in one piece or is split into two or more messages. The encoding scheme the SMS uses (text or unicode) affects the maximum number of characters that will fit into a single message.

This document covers the following topics:

• Concatentation
• Encoding
  • New Lines
  • GSM character sets
  • Unicode
  • Encoding examples
• Maximum number of characters
• Inbound Messages

Concatenation

If you send a message that contains more than the maximum number of characters per message, Vonage sends a concatenated SMS. A concatenated SMS contains multiple SMS parts that are connected by segmentation information in the User Data Header (UDH).

This segmentation information tells the handset the number of message parts that make up the concatenated SMS and the position of each message part within it. When the handset has received all of the message parts, it presents them to the recipient as a single text.

For more information, the Vonage Knowledgebase has detailed information about Multipart SMS.

Encoding

There are two main types of encoding that the Vonage SMS API supports: text and unicode.

Specify the encoding by setting the type parameter in the request. The encoding you should use depends on the characters that the message contains:

• Set the type parameter to text for messages that only contain characters in the GSM standard and extended character sets.
• Set the type parameter to unicode for messages that contain characters outside of the GSM character sets (such as Chinese, Japanese and Korean characters).

New Lines

To include a new line in your message, you can represent a Line Feed (LF) by using the UTF-8 encoding, which is %0A, in the value for the text property of the request parameters. This will count as a single character with regards to the message character count. For example, the following value for text:

&text=This is one line.%0AThis is another line.

will send a SMS message which looks like this:

This is one line.
This is another line.

GSM character sets

Vonage supports all the standard GSM characters as well as characters from the GSM extended table. Characters from the standard table require 7-bits per character to encode:

! " # $ % ' ( ) * + , - . / : ; < = > ? @ _ ¡ £ ¥ § ¿ & ¤
0 1 2 3 4 5 6 7 8 9
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
a b c d e f g h i j k l m n o p q r s t u v w x y z
Ä Å Æ Ç É Ñ Ø ø Ü ß Ö à ä å æ è é ì ñ ò ö ù ü Δ Φ Γ Λ Ω Π Ψ Σ Θ Ξ

Characters from the extended table require two characters to encode: an ESC character prefix followed by the required character from the extended table:

| ^ € { } [ ] ~ \

Unicode

Languages such as Arabic, Chinese, Korean, Japanese, or Cyrillic alphabet languages require Unicode characters beyond the GSM standard and extended ranges. These characters require 16-bit UCS-2 encoding.

When you set the type parameter to unicode, all characters within the message are encoded using UCS-2, even if they are present in the GSM standard character set.

Encoding examples

Maximum number of characters

The maximum length of a single SMS message is 140 bytes, which equates to 160 standard GSM 7-bit characters or 70 UCS-2 16-bit characters. A message longer than that is split into parts.

If you are sending a message with a type value of text then the following character limits apply:

If you are sending a message with a type of unicode then each character in the message requires two bytes.

Vonage accepts SMS up to 3200 characters long but not all carriers do. It is best practice to ensure that the message does not exceed six SMS parts.

Test your message templates with this tool:

Inbound Messages

Inbound messages comply with the SMS specification. If an SMS sent to your virtual number is longer than the maximum number of characters allowed for a single SMS, you will receive the concatenated message in parts.

However, you can only receive inbound concatenated SMS if the carrier your user is sending through supports them. If the carrier does not support concatenation then a useful workaround is to treat all SMS from the same number within a short time window as concatenated. See the inbound SMS concatenation Knowledge Base article for more information.

See the Inbound SMS concept document for more information about concatenating inbound SMS.

Further Reading

• How long is a single SMS body?