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.

Jun 25, 2026

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

  1. Abra a conversa na Caixa de entrada e veja o status da mensagem.
  2. Se aparecer como Falhou ou com um ícone de erro, passe o cursor: o Omnifox mostra o motivo retornado pelo provedor.
  3. 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.

  1. Entre no painel do seu provedor (Twilio).
  2. Verifique o saldo disponível e se a conta não está em modo de teste/trial.
  3. Recarregue se estiver zerado. Contas trial só enviam para números verificados.

Passo 3: Verifique o número e as credenciais

  1. No Omnifox vá em Configurações → Canais e abra seu canal de SMS.
  2. 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.
  3. 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.

  1. Copie a Webhook URL que o canal mostra no Omnifox.
  2. Cole na configuração do número dentro do painel do provedor.
  3. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp