Solução de problemas
Por que minhas mensagens não estão sendo exibidas?
Verifique os seguintes pontos:- O número remetente não suporta MMS. Se imagens estiverem ausentes, verifique se o número “De” que você adquiriu no Twilio suporta MMS.
- Você está na lista de cancelamento de inscrição do Twilio. Envie
STARTpara o número “De” e tente novamente. - O número de telefone não está no formato E.164. O OneSignal exige que todos os números de telefone estejam no formato E.164.
Como envio SMS internacional?
Os passos dependem do seu provedor de SMS:- OneSignal SMS — O envio internacional é suportado para países específicos. Países adicionais requerem um pacote de segurança atualizado — entre em contato com vendas.
- Twilio — Habilite o envio internacional no seu console Twilio em Messaging > Settings > Geo permissions.
Formato e codificação de mensagens
O que é o formato E.164?
E.164 é um padrão internacional para formatação de números de telefone. O OneSignal exige que todos os números de telefone estejam neste formato: um prefixo+, código do país e número do assinante sem espaços ou zeros à esquerda.
- EUA:
999 999 9999→+19999999999 - Reino Unido (Londres):
020 9999 9999→+442099999999
Qual é o limite de caracteres do SMS e como a codificação afeta esse limite?
O SMS utiliza a codificação GSM-7 por padrão (caracteres latinos, números e símbolos comuns), que permite 160 caracteres por segmento. Mensagens contendo emojis ou scripts não latinos (por exemplo, chinês, árabe) utilizam a codificação UCS-2, que permite apenas 70 caracteres por segmento. Mensagens que excedem esses limites são divididas em vários segmentos, com 7 bytes reservados por segmento para remontagem — reduzindo os caracteres utilizáveis para 153 (GSM-7) ou 67 (UCS-2). Você pode usar a calculadora de segmentos de mensagem do Twilio para verificar as contagens. Para mais detalhes, consulte Conteúdo e codificação de SMS.Posso enviar MMS?
Sim, dependendo do seu país e se o seu número “De” suporta MMS. Você pode anexar até 10 URLs de mídia por mensagem (tamanho total inferior a 5 MB). Para tipos de mídia suportados e disponibilidade regional, consulte Mídia MMS.Assinantes e consentimento
Como adiciono assinantes de SMS?
Você pode adicionar assinantes de SMS de várias maneiras:- SDK — Use o método
addSms()para associar um número de telefone a um usuário. - Importação — Faça upload de um CSV de números de telefone pelo dashboard. Consulte Importar números de telefone.
- API — Crie ou atualize usuários com números de telefone via REST API.
Como os usuários cancelam ou reativam a inscrição?
Os usuários podem enviar STOP para o seu número de envio para cancelar a inscrição de todos os SMS, e START para reativar a inscrição. Você pode configurar palavras-chave adicionais (como HELP) e respostas automáticas no seu dashboard do OneSignal em Settings > SMS > Consent Management. Consulte Gerenciamento de palavras-chave de consentimento de SMS.O OneSignal suporta SMS bidirecional?
O OneSignal suporta respostas baseadas em palavras-chave para gerenciamento de consentimento, incluindo fluxos de text-to-subscribe e double opt-in. SMS bidirecional conversacional completo (onde você recebe e responde a mensagens arbitrárias dos usuários) não é suportado. Configure respostas por palavras-chave no seu dashboard do OneSignal em Settings > SMS > Consent Management.Tipos de remetente
Quais são os diferentes tipos de remetente de SMS?
O tipo de remetente determina o número de telefone ou ID que aparece no campo “De” das suas mensagens.| Tipo | Formato | Throughput | Observações |
|---|---|---|---|
| Long code | Número de 10 dígitos (ex: 999-999-9999) | Baixo | Sujeito à filtragem de operadoras para tráfego A2P |
| Short code | 5–6 dígitos | Alto | Aprovado por operadoras; configuração de 8–12 semanas. Somente EUA, CA e Reino Unido. Consulte Short codes Twilio |
| Toll-free | 10 dígitos, prefixo 8XX | Médio (3 msg/seg) | Pode ser verificado pela operadora para reduzir filtragem |
| Alphanumeric sender ID | String personalizada, até 11 caracteres | Varia | Somente envio; não suportado nos EUA/CA. Consulte países suportados |
O que é um Twilio Messaging Service?
Um Messaging Service é um recurso do Twilio que agrupa vários números de remetente (long codes, short codes, toll-free) em uma configuração compartilhada. Os benefícios incluem:- Balanceamento de carga — Distribui o tráfego de saída entre os números agrupados para maior throughput.
- Geo-matching — Roteia mensagens por números locais quando disponíveis.
- Prioridade de short code — Envia via short code primeiro quando há um no pool.
- Fallback de MMS — Converte MMS em um SMS com um link de URL para a mídia se a operadora ou o dispositivo não suportar MMS.
Conformidade e regulamentações
O que é A2P 10DLC?
A2P 10DLC (Application-to-Person 10-Digit Long Code) é um sistema das operadoras dos EUA que permite que empresas enviem SMS por números de telefone padrão de 10 dígitos com melhor capacidade de entrega. Todo o tráfego do Twilio nos EUA é classificado como A2P. As empresas devem registrar sua marca e campanhas no Twilio. O throughput de mensagens é determinado pela pontuação de confiança da marca e pelo tipo de campanha. O registro ajuda a reduzir a filtragem das operadoras e melhora a velocidade de entrega em comparação com long codes não registrados.Quais regulamentações de SMS devo seguir?
No mínimo:- Envie apenas para usuários que tenham optado explicitamente pela inscrição
- Comunique claramente o que os usuários estão assinando
- Mantenha registros de opt-in incluindo tipo de consentimento, data/hora e frequência
- Atenda imediatamente às solicitações de opt-out (por exemplo, palavra-chave STOP)
As regulamentações variam por país. Consulte as diretrizes por país do Twilio e pesquise as leis locais antes de enviar mensagens internacionais.
Visão geral de SMS
Configure, envie e acompanhe mensagens SMS e MMS com o OneSignal.