Codifica intelligente SMS

Le sostituzioni tipografiche possono far uscire un SMS dal GSM-7. Un elaboratore di testo trasforma ' in ’, il testo incollato contiene un trattino lungo, oppure un campo di un modulo include uno spazio unificatore. Ognuno di questi caratteri appare simile a un carattere GSM-7, ma un solo carattere non GSM converte l'intero corpo del messaggio in UCS-2, riducendo la capacità di ogni segmento.

La codifica intelligente sostituisce quei caratteri con i loro equivalenti GSM-7 prima che Bird consegni il messaggio all'operatore, così un corpo che sembrava non GSM resta GSM-7 e viene fatturato con meno segmenti.

Come attivarla

È disattivata per impostazione predefinita, perché modifica il testo letto dal destinatario. Imposta options.smart_encoding su true in un invio:

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

Gli SDK Go e PHP lo accettano come campo nullable, quindi lasciarlo non impostato usa il valore predefinito di Bird anziché inviare false.

Imposta la codifica intelligente per ogni singolo messaggio. Bird non prevede un'impostazione a livello di account o per mittente.

Quando Bird mantiene UCS-2

La sostituzione si applica solo quando converte l'intero corpo del messaggio in GSM-7. Se un qualsiasi carattere resta fuori da GSM-7, Bird invia il corpo esattamente così com'è.

Un singolo emoji, carattere CJK o lettera accentata fuori da GSM-7 mantiene l'intero messaggio in UCS-2:

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

“ è sostituibile, ma á non è presente in GSM-7 e non ha una voce nella tabella, quindi questo corpo viene inviato invariato come UCS-2. GSM-7 include à, ä, å, é, è, ì, ò, ù, ö, ñ, ü ma non á, í o ú.

Le lettere accentate sono volutamente assenti dalla tabella. Convertire á in a cambierebbe la parola anziché approssimarla, un compromesso sbagliato per chi scrive in spagnolo o portoghese.

La normalizzazione influisce sugli accenti combinanti. In un testo NFD, un ê decomposto memorizza l'accento come segno combinante separato, quindi la codifica intelligente lo converte in e^. Un ê precomposto resta invariato e usa UCS-2.

Cosa non fa

• Non tronca mai. Un corpo che supera il limite di 12 segmenti viene rifiutato con un 422, e il limite viene calcolato dopo la sostituzione, quindi attivare la codifica intelligente può far rientrare un corpo troppo lungo nel limite.
• Non interviene su un corpo già in GSM-7, che non ha segmenti da risparmiare.
• Non modifica ciò che viene fatturato oltre al conteggio dei segmenti: il conteggio è calcolato sul corpo effettivamente inviato.

Verificare cosa è successo

Il messaggio riporta entrambe le informazioni. text è il corpo così come inviato, e options.smart_encoding indica l'impostazione applicata:

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

Un encoding con valore UCS2 su un invio per cui hai attivato la codifica intelligente indica che il corpo non è stato convertibile in GSM-7. Per verificare cosa succederebbe a un messaggio specifico prima di inviarlo, incolla il testo nel calcolatore di segmenti SMS.

Tabella completa delle sostituzioni

La tabella delle sostituzioni elenca ogni carattere modificato quando la codifica intelligente è attiva. Gli altri caratteri, compresi quelli già presenti in GSM-7, restano invariati.

Le varianti di spazio vengono ridotte a un singolo spazio (U+0020). L'ultima riga elenca i caratteri a larghezza zero e di formattazione che vengono eliminati anziché sostituiti.

Prossimi passi

• Limiti di caratteri: consulta GSM-7, UCS-2 e i limiti di segmento.
• Invio di SMS: attivare la codifica intelligente in un invio.
• Calcolatore di segmenti SMS: verificare un messaggio prima di inviarlo.