Resposta curta
O SMS de OTP costuma não chegar por poucos motivos: o número está errado ou mal formatado, o celular está desligado ou sem sinal, o ID de remetente (Sender ID) não está registrado no país, um filtro da operadora bloqueia a mensagem ou o usuário bloqueou remetentes promocionais. Os relatórios de entrega mostram a causa, então confira-os primeiro.
Causas comuns e como identificá-las
| Causa | Sinal típico |
|---|---|
| Número errado ou fora do padrão E.164 | Status rejeitado ou com falha logo de cara |
| Celular desligado, em roaming ou sem sinal | Status expirado após o período de validade |
| ID de remetente sem registro | Falhas concentradas em um país ou operadora |
| Filtro da operadora | Rejeitado ou não entregue em uma rede, muitas vezes após mudar o conteúdo |
| Bloqueio no aparelho ou pasta de spam | Status entregue, mas o usuário não vê nada |
Como investigar falhas na entrega de OTP
- Consulte o relatório de entrega dos números afetados e anote o status e o código de erro.
- Verifique se o número está no formato internacional completo (E.164).
- Confirme que o ID de remetente está registrado no destino; nos mercados do GCC, os IDs de remetente normalmente são registrados antes do uso.
- Mantenha o texto do OTP curto, sem conteúdo de marketing nem links encurtados desconhecidos.
- Teste em cada uma das principais operadoras do mercado.
- Adicione um fallback: modelo de autenticação do WhatsApp ou ligação de voz após um timeout curto.
Limites dos relatórios de entrega
Algumas operadoras devolvem os comprovantes com atraso ou nem devolvem, e algumas informam entregue quando a mensagem chegou à rede, não ao celular. Trate o relatório de entrega como forte indício, não como prova. Uma queda repentina nos códigos digitados enquanto o volume de envio sobe também pode indicar SMS pumping, e não problema de entrega.
A OmniChannels.ai oferece webhooks de status de entrega, consulta HLR de números e fallback de OTP entre SMS, WhatsApp e voz.