O código para conectar o número à API do WhatsApp não chega: o que fazer

Como a verificação funciona

Para colocar um número na API oficial, a Meta precisa confirmar que ele é seu. Isso é feito com um código de verificação enviado ao número por SMS ou por ligação de voz. Você escolhe o método no cadastro (no cadastro incorporado do provedor, no Gerenciador do WhatsApp ou pela API) e digita o código recebido.

Depois da verificação, vem o registro do número na Cloud API, que é outra etapa. Os dois passos têm limites próprios.

As causas, da mais comum para a menos comum

1. SMS pedido para um número que não recebe bem SMS

A Meta publica uma tabela com a confiabilidade de cada tipo de número:

Solução: para fixo, 0800 e VoIP, peça o código por ligação.

2. Bloqueio de mensagens ou ligações internacionais

O código pode vir de números de fora do Brasil. A recomendação oficial, para todos os tipos de número, é habilitar o recebimento de SMS e ligações internacionais.

Solução: no celular, verifique se não há bloqueio de remetentes desconhecidos ou de mensagens internacionais; na operadora, confirme que a linha recebe chamadas internacionais.

3. URA, desvio de chamada ou caixa postal

A ligação de verificação não navega em menus. Se o número cai numa URA ("digite 1"), num desvio para outro telefone ou direto na caixa postal, o código se perde.

Solução: desligue o desvio e a URA durante a verificação. Se não for possível, a Meta orienta criar uma lista de permissão com os números de onde a ligação vai sair e desviar essas chamadas para uma pessoa; sem conseguir os números, abra chamado no suporte da Meta.

4. Celular sem sinal ou sem permissão no app

Para celular, a Meta recomenda garantir que o aparelho esteja conectado à rede celular (não só ao Wi-Fi) e que os aplicativos tenham as permissões necessárias.

5. Número ainda ativo no WhatsApp comum

A documentação é clara: números em uso no WhatsApp não podem ser registrados na API sem antes apagar a conta. No caso do app WhatsApp Business, a alternativa é a coexistência por um provedor.

Solução: no WhatsApp comum, Configurações > Conta > Apagar minha conta (com backup antes). Depois de apagar, a Meta indica que o número pode levar até 3 minutos para ficar disponível.

6. Número banido

Número banido no WhatsApp precisa ser desbanido pelo processo de recurso antes de ser registrado na API.

7. Excesso de tentativas

Pedir o código ou tentar registrar muitas vezes seguidas bloqueia temporariamente. Os limites documentados:

Solução: pare de tentar, espere o intervalo e tente uma vez, com o método certo.

Passo a passo para resolver

1. Confira o tipo de número. Fixo, 0800 ou VoIP? Use ligação.
2. Confira se o número está livre. Não pode estar ativo no WhatsApp comum. Se estiver no app Business, use coexistência ou apague a conta.
3. Libere internacionais. SMS e ligações de fora do país.
4. Desligue desvios e URA. Durante a verificação, a ligação precisa chegar direto.
5. Tenha alguém pronto para atender. Ligação de verificação não espera.
6. Peça o código uma vez e espere alguns minutos antes de pedir de novo.
7. Se aparecer erro de limite, espere o prazo (72 horas no caso do registro).
8. Se nada funcionar, use outro número ou abra chamado no suporte da Meta (ou peça ao seu provedor).

Mensagens de erro e o que significam

E no app WhatsApp Business?

No app, o processo é parecido: o código vem por SMS e, se não chegar, você espera a barra de progresso terminar (pode levar até 10 minutos) e toca em Me ligue para receber por ligação. A Central de Ajuda do WhatsApp lembra que, no app, números VoIP, 0800, premium e de centrais telefônicas não são compatíveis, que ramal não funciona e que não se deve tentar adivinhar o código, porque isso pode bloquear o acesso temporariamente. Também orienta desligar apps que bloqueiam ligações e conferir o sinal mandando um SMS de outro celular para o número. Os erros mais comuns no app são parecidos: número digitado errado (sem DDD ou com o código do país duplicado), sem sinal, ou tentativas demais (o app mostra quanto tempo esperar).

Números virtuais e o código

Muita gente tenta usar número virtual (VoIP) para a API. A Meta não proíbe, mas classifica SMS como não recomendado para VoIP e pede para confirmar com o provedor de VoIP que o número recebe SMS e ligações internacionais, mantendo o serviço e as notificações ligados. O risco maior não é o código: é depender de um número que você pode perder se o serviço de VoIP for cancelado. A gente discute isso em número virtual para WhatsApp.

Prevenção: antes de começar o cadastro

Exemplo: verificando um 0800 que fica atrás de URA

Uma rede de lojas quer usar o 0800 da central no WhatsApp. O roteiro que segue a documentação da Meta:

1. No cadastro, adiciona o número e escolhe ligação como método.
2. Antes de pedir o código, conversa com quem administra a central telefônica.
3. Pede, pelo suporte da Meta (ou do provedor), os números de origem da ligação de verificação.
4. A central cria uma lista de permissão para esses números e desvia essas chamadas para um ramal com uma pessoa avisada.
5. Pede o código uma única vez.
6. A pessoa atende, anota os seis dígitos e passa para quem está no cadastro.
7. O número é verificado e, em seguida, registrado na API.

Sem os passos 2 a 4, a ligação cai no menu, ninguém ouve o código, e as tentativas vão se acumulando até o bloqueio.

O código chegou, mas o registro falhou

A verificação (código) e o registro (ligar o número à Cloud API) são etapas separadas. Se o código foi aceito e o registro falhou:

Com o novo modelo de contas, a Meta está descontinuando o PIN de seis dígitos para números elegíveis da Cloud API. Para esses números, o PIN deixa de ser usado para validar o registro, e a aba de verificação em duas etapas some do Gerenciador.

Como o provedor pode ajudar

Quem conecta por um provedor oficial normalmente tem suporte no próprio cadastro: o provedor vê em que etapa a conexão parou e qual erro a Meta devolveu. Ao pedir ajuda, informe:

• o número completo, com +55 e DDD;
• o tipo de linha (celular, fixo, 0800, VoIP);
• o método escolhido (SMS ou ligação);
• a mensagem de erro exata e o horário da última tentativa.

Quando trocar de número é a melhor saída

Às vezes o número escolhido não serve: está atrás de uma central que ninguém consegue configurar, pertence a um serviço de VoIP instável, ou é de outra pessoa. Nesses casos, insistir gasta tentativas e pode bloquear o número por dias. Um chip de celular novo, só da empresa, resolve em minutos e evita depender de terceiros.

Diagnóstico rápido

Como a Certu ajuda na conexão

Na Certu, a conexão pela API oficial usa o cadastro da própria Meta dentro do painel, com a opção de receber o código por SMS ou ligação. Se o número já está no app WhatsApp Business, a coexistência evita apagar a conta. E se a verificação travar por limite de tentativas, o número pode ser conectado por QR code enquanto isso, para o atendimento não parar.

O plano Start custa R$ 299 por mês e o Pro, R$ 599. A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. Conecte o número em certu.com.br/aprender com o método de verificação certo para o seu tipo de linha.

Para ir mais fundo: número de WhatsApp banido.

Fontes

• Meta for Developers: Números de telefone comerciais (tipos de número, verificação, URA, erros), lida em 23/10/2026
• Meta for Developers: Registrar um número de telefone (limites), lida em 23/10/2026
• Meta for Developers: Códigos de erro, lida em 23/10/2026
• Meta for Developers: Migrar um número existente do WhatsApp, lida em 23/10/2026
• Central de Ajuda do WhatsApp: Como registrar seu número de telefone no WhatsApp Business, lida em 23/10/2026

Leia também

• telefone fixo no WhatsApp Business e na API
• requisitos da API oficial
• migrar o número para a API
• número virtual para WhatsApp