L'encodage intelligent SMS

Les substitutions typographiques peuvent faire sortir un SMS du jeu GSM-7. Un traitement de texte transforme ' en ’, du texte collé contient un tiret cadratin, ou un champ de formulaire comporte une espace insécable. Chacun ressemble à un caractère GSM-7, mais un seul caractère non GSM convertit tout le corps du message en UCS-2, ce qui réduit la capacité de chaque segment.

L'encodage intelligent remplace ces caractères par leurs équivalents GSM-7 avant que Bird ne transmette le message à l'opérateur, de sorte qu'un corps qui semblait seulement non GSM reste en GSM-7 et coûte moins de segments.

Activation

Il est désactivé par défaut, car il modifie le texte que votre destinataire reçoit. Définissez options.smart_encoding à true lors d'un envoi :

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

Les SDK Go et PHP acceptent ce champ comme nullable : ne pas le définir utilise la valeur par défaut de Bird au lieu d'envoyer false.

Définissez l'encodage intelligent par message. Bird ne propose pas de réglage global au niveau du compte ou de l'expéditeur.

Quand Bird conserve UCS-2

Le remplacement ne s'applique que s'il convertit la totalité du corps en GSM-7. Si un seul caractère reste en dehors de GSM-7, Bird envoie le corps exactement tel quel.

Un seul emoji, caractère CJK ou lettre accentuée en dehors de GSM-7 maintient le message entier en UCS-2 :

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

Le “ est remplaçable, mais á ne figure pas dans GSM-7 et n'a pas d'entrée dans la table : ce corps est donc envoyé tel quel en UCS-2. GSM-7 inclut à, ä, å, é, è, ì, ò, ù, ö, ñ, ü mais pas á, í ni ú.

Les lettres accentuées sont volontairement absentes de la table. Réduire á à a changerait le mot au lieu de l'approximer, ce qui est un mauvais compromis pour un expéditeur écrivant en espagnol ou en portugais.

La normalisation affecte les accents combinants. Dans un texte NFD, un ê décomposé stocke l'accent comme un signe combinant séparé, et l'encodage intelligent le convertit en e^. Un ê précomposé reste inchangé et utilise UCS-2.

Ce qu'il ne fait pas

• Il ne tronque jamais. Un corps dépassant la limite de 12 segments est rejeté avec une 422, et la limite est mesurée après remplacement : activer l'option peut donc ramener un corps trop long en dessous de la limite.
• Il ne touche pas un corps déjà en GSM-7, qui n'a aucun segment à économiser.
• Il ne change pas ce qui vous est facturé au-delà du nombre de segments : le nombre est calculé à partir du corps tel qu'envoyé.

Consulter ce qui s'est passé

Le message rapporte les deux volets. text est le corps tel qu'envoyé, et options.smart_encoding indique le réglage appliqué :

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

Un encoding à UCS2 sur un envoi pour lequel vous avez activé l'option indique que le corps n'a pas pu être ramené en GSM-7. Pour voir ce qui se passerait avec un message donné avant de l'envoyer, collez le texte dans le calculateur de segments SMS.

La table complète de remplacement

La table de remplacement répertorie chaque caractère modifié lorsque l'encodage intelligent est activé. Les autres caractères, y compris ceux déjà présents dans GSM-7, restent inchangés.

Les variantes d'espaces sont réduites à une seule espace (U+0020). La dernière ligne répertorie les caractères de largeur nulle et de mise en forme qui sont supprimés au lieu d'être remplacés.

Étapes suivantes

• Limites de caractères : consultez GSM-7, UCS-2 et les limites de segments.
• Envoyer des SMS : activez l'encodage intelligent lors d'un envoi.
• Calculateur de segments SMS : vérifiez un message avant de l'envoyer.