Inteligentne kodowanie SMS

Typograficzne podstawienia mogą wypchnąć SMS poza GSM-7. Edytor tekstu zamienia ' na ’, wklejony tekst zawiera pauzę, a pole formularza przenosi niełamliwą spację. Każdy z tych znaków wygląda podobnie do znaku GSM-7, ale jeden znak spoza GSM konwertuje całą treść na UCS-2, zmniejszając pojemność każdego segmentu.

Inteligentne kodowanie zastępuje te znaki ich odpowiednikami GSM-7, zanim Bird przekaże wiadomość operatorowi. Dzięki temu treść, która jedynie wyglądała na spoza GSM, pozostaje w GSM-7 i jest rozliczana jako mniej segmentów.

Włączanie

Domyślnie jest wyłączone, ponieważ zmienia tekst, który odczytuje odbiorca. Ustaw options.smart_encoding na true przy wysyłce:

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 i PHP przyjmują tę wartość jako pole nullable, więc pozostawienie go nieustawionego powoduje użycie domyślnej wartości Bird zamiast wysłania false.

Ustawiaj inteligentne kodowanie osobno dla każdej wiadomości. Bird nie udostępnia ustawienia na poziomie konta ani nadawcy.

Kiedy Bird zachowuje UCS-2

Zamiana ma zastosowanie tylko wtedy, gdy konwertuje całą treść na GSM-7. Jeśli jakikolwiek znak pozostaje poza GSM-7, Bird wysyła treść dokładnie tak, jak została dostarczona.

Pojedyncze emoji, znak CJK lub litera z akcentem spoza GSM-7 powoduje, że cała wiadomość pozostaje w UCS-2:

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

Znak “ można zastąpić, ale á nie należy do GSM-7 i nie ma wpisu w tabeli, więc ta treść jest wysyłana bez zmian jako UCS-2. GSM-7 obejmuje à, ä, å, é, è, ì, ò, ù, ö, ñ, ü, ale nie á, í ani ú.

Litery z akcentami celowo nie znajdują się w tabeli. Zamiana á na a zmieniałaby słowo, zamiast je przybliżać, a to zły kompromis dla nadawcy piszącego po hiszpańsku lub portugalsku.

Normalizacja wpływa na łączone akcenty. W tekście NFD zdekomponowany ê przechowuje akcent jako osobny combining mark, więc inteligentne kodowanie konwertuje go na e^. Złożony ê pozostaje bez zmian i używa UCS-2.

Czego nie robi

• Nigdy nie obcina treści. Treść przekraczająca limit 12 segmentów jest odrzucana z błędem 422. Limit jest mierzony po zamianie, więc włączenie tej opcji może zmieścić zbyt dużą treść w limicie.
• Nie modyfikuje treści, która jest już w GSM-7, bo nie ma w niej segmentów do zaoszczędzenia.
• Nie zmienia tego, za co płacisz, poza liczbą segmentów: liczba ta jest obliczana na podstawie treści w postaci wysłanej.

Odczytywanie informacji o tym, co się wydarzyło

Wiadomość raportuje obie strony. text to treść w postaci wysłanej, a options.smart_encoding podaje zastosowane ustawienie:

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

Wartość encoding równa UCS2 przy wysyłce z włączoną opcją oznacza, że treści nie udało się sprowadzić do GSM-7. Aby sprawdzić, co stanie się z konkretną wiadomością przed wysłaniem, wklej tekst do kalkulatora segmentów SMS.

Pełna tabela zamian

Tabela zamian zawiera każdy znak zamieniany przy włączonym inteligentnym kodowaniu. Pozostałe znaki, w tym te już należące do GSM-7, nie są zmieniane.

Warianty białych znaków są zwijane do pojedynczej spacji (U+0020). Ostatni wiersz zawiera znaki o zerowej szerokości i znaki formatowania, które są usuwane, a nie zastępowane.

Następne kroki

• Limity znaków: sprawdź GSM-7, UCS-2 i limity segmentów.
• Wysyłanie SMS: włącz inteligentne kodowanie przy wysyłce.
• Kalkulator segmentów SMS: sprawdź wiadomość przed wysłaniem.