Um editor de texto pode transformar um apóstrofo reto em um curvo quando você cola uma notificação. Essa pequena mudança pode forçar o texto inteiro a usar uma codificação menos compacta.
Texto latino simples cabe em 160 caracteres em um segmento, uma parte faturável de uma mensagem. Um apóstrofo curvo muda o texto inteiro para um alfabeto mais amplo com espaço para 70. Bird chama essas codificações de GSM-7 e UCS-2.
O que a codificação inteligente substitui?
Bird substitui pontuação, espaçamento e variantes de apresentação compatíveis por caracteres que cabem em GSM-7.
Aspas curvas se tornam aspas retas. Travessões tipográficos se tornam hifens. Espaços não separáveis se tornam espaços comuns. Um caractere de reticências se torna três pontos. O guia de codificação inteligente lista as substituições.
Bird geralmente não remove acentos de letras. Ele mantém á como á, preservando a grafia. GSM-7 já inclui à, ä, å, é, è, ì, ò, ù, ö, ñ e ü. Essas letras não precisam de substituição. Ele não inclui á, í ou ú.
Por que o corpo às vezes permanece inalterado?
Bird aplica substituições somente quando o corpo resultante inteiro cabe em GSM-7 e não fica vazio.
Se um emoji ou uma letra acentuada não compatível permanecer, Bird envia o texto original. Um corpo contendo tanto uma aspa curva quanto á mantém ambos os caracteres. Substituir apenas a aspa ainda deixaria a mensagem em UCS-2.
A forma como seu editor armazena um acento pode alterar o resultado. Um ê armazenado como um único caractere permanece inalterado. Um e seguido de um acento circunflexo separado parece idêntico, mas pode se tornar e^. Essa substituição se aplica somente se o resultado inteiro couber em GSM-7.
A codificação inteligente sempre reduz o custo?
Não, porque algumas substituições tornam o texto mais longo.
Setenta caracteres de reticências cabem em um segmento. Substituir cada um por três pontos produz 210 caracteres. Isso excede o limite de 160 caracteres para um único segmento e precisa de duas partes, cada uma permitindo 153 caracteres.
Para pontuação comum misturada em palavras mais longas, o resultado pode ser o oposto. Um corpo de 150 letras latinas mais um apóstrofo curvo contém 151 caracteres. Ele precisa de três partes com a capacidade de 67 caracteres por parte. Substituir o apóstrofo permite que esses 151 caracteres caibam em um segmento GSM-7.
A quantidade faturada é a contagem de segmentos do texto resultante. Segmentos SMS explica essas capacidades.
Ela pode encurtar uma mensagem grande demais o suficiente para enviar?
Ela pode reduzir o tamanho codificado para abaixo do limite de Bird. Ela nunca trunca o texto.
Bird verifica o limite de doze segmentos após aplicar a codificação inteligente. Um corpo que ainda exceda esse limite recebe HTTP 422, uma rejeição por conteúdo inválido. Um corpo já em GSM-7 passa inalterado.
Como habilito a codificação inteligente em Bird?
Você configura a opção em cada envio. Compare a mensagem retornada com o texto que você enviou para inspecionar o resultado.
options.smart_encodingaceitatrueoufalsee temfalsecomo padrão. A resposta informa a configuração que foi aplicada.texté a string resultante não vazia, exceto que mensagens de autenticação retornam**REDACTED**para proteger seus códigos de verificação. Uma solicitação de texto livre deve caber no limite de doze segmentos.segments.encodingéGSM_7BITouUCS2.segments.counté um inteiro de pelo menos 1. Cada segmento contado é faturável. Mensagens enviadas são limitadas a 12.
Uma configuração true com UCS2 significa que a conversão não produziu um corpo GSM-7 utilizável. Verifique os caracteres no texto final antes de alterar a configuração novamente.
Quando devo habilitá-la?
Habilite quando as substituições documentadas preservarem o texto pretendido e a contagem de segmentos resultante for adequada para sua mensagem.
Compare templates com os nomes e descrições de produtos realmente inseridos. Mantenha a opção desabilitada quando a pontuação exata ou a representação de caracteres for importante. A calculadora de segmentos ajuda a verificar o tamanho codificado antes do envio.
Em resumo
A substituição se aplica ao corpo completo.
Bird mantém o texto original se qualquer caractere não compatível permanecer após a substituição.
Letras acentuadas geralmente não são simplificadas.
Uma letra acentuada não compatível, como á, impede que a substituição seja aplicada.
Cada envio exige uma configuração explícita.
A opção de codificação inteligente aceita true ou false e tem false como padrão.
Verifique o texto resultante e a contagem de segmentos.
As substituições podem expandir o texto, então mudar a codificação não garante menos segmentos.