Concatenação e codificação

Ao enviar uma mensagem SMS, é preciso estar atento ao comprimento total da mensagem, pois isso determina se ela chegará inteira ou se será dividida em duas ou mais mensagens. O esquema de codificação utilizado pela SMS (text ou unicode) afeta o número máximo de caracteres que cabem em uma única mensagem. A Messages API detecta automaticamente se há caracteres Unicode na mensagem enviada e utiliza o tipo de codificação adequado de acordo com isso. Essa configuração pode ser substituída por meio de um encoding_type parâmetro no corpo da solicitação.

Este documento aborda os seguintes tópicos:

• Concatenação
• Codificação
  • Novas linhas
  • Conjuntos de caracteres GSM
  • Unicode
  • Exemplos de codificação
• Número máximo de caracteres

Concatenação

Se você enviar uma mensagem que contenha mais do que o número máximo de caracteres por mensagem, a Vonage enviará uma SMS concatenadas. Uma mensagem SMS concatenada contém várias partes de SMS que são conectadas por informações de segmentação no Cabeçalho de Dados do Usuário (UDH).

Essas informações de segmentação indicam ao aparelho celular o número de partes da mensagem que compõem o SMS concatenado e a posição de cada parte da mensagem dentro dele. Quando o aparelho celular recebe todas as partes da mensagem, ele as apresenta ao destinatário como um único texto.

Para mais informações, a Base de Conhecimento da Vonage contém informações detalhadas sobre SMS em várias partes.

Codificação

Existem dois tipos principais de codificação que a Messages API suporta para o envio de SMS: text e unicode. Por padrão, a Messages API detecta automaticamente se há caracteres Unicode no texto e envia a mensagem da forma adequada, seja como SMS de texto ou como SMS Unicode. Você pode substituir esse comportamento definindo explicitamente text ou unicode como o valor para o encoding_type propriedade do opcional sms objeto. A codificação que você deve usar depende dos caracteres que a mensagem contém:

• Defina o type parâmetro para text para mensagens que contenham apenas caracteres na Padrão GSM e conjuntos de caracteres estendidos.
• Defina o type parâmetro para unicode para mensagens que contenham caracteres fora dos conjuntos de caracteres do GSM (como caracteres chineses, japoneses e coreanos).

Novas linhas

Para incluir uma nova linha na sua mensagem, você pode representar um avanço de linha (LF) usando o \n caractere no valor da sequência de caracteres para o text propriedade do corpo JSON. Isso será contabilizado como um único caractere na contagem de caracteres da mensagem. Por exemplo, o valor a seguir para text:

{
  "text": "This is one line.\nThis is another line."
}

enviará uma mensagem SMS com o seguinte formato:

This is one line.
This is another line.

Conjuntos de caracteres GSM

A Vonage suporta todos os caracteres padrão do GSM, bem como os caracteres da tabela estendida do GSM. Os caracteres da tabela padrão requerem 7 bits por caractere para serem codificados:

! " # $ % ' ( ) * + , - . / : ; < = > ? @ _ ¡ £ ¥ § ¿ & ¤
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
Ä Å Æ Ç É Ñ Ø ø Ü ß Ö à ä å æ è é ì ñ ò ö ù ü Δ Φ Γ Λ Ω Π Ψ Σ Θ Ξ

Personagens do tabela ampliada exigem dois caracteres para serem codificados: um ESC prefixo de caractere seguido do caractere necessário da tabela estendida:

| ^ € { } [ ] ~ \

Unicode

Idiomas como o árabe, o chinês, o coreano, o japonês ou aqueles que utilizam o alfabeto cirílico exigem caracteres Unicode que vão além do padrão GSM e das faixas estendidas. Esses caracteres requerem a codificação UCS-2 de 16 bits.

Quando você define o type parâmetro para unicode, todos Os caracteres contidos na mensagem são codificados usando UCS-2, mesmo que estejam presentes no conjunto de caracteres padrão do GSM.

Exemplos de codificação

Número máximo de caracteres

O comprimento máximo de uma única mensagem SMS é de 140 bytes, o que equivale a 160 caracteres padrão GSM de 7 bits ou 70 caracteres UCS-2 de 16 bits. Uma mensagem com comprimento superior a esse valor é dividida em partes.

Se você estiver enviando uma mensagem com um type valor de text nesse caso, aplicam-se os seguintes limites de caracteres:

Se você estiver enviando uma mensagem com um type de unicode nesse caso, cada caractere da mensagem ocupa dois bytes.

A Vonage aceita SMS com até 3.200 caracteres, mas nem todas as operadoras fazem o mesmo. É recomendável garantir que a mensagem não exceda seis partes de SMS.

Teste seus modelos de mensagem com esta ferramenta: