Troubleshooting: SMS não envia ou não chega
Diagnostique e corrija SMS que não saem ou não chegam ao cliente: saldo, número, credenciais e webhook.
Quando um SMS fica preso em "Enviando" ou o cliente não recebe, a causa quase sempre está em um de três pontos: saldo do provedor, o número remetente ou as credenciais do canal. Este guia ajuda a isolar o problema rápido.
Antes de começar
- Acesso de administrador no Omnifox.
- Acesso ao painel do seu provedor de SMS (Twilio ou outro compatível).
- O canal de SMS já conectado. Se ainda não tem, veja Como conectar o SMS.
Passo 1: Identifique onde falha
- Abra a conversa na Caixa de entrada e veja o status da mensagem.
- Se aparecer como Falhou ou com um ícone de erro, passe o cursor: o Omnifox mostra o motivo retornado pelo provedor.
- Separe dois casos: a mensagem não sai do Omnifox (erro ao enviar) ou sai mas não é entregue (problema no provedor ou no número de destino).
Passo 2: Confira o saldo do provedor
A causa mais comum de envios que falham em silêncio é saldo esgotado.
- Entre no painel do seu provedor (Twilio).
- Verifique o saldo disponível e se a conta não está em modo de teste/trial.
- Recarregue se estiver zerado. Contas trial só enviam para números verificados.
Passo 3: Verifique o número e as credenciais
- No Omnifox vá em Configurações → Canais e abra seu canal de SMS.
- Confirme que o Account SID, o Auth Token e o Phone Number estão atualizados. Se você girou o token no provedor, atualize aqui também.
- Garanta que o número remetente tenha capacidade de SMS e esteja ativo (não suspenso nem liberado).
Passo 4: Cheque o webhook de entrada
Se você envia bem mas não recebe respostas, o webhook é o suspeito.
- Copie a Webhook URL que o canal mostra no Omnifox.
- Cole na configuração do número dentro do painel do provedor.
- Salve e envie um SMS de teste de outro telefone para o número.
Verifique se foi resolvido
- Envie um SMS de teste do Omnifox para o seu celular e confirme que muda para Entregue.
- Responda pelo celular e confirme que a mensagem aparece na caixa de entrada.
Se não funcionar…
- Erro de autenticação (401/403): credenciais incorretas ou token girado. Cole-as de novo.
- Número inválido ou sem permissão: nos EUA e Canadá, envios em volume exigem registro A2P 10DLC; sem ele, a operadora bloqueia o tráfego.
- Mensagem truncada ou dividida: você passou de 160 caracteres por segmento; veja Limites e custos de SMS.
- Não chega a um único destinatário: ele pode ter respondido STOP e estar na lista de exclusão da operadora.
Dicas
- Mantenha um alerta de saldo baixo no seu provedor para não ficar sem envios no meio da campanha.
- Teste sempre com um número real seu antes de disparar um envio em massa.
Artigos relacionados
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.