Concatenación y codificación

Cuando envías un mensaje SMS tienes que tener en cuenta la longitud total del mensaje porque determina si el mensaje llega entero o se divide en dos o más mensajes. El esquema de codificación que utiliza el SMS (text o unicode) afecta al número máximo de caracteres que caben en un solo mensaje. La Messages API detecta automáticamente si hay caracteres unicode en el mensaje enviado y utiliza el tipo de codificación apropiado. Esta configuración puede modificarse mediante una directiva encoding_type en el cuerpo de la solicitud.

Este documento abarca los siguientes temas:

• Concatenación
• Codificación
  • Nuevas líneas
  • Juegos de caracteres GSM
  • Unicode
  • Ejemplos de codificación
• Número máximo de caracteres

Concatenación

Si envías un mensaje que contiene más del número máximo de caracteres por mensaje, Vonage envía un SMS concatenados. Un SMS concatenado contiene múltiples partes de SMS que están conectadas por información de segmentación en el Cabecera de datos de usuario (UDH).

Esta información de segmentación indica al terminal el número de partes de mensaje que componen el SMS concatenado y la posición de cada parte de mensaje dentro de él. Cuando el terminal ha recibido todas las partes del mensaje, las presenta al destinatario como un texto único.

Para obtener más información, la base de conocimientos de Vonage contiene información detallada sobre SMS multiparte.

Codificación

Existen dos tipos principales de codificación que la API de Messages de Vonage admite para el envío de SMS: text y unicode. Por defecto, la Messages API detecta automáticamente si el texto contiene caracteres unicode y envía el mensaje como texto o como SMS unicode. Puede anular este comportamiento configurando explícitamente cualquiera de las opciones siguientes text o unicode como valor para el encoding_type de la propiedad opcional sms objeto. La codificación que debe utilizar depende de los caracteres que contenga el mensaje:

• Fije el type a text para mensajes que sólo contengan caracteres en el Juegos de caracteres estándar y ampliados GSM.
• Fije el type a unicode para los mensajes que contienen caracteres fuera de los juegos de caracteres GSM (como los caracteres chinos, japoneses y coreanos).

Nuevas líneas

Para incluir una nueva línea en su mensaje, puede representar un salto de línea (LF) utilizando la tecla \n en el valor de la cadena para el text del cuerpo JSON. Esto contará como un único carácter con respecto al recuento de caracteres del mensaje. Por ejemplo, el siguiente valor para text:

enviará un mensaje SMS con el siguiente aspecto:

Juegos de caracteres GSM

Vonage admite todos los caracteres GSM estándar, así como los caracteres de la tabla GSM ampliada. La codificación de los caracteres de la tabla estándar requiere 7 bits por carácter:

Personajes de la mesa extendida requieren la codificación de dos caracteres: un ESC seguido del carácter requerido de la tabla extendida:

Unicode

Lenguas como el árabe, el chino, el coreano, el japonés o el alfabeto cirílico requieren caracteres Unicode más allá del estándar GSM y rangos extendidos. Estos caracteres requieren una codificación UCS-2 de 16 bits.

Cuando ajuste el type a unicode, todos los caracteres del mensaje se codifican utilizando UCS-2, aunque estén presentes en el conjunto de caracteres estándar GSM.

Ejemplos de codificación

Número máximo de caracteres

La longitud máxima de un mensaje SMS es de 140 bytes, lo que equivale a 160 caracteres estándar GSM de 7 bits o 70 caracteres UCS-2 de 16 bits. Un mensaje más largo se divide en partes.

Si envía un mensaje con un type valor de text se aplicarán los siguientes límites de caracteres:

Si envía un mensaje con un type de unicode entonces cada carácter del mensaje requiere dos bytes.

Vonage acepta SMS de hasta 3200 caracteres, pero no todas las compañías lo hacen. La mejor práctica es asegurarse de que el mensaje no supere las seis partes de SMS.

Pruebe sus plantillas de mensajes con esta herramienta: