Intelligente Zeichenkodierung für SMS

Typografische Ersetzungen können eine SMS aus GSM-7 herausdrängen. Eine Textverarbeitung wandelt ' in ’ um, eingefügter Text enthält einen Geviertstrich, oder ein Formularfeld enthält ein geschütztes Leerzeichen. Jedes dieser Zeichen sieht einem GSM-7-Zeichen ähnlich, aber ein einziges Nicht-GSM-Zeichen konvertiert den gesamten Nachrichtentext nach UCS-2, wodurch die Kapazität jedes Segments sinkt.

Die intelligente Zeichenkodierung ersetzt diese Zeichen durch ihre GSM-7-Entsprechungen, bevor Bird die Nachricht an den Carrier übergibt. So bleibt ein Nachrichtentext, der nur scheinbar Nicht-GSM war, in GSM-7 und wird mit weniger Segmenten berechnet.

Aktivierung

Die Funktion ist standardmäßig deaktiviert, weil sie den Text verändert, den der Empfänger liest. Setzen Sie options.smart_encoding beim Senden auf true:

await bird.sms.send({
  to: "+31612345678",
  from: "Bird",
  text: "Your order shipped, track it here…",
  category: "transactional",
  options: { smart_encoding: true },
});

client.sms.send(
    to="+31612345678",
    from_="Bird",
    text="Your order shipped, track it here…",
    category="transactional",
    smart_encoding=True,
)

_, err := client.Sms.Send(context.Background(), bird.SmsSendParams{
	To:            "+31612345678",
	From:          "Bird",
	Text:          "Your order shipped, track it here…",
	Category:      bird.SMSCategoryTransactional,
	SmartEncoding: bird.Bool(true),
})

$bird->sms->send(
    to: '+31612345678',
    from: 'Bird',
    text: 'Your order shipped, track it here…',
    category: 'transactional',
    smartEncoding: true,
);

bird sms send \
  --category transactional \
  --from Bird \
  --smart-encoding=true \
  --text 'Your order shipped, track it here…' \
  --to +31612345678

curl -X POST https://eu1.platform.bird.com/v1/sms/messages \
  -H "Authorization: Bearer bk_eu1_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "Bird",
    "text": "Your order shipped, track it here…",
    "category": "transactional",
    "options": { "smart_encoding": true }
  }'

Die Go- und PHP-SDKs akzeptieren den Wert als Nullable-Feld. Wird er nicht gesetzt, greift der Standardwert von Bird, anstatt false zu senden.

Setzen Sie die intelligente Zeichenkodierung pro Nachricht. Bird bietet keine konto- oder absenderweite Einstellung.

Wann Bird bei UCS-2 bleibt

Die Ersetzung greift nur, wenn sie den gesamten Nachrichtentext nach GSM-7 konvertieren kann. Bleibt auch nur ein Zeichen außerhalb von GSM-7, sendet Bird den Text unverändert.

Ein einzelnes Emoji, CJK-Zeichen oder ein akzentuierter Buchstabe außerhalb von GSM-7 hält die gesamte Nachricht in UCS-2:

{ "text": "Hoe gaat het vandaag? á “" }

Das “ ist ersetzbar, aber á ist nicht in GSM-7 enthalten und hat keinen Eintrag in der Tabelle. Deshalb wird dieser Nachrichtentext unverändert als UCS-2 gesendet. GSM-7 umfasst à, ä, å, é, è, ì, ò, ù, ö, ñ, ü, aber nicht á, í oder ú.

Akzentuierte Buchstaben fehlen bewusst in der Tabelle. á zu a zusammenzufalten würde das Wort verändern statt es anzunähern – ein schlechter Tausch für Absender, die auf Spanisch oder Portugiesisch schreiben.

Normalisierung beeinflusst kombinierende Akzente. In NFD-Text speichert ein dekomponiertes ê den Akzent als separates kombinierendes Zeichen, sodass die intelligente Zeichenkodierung es zu e^ konvertiert. Ein vorkomponiertes ê bleibt unverändert und verwendet UCS-2.

Was sie nicht tut

• Sie kürzt niemals. Ein Nachrichtentext über dem 12-Segment-Limit wird mit einem 422 abgelehnt. Das Limit wird nach der Ersetzung gemessen, sodass die Aktivierung einen zu großen Text unter das Limit bringen kann.
• Sie verändert keinen Nachrichtentext, der bereits GSM-7 ist – dort gibt es keine Segmente einzusparen.
• Sie ändert nichts an der Abrechnung außer der Segmentanzahl: Die Anzahl wird anhand des gesendeten Textes berechnet.

Ergebnis ablesen

Die Nachricht liefert beide Seiten. text enthält den Text wie gesendet, und options.smart_encoding gibt die angewendete Einstellung an:

{
  "text": "Your order shipped - track it here...",
  "segments": { "count": 1, "encoding": "GSM_7BIT", "characters": 36 },
  "options": { "smart_encoding": true }
}

Ein encoding von UCS2 bei einem Versand mit aktivierter Option bedeutet, dass der Text nicht nach GSM-7 konvertiert werden konnte. Um vorab zu prüfen, was mit einer bestimmten Nachricht passiert, fügen Sie den Text in den SMS-Segmentrechner ein.

Die vollständige Ersetzungstabelle

Die Ersetzungstabelle listet jedes Zeichen auf, das bei aktivierter intelligenter Zeichenkodierung geändert wird. Andere Zeichen, einschließlich derer, die bereits in GSM-7 enthalten sind, bleiben unverändert.

Leerzeichenvarianten werden zu einem einzelnen Leerzeichen zusammengefasst (U+0020). Die letzte Zeile listet Zeichen mit Breite null und Formatierungszeichen auf, die gelöscht statt ersetzt werden.

Nächste Schritte

• Zeichenlimits: GSM-7, UCS-2 und Segmentlimits im Überblick.
• SMS senden: intelligente Zeichenkodierung beim Senden aktivieren.
• SMS-Segmentrechner: eine Nachricht vor dem Senden prüfen.