Concaténation et encodage

Lorsque vous envoyez un SMS, vous devez tenir compte de la longueur totale du message, car c'est elle qui détermine si le message arrive en un seul morceau ou s'il est divisé en deux messages ou plus. Le schéma d'encodage utilisé par le SMS (text ou unicode) influe sur le nombre maximal de caractères pouvant être contenus dans un seul message. L'API Messages détecte automatiquement si le message soumis contient des caractères unicode et utilise le type d'encodage approprié. Ce paramètre peut être modifié au moyen d'une commande encoding_type dans le corps de la requête.

Ce document couvre les sujets suivants :

• Concaténation
• Encodage
  • Nouvelles lignes
  • Jeux de caractères GSM
  • Unicode
  • Exemples de codage
• Nombre maximal de caractères

Concaténation

Si vous envoyez un message qui contient plus que le nombre maximum de caractères par message, Vonage envoie un SMS concaténé. Un SMS concaténé contient plusieurs parties de SMS qui sont reliées par des informations de segmentation dans le fichier En-tête de données utilisateur (UDH).

Ces informations de segmentation indiquent au combiné le nombre de parties de message qui composent le SMS concaténé et la position de chaque partie de message au sein de celui-ci. Lorsque le combiné a reçu toutes les parties du message, il les présente au destinataire sous la forme d'un texte unique.

Pour plus d'informations, la base de connaissances de Vonage contient des informations détaillées sur les points suivants SMS multipartite.

Encodage

L'API Messages de Vonage prend en charge deux principaux types de codage pour l'envoi de SMS : text et unicode. Par défaut, l'API Messages détecte automatiquement la présence de caractères unicode dans le texte et envoie le message comme il convient, soit sous forme de texte, soit sous forme de SMS unicode. Vous pouvez modifier ce comportement en définissant explicitement l'un ou l'autre des paramètres suivants text ou unicode comme valeur pour le encoding_type de la propriété optionnelle sms objet. Le codage à utiliser dépend des caractères que le message contient :

• Régler le type au paramètre text pour les messages qui ne contiennent que des caractères dans le champ Jeux de caractères standard et étendus du GSM.
• Régler le type au paramètre unicode pour les messages contenant des caractères en dehors des jeux de caractères GSM (tels que les caractères chinois, japonais et coréens).

Nouvelles lignes

Pour inclure une nouvelle ligne dans votre message, vous pouvez représenter un saut de ligne (LF) à l'aide de la touche \n dans la valeur de la chaîne de caractères pour le text du corps JSON. Il s'agit d'un caractère unique par rapport au nombre de caractères du message. Par exemple, la valeur suivante pour text:

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

enverra un message SMS qui ressemblera à celui-ci :

This is one line.
This is another line.

Jeux de caractères GSM

Vonage prend en charge tous les caractères GSM standard ainsi que les caractères de la table GSM étendue. Les caractères de la table standard nécessitent 7 bits par caractère pour être encodés :

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

Personnages de la table rallongée nécessitent l'encodage de deux caractères : un ESC suivi du caractère requis de la table étendue :

| ^ € { } [ ] ~ \

Unicode

Les langues telles que l'arabe, le chinois, le coréen, le japonais ou l'alphabet cyrillique nécessitent des caractères Unicode au-delà de la norme GSM et des gammes étendues. Ces caractères nécessitent un codage UCS-2 de 16 bits.

Lorsque vous réglez le type au paramètre unicode, tous dans le message sont codés à l'aide de UCS-2, même s'ils sont présents dans le jeu de caractères standard du GSM.

Exemples de codage

Nombre maximal de caractères

La longueur maximale d'un message SMS est de 140 octets, ce qui correspond à 160 caractères GSM standard de 7 bits ou à 70 caractères UCS-2 de 16 bits. Un message plus long est divisé en plusieurs parties.

Si vous envoyez un message avec un type valeur de text les limites de caractères suivantes s'appliquent :

Si vous envoyez un message avec un type de unicode alors chaque caractère du message nécessite deux octets.

Vonage accepte les SMS d'une longueur maximale de 3200 caractères, mais ce n'est pas le cas de tous les opérateurs. La meilleure pratique consiste à s'assurer que le message ne dépasse pas six parties de SMS.

Testez vos modèles de messages avec cet outil :