Codificação inteligente de SMS

Substituições tipográficas podem tirar um SMS de GSM-7. Um editor de texto transforma ' em ’, texto colado contém um travessão, ou um campo de formulário carrega um espaço não separável. Cada um se parece com um caractere GSM-7, mas um único caractere fora do GSM converte todo o corpo para UCS-2, reduzindo a capacidade de cada segmento.

A codificação inteligente substitui esses caracteres pelos equivalentes em GSM-7 antes de Bird entregar a mensagem à operadora. Assim, um corpo que apenas parecia não-GSM permanece GSM-7 e é cobrado com menos segmentos.

Como ativar

Ela vem desativada por padrão, porque altera o texto que o destinatário lê. Defina options.smart_encoding como true em um envio:

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

Os SDKs de Go e PHP aceitam o campo como anulável, então deixá-lo indefinido usa o padrão de Bird em vez de enviar false.

Defina a codificação inteligente por mensagem. Bird não oferece uma configuração global por conta ou por remetente.

Quando Bird mantém UCS-2

A substituição só é aplicada quando converte todo o corpo para GSM-7. Se qualquer caractere permanecer fora de GSM-7, Bird envia o corpo exatamente como fornecido.

Um único emoji, caractere CJK ou letra acentuada fora de GSM-7 mantém toda a mensagem em UCS-2:

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

O “ é substituível, mas á não está em GSM-7 e não tem entrada na tabela, então esse corpo é enviado inalterado como UCS-2. GSM-7 inclui à, ä, å, é, è, ì, ò, ù, ö, ñ, ü, mas não á, í ou ú.

Letras acentuadas estão deliberadamente ausentes da tabela. Converter á para a mudaria a palavra em vez de aproximá-la, o que é a troca errada para quem escreve em espanhol ou português.

A normalização afeta acentos combinantes. Em texto NFD, um ê decomposto armazena o acento como uma marca combinante separada, então a codificação inteligente o converte para e^. Um ê pré-composto permanece inalterado e usa UCS-2.

O que ela não faz

• Ela nunca trunca. Um corpo acima do limite de 12 segmentos é rejeitado com um 422, e o limite é medido após a substituição, então ativar a opção pode trazer um corpo grande demais para dentro do limite.
• Ela não altera um corpo que já é GSM-7, pois não há segmentos a economizar.
• Ela não muda o que você paga além da contagem de segmentos: a contagem é calculada a partir do corpo como enviado.

Consultando o que aconteceu

A mensagem informa as duas partes. text é o corpo como enviado, e options.smart_encoding informa a configuração que foi aplicada:

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

Um encoding de UCS2 em um envio em que você ativou a opção indica que o corpo não pôde ser convertido para GSM-7. Para ver o que aconteceria com uma mensagem específica antes de enviá-la, cole o texto na calculadora de segmentos SMS.

A tabela completa de substituição

A tabela de substituição lista cada caractere alterado quando a codificação inteligente está ativa. Os demais caracteres, incluindo os que já estão em GSM-7, permanecem inalterados.

Variantes de espaço em branco são reduzidas a um único espaço (U+0020). A última linha lista caracteres de largura zero e de formatação que são excluídos em vez de substituídos.

Próximos passos

• Limites de caracteres: consulte GSM-7, UCS-2 e limites de segmento.
• Enviando SMS: ative a codificação inteligente em um envio.
• Calculadora de segmentos SMS: verifique uma mensagem antes de enviá-la.