Verkettung und Kodierung

Wenn Sie eine SMS-Nachricht versenden, müssen Sie auf die Gesamtlänge der Nachricht achten, da diese bestimmt, ob die Nachricht in einem Stück ankommt oder in zwei oder mehr Nachrichten aufgeteilt wird. Das von der SMS verwendete Kodierungsschema (text oder unicode) wirkt sich auf die maximale Anzahl von Zeichen aus, die in eine einzelne Nachricht passen. Die Messages API erkennt automatisch, ob die übermittelte Nachricht Unicode-Zeichen enthält, und verwendet dementsprechend den entsprechenden Kodierungstyp. Diese Einstellung kann über eine encoding_type Parameter im Body der Anfrage.

Dieses Dokument behandelt die folgenden Themen:

• Zusammenführung
• Kodierung
  • Neue Linien
  • GSM-Zeichensätze
  • Unicode
  • Kodierungsbeispiele
• Maximale Anzahl von Zeichen

Verkettung

Wenn Sie eine Nachricht senden, die mehr als die maximale Anzahl von Zeichen pro Nachricht enthält, sendet Vonage eine verkettete SMS. Eine verkettete SMS enthält mehrere SMS-Teile, die durch Segmentierungsinformationen in der SMS-Datei verbunden sind. Benutzerdaten-Header (UDH).

Diese Segmentierungsinformationen teilen dem Mobilteil die Anzahl der Nachrichtenteile mit, aus denen die verkettete SMS besteht, und die Position jedes Nachrichtenteils darin. Wenn das Mobilteil alle Nachrichtenteile empfangen hat, stellt es sie dem Empfänger als einen einzigen Text dar.

Weitere Informationen finden Sie in der Vonage Knowledgebase mit detaillierten Informationen über Mehrteilige SMS.

Kodierung

Es gibt zwei Hauptkodierungsarten, die von der Vonage Messages API für den Versand von SMS unterstützt werden: text und unicode. Standardmäßig erkennt die Messages API automatisch, ob Unicode-Zeichen im Text vorhanden sind, und sendet die Nachricht entsprechend entweder als Text- oder Unicode-SMS. Sie können dieses Verhalten außer Kraft setzen, indem Sie explizit entweder text oder unicode als Wert für die encoding_type Eigenschaft des optionalen sms Objekt. Welche Kodierung Sie verwenden sollten, hängt von den Zeichen ab, die die Nachricht enthält:

• Setzen Sie die type Parameter zu text für Nachrichten, die nur Zeichen aus dem GSM-Standard und erweiterte Zeichensätze.
• Setzen Sie die type Parameter zu unicode für Nachrichten, die Zeichen enthalten außerhalb der GSM-Zeichensätze (z. B. chinesische, japanische und koreanische Schriftzeichen).

Neue Linien

Um eine neue Zeile in Ihre Nachricht einzufügen, können Sie einen Zeilenvorschub (LF) darstellen, indem Sie die \n Zeichen im Zeichenfolgenwert für die text Eigenschaft des JSON-Körpers. Dies zählt in Bezug auf die Anzahl der Zeichen in der Nachricht als ein einziges Zeichen. Zum Beispiel der folgende Wert für text:

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

sendet eine SMS-Nachricht, die wie folgt aussieht:

This is one line.
This is another line.

GSM-Zeichensätze

Vonage unterstützt alle GSM-Standardzeichen sowie Zeichen aus der erweiterten GSM-Tabelle. Zeichen aus der Standardtabelle benötigen 7 Bits pro Zeichen zur Kodierung:

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

Charaktere aus dem erweiterte Tabelle erfordern zwei Zeichen zur Kodierung: ein ESC Zeichenpräfix, gefolgt von dem gewünschten Zeichen aus der erweiterten Tabelle:

| ^ € { } [ ] ~ \

Unicode

Sprachen wie Arabisch, Chinesisch, Koreanisch, Japanisch oder das kyrillische Alphabet erfordern Unicode-Zeichen, die über den GSM-Standard und erweiterte Bereiche hinausgehen. Diese Zeichen erfordern eine 16-Bit-UCS-2-Kodierung.

Wenn Sie die Einstellung type Parameter zu unicode, alle Zeichen innerhalb der Nachricht werden mit UCS-2 kodiert, auch wenn sie im GSM-Standardzeichensatz enthalten sind.

Kodierungsbeispiele

Maximale Anzahl von Zeichen

Die maximale Länge einer einzelnen SMS-Nachricht beträgt 140 Byte, was 160 GSM-Standard-7-Bit-Zeichen oder 70 UCS-2-16-Bit-Zeichen entspricht. Eine Nachricht, die länger ist, wird in Teile aufgeteilt.

Wenn Sie eine Nachricht mit einer type Wert von text dann gelten die folgenden Zeichenbeschränkungen:

Wenn Sie eine Nachricht mit einer type von unicode dann werden für jedes Zeichen in der Nachricht zwei Bytes benötigt.

Vonage akzeptiert SMS mit einer Länge von bis zu 3200 Zeichen, aber nicht alle Anbieter tun dies. Es ist empfehlenswert, darauf zu achten, dass die Nachricht nicht länger als sechs SMS-Teile ist.

Testen Sie Ihre Nachrichtenvorlagen mit diesem Tool: