Codificación inteligente de SMS

Las sustituciones tipográficas pueden sacar un SMS de GSM-7. Un procesador de texto convierte ' en ’, el texto pegado contiene una raya, o un campo de formulario incluye un espacio de no separación. Cada uno se parece a un carácter GSM-7, pero un solo carácter fuera de GSM convierte todo el cuerpo a UCS-2, lo que reduce la capacidad de cada segmento.

La codificación inteligente reemplaza esos caracteres por sus equivalentes en GSM-7 antes de que Bird entregue el mensaje al operador, de modo que un cuerpo que solo parecía no GSM permanece en GSM-7 y se factura como menos segmentos.

Cómo activarla

Está desactivada por defecto, porque modifica el texto que lee el destinatario. Establece options.smart_encoding en true en un envío:

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

Los SDK de Go y PHP la aceptan como campo nullable, así que dejarla sin valor toma el valor por defecto de Bird en lugar de enviar false.

Configura la codificación inteligente por mensaje. Bird no ofrece un ajuste global de cuenta ni por remitente.

Cuándo Bird mantiene UCS-2

El reemplazo se aplica solo cuando convierte todo el cuerpo a GSM-7. Si algún carácter queda fuera de GSM-7, Bird envía el cuerpo exactamente como se proporcionó.

Un solo emoji, carácter CJK o letra acentuada fuera de GSM-7 mantiene todo el mensaje en UCS-2:

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

“ es reemplazable, pero á no está en GSM-7 y no tiene entrada en la tabla, así que este cuerpo se envía sin cambios como UCS-2. GSM-7 incluye à, ä, å, é, è, ì, ò, ù, ö, ñ, ü pero no á, í ni ú.

Las letras acentuadas están deliberadamente ausentes de la tabla. Reducir á a a cambiaría la palabra en lugar de aproximarla, lo cual es un compromiso incorrecto para quien escribe en español o portugués.

La normalización afecta a los acentos combinantes. En texto NFD, un ê descompuesto almacena el acento como una marca combinante separada, de modo que la codificación inteligente lo convierte a e^. Un ê precompuesto permanece sin cambios y usa UCS-2.

Qué no hace

• Nunca trunca. Un cuerpo que supere el límite de 12 segmentos se rechaza con un 422, y el límite se mide después del reemplazo, así que activarla puede hacer que un cuerpo demasiado largo quede dentro del límite.
• No modifica un cuerpo que ya es GSM-7, porque no hay segmentos que ahorrar.
• No cambia lo que se te factura más allá del número de segmentos: el conteo se calcula a partir del cuerpo tal como se envió.

Consultar lo que ocurrió

El mensaje reporta ambas partes. text es el cuerpo tal como se envió, y options.smart_encoding reporta el ajuste que se aplicó:

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

Un encoding con valor UCS2 en un envío en el que activaste la opción te indica que el cuerpo no pudo llevarse a GSM-7. Para ver qué ocurriría con un mensaje concreto antes de enviarlo, pega el texto en la calculadora de segmentos de SMS.

Tabla completa de reemplazos

La tabla de reemplazos lista cada carácter que se modifica cuando la codificación inteligente está activada. Los demás caracteres, incluidos los que ya pertenecen a GSM-7, permanecen sin cambios.

Las variantes de espacio en blanco se reducen a un único espacio (U+0020). La última fila lista los caracteres de ancho cero y formato que se eliminan en lugar de reemplazarse.

Siguientes pasos

• Límites de caracteres: consulta GSM-7, UCS-2 y los límites de segmentos.
• Enviar SMS: activa la codificación inteligente en un envío.
• Calculadora de segmentos de SMS: comprueba un mensaje antes de enviarlo.