Slimme codering voor SMS

Typografische substituties kunnen een SMS uit GSM-7 duwen. Een tekstverwerker verandert ' in ’, geplakte tekst bevat een em-streepje, of een formulierveld bevat een vaste spatie. Elk teken lijkt op een GSM-7-teken, maar één niet-GSM-teken converteert de hele body naar UCS-2, waardoor de capaciteit van elk segment afneemt.

Slimme codering vervangt die tekens door hun GSM-7-equivalenten voordat Bird het bericht aan de carrier overdraagt. Zo blijft een body die er alleen niet-GSM uitzag op GSM-7 staan en wordt hij als minder segmenten gefactureerd.

Inschakelen

Het staat standaard uit, omdat het de tekst verandert die je ontvanger leest. Zet options.smart_encoding op true bij een verzending:

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 }
  }'

De Go- en PHP-SDK's nemen het als een nullable veld, dus als je het niet instelt wordt de standaardwaarde van Bird gebruikt in plaats van false te sturen.

Stel slimme codering per bericht in. Bird biedt geen accountbrede of per-afzenderinstelling.

Wanneer Bird UCS-2 behoudt

Vervanging vindt alleen plaats als het de hele body naar GSM-7 converteert. Als er een teken buiten GSM-7 overblijft, stuurt Bird de body exact zoals aangeleverd.

Eén emoji, CJK-teken of letter met accent buiten GSM-7 houdt het hele bericht in UCS-2:

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

De “ is vervangbaar, maar á zit niet in GSM-7 en heeft geen vermelding in de tabel, dus deze body wordt ongewijzigd als UCS-2 verstuurd. GSM-7 omvat à, ä, å, é, è, ì, ò, ù, ö, ñ, ü maar niet á, í of ú.

Letters met accenten ontbreken bewust in de tabel. á omzetten naar a zou het woord veranderen in plaats van benaderen, en dat is de verkeerde afweging voor een afzender die Spaans of Portugees schrijft.

Normalisatie beïnvloedt combinerende accenten. In NFD-tekst slaat een gedecomposeerde ê het accent op als een apart combinerend teken, waardoor slimme codering het naar e^ converteert. Een voorgecomposeerde ê blijft ongewijzigd en gebruikt UCS-2.

Wat het niet doet

• Het kapt nooit af. Een body boven de limiet van 12 segmenten wordt afgewezen met een 422, en de limiet wordt gemeten na vervanging, dus inschakelen kan een te grote body eronder brengen.
• Het raakt een body die al GSM-7 is niet aan, want daar zijn geen segmenten mee te besparen.
• Het verandert niet waarvoor je wordt gefactureerd, behalve het aantal segmenten: het aantal wordt berekend op basis van de body zoals verstuurd.

Uitlezen wat er is gebeurd

Het bericht rapporteert beide kanten. text is de body zoals verstuurd, en options.smart_encoding rapporteert de instelling die is toegepast:

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

Een encoding van UCS2 bij een verzending waarvoor je had ingeschakeld, geeft aan dat de body niet naar GSM-7 gebracht kon worden. Om te zien wat er met een specifiek bericht zou gebeuren voordat je het verstuurt, plak je de tekst in de SMS-segmentcalculator.

De volledige vervangingstabel

De vervangingstabel bevat elk teken dat wordt gewijzigd wanneer slimme codering is ingeschakeld. Andere tekens, inclusief tekens die al in GSM-7 zitten, blijven ongewijzigd.

Witruimtevarianten worden samengevoegd tot één spatie (U+0020). De laatste rij bevat tekens met nulbreedte en opmaaktekens die worden verwijderd in plaats van vervangen.

Volgende stappen

• Tekenlimieten: bekijk GSM-7, UCS-2 en segmentlimieten.
• SMS versturen: schakel slimme codering in bij een verzending.
• SMS-segmentcalculator: controleer een bericht voordat je het verstuurt.