Wat is smart encoding en wanneer helpt het niet?

Een tekstverwerker kan een rechte apostrof veranderen in een gekrulde wanneer je een melding plakt. Die kleine wijziging kan de hele tekst naar een minder compacte codering forceren.

Gewone Latijnse tekst past met 160 tekens in één segment, een factureerbaar deel van een bericht. Een gekrulde apostrof schakelt de hele tekst over naar een breder alfabet met ruimte voor 70. Bird noemt deze coderingen GSM-7 en UCS-2.

Wat vervangt smart encoding?

Bird vervangt ondersteunde interpunctie, spaties en presentatievarianten door tekens die passen in GSM-7.

Gekrulde aanhalingstekens worden rechte aanhalingstekens. Typografische streepjes worden koppeltekens. Vaste spaties worden gewone spaties. Eén beletselteken wordt drie punten. De smart encoding guide geeft een overzicht van de vervangingen.

Bird verwijdert doorgaans geen accenten van letters. Het laat á staan als á en behoudt de spelling. GSM-7 bevat al à, ä, å, é, è, ì, ò, ù, ö, ñ en ü. Die letters hoeven niet vervangen te worden. Het bevat geen á, í of ú.

Waarom blijft de berichttekst soms ongewijzigd?

Bird past vervangingen alleen toe als de volledige resulterende berichttekst past in GSM-7 en niet leeg is.

Als een emoji of een niet-ondersteunde letter met accent overblijft, verzendt Bird de originele tekst. Een berichttekst die zowel een gekruld aanhalingsteken als á bevat, behoudt daarom beide tekens. Alleen het aanhalingsteken vervangen zou het bericht alsnog in UCS-2 houden.

Hoe je editor een accent opslaat, kan het resultaat veranderen. Een ê opgeslagen als één teken blijft ongewijzigd. Een e gevolgd door een los circumflexaccent ziet er identiek uit, maar kan e^ worden. Die vervanging geldt alleen als het volledige resultaat past in GSM-7.

Verlaagt smart encoding altijd de kosten?

Nee, want sommige vervangingen maken de tekst langer.

Zeventig beletseltekens passen in één segment. Elk vervangen door drie punten levert 210 tekens op. Dat overschrijdt de limiet van 160 tekens voor één segment en vereist twee delen, elk met ruimte voor 153 tekens.

Bij gewone interpunctie tussen langere woorden kan het resultaat de andere kant op gaan. Een berichttekst van 150 Latijnse letters plus een gekrulde apostrof bevat 151 tekens. Dat vereist drie delen bij de meerdelig-berichtruimte van 67 tekens. De apostrof vervangen laat die 151 tekens in één GSM-7-segment passen.

De gefactureerde hoeveelheid is het aantal segmenten van de resulterende tekst. SMS-segmenten legt die capaciteiten uit.

Kan het een te lang bericht genoeg inkorten om te verzenden?

Het kan de gecodeerde grootte onder de limiet van Bird brengen. Het kapt de tekst nooit af.

Bird controleert de twaalfsegmentenlimiet na toepassing van smart encoding. Een berichttekst die die limiet nog overschrijdt, krijgt HTTP 422, een afwijzing wegens ongeldige inhoud. Een berichttekst die al in GSM-7 past, wordt ongewijzigd doorgelaten.

Hoe schakel ik smart encoding in bij Bird?

Je stelt de optie in bij elke verzending. Vergelijk het geretourneerde bericht met je ingediende tekst om het resultaat te controleren.

• options.smart_encoding accepteert true of false en staat standaard op false. Het antwoord vermeldt de instelling die is toegepast.
• text is de resulterende niet-lege tekenreeks, behalve dat authenticatieberichten **REDACTED** retourneren om hun verificatiecodes te beschermen. Een vrije-tekstaanvraag moet binnen de twaalfsegmentenlimiet passen.
• segments.encoding is GSM_7BIT of UCS2.
• segments.count is een geheel getal van minimaal 1. Elk geteld segment is factureerbaar. Uitgaande berichten zijn beperkt tot 12.

Een true-instelling met UCS2 betekent dat de conversie geen bruikbare GSM-7-berichttekst heeft opgeleverd. Controleer de tekens in de uiteindelijke tekst voordat je de instelling opnieuw wijzigt.

Wanneer moet ik het inschakelen?

Schakel het in wanneer de gedocumenteerde vervangingen je bedoelde tekst behouden en het resulterende aantal segmenten past bij je bericht.

Vergelijk templates met de daadwerkelijk ingevoegde namen en productbeschrijvingen. Houd de optie uitgeschakeld wanneer exacte interpunctie of tekenweergave belangrijk is. De segmentcalculator helpt om de gecodeerde lengte te controleren vóór verzending.