"Por que meu SMS não chegou?" — Guia de Troubleshooting para o Brasil

É a pergunta de 1 milhão de reais. Você enviou o código de acesso, o cliente está na linha esperando, e... nada. O silêncio constrangedor.

Antes de culpar a API ou a operadora (embora muitas vezes a culpa seja delas), vamos seguir um fluxo lógico de diagnóstico. Desenvolvemos este guia baseados em milhões de mensagens trafegadas mensalmente no Brasil.

Passo 1: O "Básico" que Passa Batido

• O número é válido? Parece óbvio, mas ~5% das falhas são números formatados errados (falta o 9º dígito, DDD inexistente).
• É um telefone fixo? Sim, acontece. Tentar mandar SMS para landline é erro na certa.
• O aparelho está ligado e com sinal? Se o celular está em "Modo Avião" ou fora de área por mais de 24h-48h (dependendo da validade da mensagem), a operadora descarta o SMS.

Passo 2: Bloqueios no Aparelho (Handset)

Hoje, Android e iOS têm filtros de spam nativos poderosos.

• Pasta de Spam: Peça para o usuário verificar a pasta "Spam e Bloqueados" no app de Mensagens.
• Apps de Terceiros: TrueCaller e similares bloqueiam Sender IDs desconhecidos agressivamente.

Passo 3: O Pesadelo das Operadoras (Carrier Filters)

Aqui é onde a mágica (negra) acontece. As operadoras filtram mensagens baseadas em conteúdo e comportamento.

• Palavras-chave proibidas: "Empréstimo", "Renda Extra", "Juros Zero". Se seu SMS transacional tem cara de marketing, ele pode ser barrado.
• URLs Encurtadas: Usou bit.ly ou tinyurl? Grande chance de bloqueio. As operadoras odeiam encurtadores públicos pois são usados em phishing.
• Same Content Blocking: Enviar "Bom dia" para 1.000 pessoas exatamente igual. Variar o texto (spin) ajuda.

Passo 4: Rotas e Agregadores

Se você usa um provedor "baratinho", cuidado.

• Rota Internacional: Se o SMS chega com remetente "+44" ou "+1", é uma rota internacional tentando entregar no Brasil. A taxa de entrega é abismalmente menor que rotas nacionais (Short Code ou Long Code BR).
• Fake DLR: Alguns provedores desonestos retornam "Entregue" quando entregam para a operadora, não para o celular. O status real que você quer é "Handset Delivery".

O Fluxograma da Solução

Siga este fluxo de decisão para diagnosticar rapidamente:

Códigos de Erro e Rotas

Códigos de Erro Mais Comuns (Brasil)

Dica: Sempre monitore esses códigos no seu dashboard. Picos de 30007 indicam que você precisa revisar o conteúdo das mensagens urgentemente.

Grey Route vs Official Route

Passos de diagnóstico adicionais:

1. Verifique o Status Code: Sua API retornou erro? (Ex: Undeliverable, Rejected)
2. Cheque a Higienização: O número existe na base da portabilidade (NBR)?
3. Teste Cruzado: Envie para um número de outra operadora (se falhou na TIM, teste na Vivo). Se chegar, o problema é isolado na operadora de destino
4. Troque a Rota: Se nada funciona, peça ao seu provedor para mudar a rota de saída (Failover)

Conclusão

Diagnosticar SMS exige paciência e ferramentas certas. Não trabalhe no escuro. Exija transparência do seu fornecedor sobre as rotas utilizadas.

---

Quer logs detalhados e transparência total? A Notifica fornece logs granulares com os códigos de erro reais das operadoras, para você saber exatamente onde o problema está. Depure seus envios agora.