Resposta curta
Os SMS geralmente não são entregues porque o número é inválido ou está inativo, o celular ficou desligado além do prazo de validade, o ID de remetente (Sender ID) não está registrado no país, o conteúdo foi filtrado como spam ou regras de marketing bloquearam o envio. O relatório de entrega indica o motivo: UNDELIV, EXPIRED e REJECTD apontam causas diferentes.
Quais são as causas mais comuns?
| Sintoma | Causa provável | Solução |
|---|---|---|
| UNDELIV ou FAILED | Formato errado, número inativo ou portado | Padronize no formato E.164 e limpe a lista com consultas HLR |
| EXPIRED | Celular desligado ou sem sinal | Tente de novo mais tarde ou use outro canal como alternativa |
| REJECTD ou REJECTED | ID de remetente não registrado ou conteúdo bloqueado | Registre o ID; revise links e texto |
| Nenhuma confirmação | A operadora não envia confirmações | Pergunte ao provedor quais rotas retornam confirmações |
| Só o marketing falha | Horário de silêncio, lista DND ou falta de opt-in | Envie no horário permitido para contatos com opt-in |
Como diagnosticar um problema de entrega?
- Verifique a resposta da API: um envio recusado nunca chegou à rede.
- Leia o status e o código de erro do relatório de entrega das mensagens com falha.
- Agrupe as falhas por país e operadora para encontrar um padrão.
- Confirme que o ID de remetente está registrado para esse destino e caso de uso.
- Envie um teste para um celular conhecido na mesma operadora.
- Se o padrão continuar, compartilhe os IDs das mensagens com seu provedor.
O que mais pode bloquear SMS no GCC?
As operadoras dos Emirados e da Arábia Saudita exigem IDs de remetente registrados, e IDs não registrados costumam ser bloqueados. O SMS promocional é proibido no horário de silêncio: das 21h às 7h nos Emirados, pela política antispam da TDRA, e das 22h às 9h na Arábia Saudita, pelas regras da CST. Os firewalls de SMS das operadoras também bloqueiam links suspeitos e tráfego vindo de rotas não autorizadas.
Como recuperar mensagens que falharam?
Para mensagens importantes, use fallback entre canais: se o SMS falhar, tente WhatsApp ou RCS, ou o contrário. A OmniChannels.ai permite configurar a ordem de fallback e padroniza os status de entrega em um único formato de webhook.