Smart encoding SMS

Substitusi tipografis dapat mendorong SMS keluar dari GSM-7. Pengolah kata mengubah ' menjadi ’, teks yang ditempel mengandung em dash, atau kolom formulir membawa non-breaking space. Masing-masing tampak mirip karakter GSM-7, tetapi satu karakter non-GSM mengonversi seluruh isi pesan ke UCS-2, sehingga kapasitas setiap segmen berkurang.

Smart encoding mengganti karakter-karakter tersebut dengan padanan GSM-7-nya sebelum Bird menyerahkan pesan ke operator, sehingga isi pesan yang sebenarnya bukan non-GSM tetap GSM-7 dan ditagih dengan segmen lebih sedikit.

Mengaktifkannya

Fitur ini nonaktif secara default karena mengubah teks yang dibaca penerima. Atur options.smart_encoding ke true pada pengiriman:

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

SDK Go dan PHP menerimanya sebagai field nullable, jadi membiarkannya tidak diatur akan menggunakan default Bird alih-alih mengirim false.

Atur smart encoding per pesan. Bird tidak menyediakan pengaturan tingkat akun atau per pengirim.

Kapan Bird mempertahankan UCS-2

Penggantian hanya berlaku jika seluruh isi pesan dapat dikonversi ke GSM-7. Jika ada karakter yang tetap di luar GSM-7, Bird mengirim isi pesan persis seperti yang diberikan.

Satu emoji, karakter CJK, atau huruf beraksen di luar GSM-7 membuat seluruh pesan tetap dalam UCS-2:

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

“ dapat diganti, tetapi á tidak ada dalam GSM-7 dan tidak memiliki entri di tabel, sehingga isi pesan ini dikirim tanpa perubahan sebagai UCS-2. GSM-7 mencakup à, ä, å, é, è, ì, ò, ù, ö, ñ, ü tetapi tidak á, í, atau ú.

Huruf beraksen sengaja tidak dimasukkan ke dalam tabel. Mengubah á menjadi a akan mengubah kata, bukan sekadar mendekatinya, dan itu bukan pertukaran yang tepat bagi pengirim yang menulis dalam bahasa Spanyol atau Portugis.

Normalisasi memengaruhi combining accent. Dalam teks NFD, ê yang didekomposisi menyimpan aksen sebagai combining mark terpisah, sehingga smart encoding mengonversinya menjadi e^. ê yang sudah precomposed tetap tidak berubah dan menggunakan UCS-2.

Yang tidak dilakukannya

• Smart encoding tidak pernah memotong teks. Isi pesan yang melebihi batas 12 segmen ditolak dengan 422, dan batas tersebut diukur setelah penggantian, sehingga mengaktifkan fitur ini dapat membuat isi pesan yang terlalu besar menjadi di bawah batas.
• Fitur ini tidak menyentuh isi pesan yang sudah GSM-7, karena tidak ada segmen yang bisa dihemat.
• Fitur ini tidak mengubah apa yang Anda bayar selain jumlah segmen: jumlah tersebut dihitung dari isi pesan yang dikirim.

Membaca kembali apa yang terjadi

Pesan melaporkan kedua sisi. text adalah isi pesan yang dikirim, dan options.smart_encoding melaporkan pengaturan yang berlaku:

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

encoding bernilai UCS2 pada pengiriman yang Anda aktifkan menandakan isi pesan tidak dapat dikonversi ke GSM-7. Untuk melihat apa yang akan terjadi pada pesan tertentu sebelum Anda mengirimnya, tempel teks ke kalkulator segmen SMS.

Tabel penggantian lengkap

Tabel penggantian mencantumkan setiap karakter yang diubah saat smart encoding aktif. Karakter lain, termasuk yang sudah ada dalam GSM-7, tetap tidak berubah.

Varian spasi diciutkan menjadi satu spasi (U+0020). Baris terakhir mencantumkan karakter zero-width dan pemformatan yang dihapus, bukan diganti.

Langkah selanjutnya

• Batas karakter: tinjau GSM-7, UCS-2, dan batas segmen.
• Mengirim SMS: aktifkan smart encoding pada pengiriman.
• Kalkulator segmen SMS: periksa pesan sebelum mengirimnya.