Por que o SMS de verificação não chega

Você comprou o número, digitou no formulário, clicou em enviar. Passaram dois minutos e nada. Antes de comprar outro, vale entender por que isso acontece — porque na maioria das vezes o problema não se resolve tentando de novo com o mesmo país e o mesmo serviço.

O caminho que o código percorre

Entre o clique e a tela do seu painel existem quatro partes, e qualquer uma delas pode engolir a mensagem:

1. O serviço decide se envia. Ele olha o número, compara com as regras dele e pode simplesmente não disparar nada.
2. A operadora de origem entrega para a rede de destino. Rotas internacionais passam por intermediários, e cada salto é um lugar onde a mensagem pode atrasar.
3. A operadora do número recebe e encaminha.
4. O provedor expõe a mensagem na API, e ela aparece no seu painel.

O passo 1 é onde a maior parte das mensagens morre — e é o único que não gera erro nenhum. Do lado do serviço, a tela diz "enviamos um código". Do seu lado, silêncio.

As cinco causas reais

A faixa do número está marcada. Plataformas grandes mantêm listas de faixas de numeração que não recebem código. Essas listas mudam toda semana e são diferentes para cada serviço. Um número que funcionou para um serviço ontem pode não funcionar para outro hoje. É por isso que a API pede país e serviço: você não está alugando um número solto, está alugando uma combinação que ainda entrega.

O serviço limitou o destino. Depois de muitos cadastros vindos da mesma faixa, o serviço passa a ignorar novos pedidos por um tempo. Não é bloqueio permanente, é resfriamento.

A mensagem atrasou além da janela. O número fica reservado por cerca de 20 minutos. Rota internacional congestionada pode levar mais que isso. A mensagem até chega — depois que o pedido já expirou.

O serviço só aceita número do próprio país. Bancos e serviços públicos brasileiros costumam recusar qualquer coisa que não seja +55. Nesse caso nenhum número estrangeiro vai funcionar, por melhor que seja a faixa.

Você pediu para o serviço errado. Selecionar "WhatsApp" e usar o número no Telegram costuma não funcionar: a faixa foi escolhida pela entrega naquele serviço específico.

O que fazer, em ordem

Comece pelo mais barato:

1. Cancele o pedido. Sem SMS recebido, o valor volta integral para a carteira — cancelar um pedido sem código é estorno, não prejuízo. Não deixe expirando à toa: cancelar libera o número e devolve o saldo na hora.
2. Tente outro país. Se o serviço aceita internacional, trocar o país troca a faixa inteira. É a mudança com maior chance de resultado.
3. Confira o serviço selecionado. Ele precisa ser o mesmo em que você vai usar o número.
4. Espere alguns minutos entre tentativas. Repetir na mesma faixa em sequência costuma piorar, porque reforça o padrão que fez o serviço limitar o destino.
5. Se três países falharem seguidos, provavelmente o serviço só aceita número local. Aí a saída é outra.

Sobre esperar o código

Se você está automatizando isso, a forma como espera importa. Consultar a API em laço apertado não faz a operadora entregar mais rápido — só gasta sua cota de requisições e pode te render um 429. O caminho melhor é receber o evento em vez de perguntar por ele: a plataforma avisa por SSE ou webhook no instante em que a mensagem chega.

E, se for consultar mesmo assim, limite o laço pelo expiresAt que a própria API devolve, não por um número fixo de tentativas. A API sabe até quando aquele número vive.

O que não é causa

Não é o seu saldo, não é a sua chave de API e quase nunca é a plataforma. Quando a plataforma falha, você recebe um erro — com um código que diz o que houve. Silêncio total é quase sempre decisão do serviço de destino.

A regra prática: código que não chega não deve custar nada. Se o seu provedor cobra por número que não entregou, o problema não é a faixa de numeração.

Na AltiviaCloud é assim: pedido sem SMS é estornado, seja cancelado ou vencido. O catálogo está em números virtuais e os valores, em preços.