Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
API oficial do WhatsApp

O que a Meta exige do número na API oficial do WhatsApp, e o que ela não define

O número precisa ser seu, receber SMS ou ligação e não estar no WhatsApp comum. Veja o que a Meta exige, o que recomenda e o que não define sobre o alugado.

Por Redação ProxyBox · Editor técnico 13 min de leitura API oficial do WhatsApp · Cloud API · requisitos do número · número virtual · verificação de número · WhatsApp Business

Antes de escolher o número da API oficial, vale ler o que a Meta escreve sobre ele. São poucas linhas, e o que elas não dizem pesa tanto quanto o que dizem.

A API oficial do WhatsApp, que a Meta chama de Cloud API, é a plataforma em que a empresa envia e recebe mensagens pelos servidores da própria Meta. A comparação com as integrações não oficiais, como Evolution e Baileys, está em API oficial do WhatsApp ou Evolution e Baileys. Aqui o assunto é só o número.

Segundo a documentação da Meta sobre números de telefone (consulta em 15/11/2026), o número precisa ser seu, ter código de país e DDD, receber SMS ou ligação e não estar em uso no WhatsApp comum. Para número alugado, a Meta não publica regra. Este texto separa três coisas: o que ela exige, o que ela só recomenda e o que deixa em aberto.

O que a Meta exige do número, em quatro linhas

A documentação diz que um número elegível deve:

  • ser seu, no original "be owned by you";
  • ter código de país e DDD, e números curtos (short codes) não são aceitos;
  • conseguir receber ligação de voz ou SMS;
  • ter "scaled capabilities", expressão que a Meta liga a um artigo da Central de Ajuda.

Sobre a quarta condição, vale ser direto: o artigo da Central de Ajuda não abriu na nossa consulta, então não vamos traduzir nem interpretar o que ela significa.

Fora essa lista, o número não pode estar em uso no WhatsApp comum, precisa ser verificado por código e registrado por uma chamada de API. Registrar só pelo painel da Meta não vale.

Celular, fixo, VoIP ou 0800: o que a Meta aceita

A Meta publica uma tabela com os tipos de número. Ela avalia a chance de o código de verificação chegar por SMS e por ligação. Não é uma lista de aprovados e reprovados: só o pager aparece como "Not supported" (não suportado).

Tipo de número Código por SMS Código por ligação O que a Meta diz
Celular (Mobile) Standard Standard Marcado como recomendado. Pede receber SMS e chamadas internacionais e manter o aparelho na rede celular
Fixo (Fixed line) Not Recommended Standard Pede desligar desvio de chamada e URA (o atendimento por menu de voz) e deixar a linha pronta para chamadas
VoIP (telefonia pela internet) Not Recommended Standard Pede confirmar que o provedor aceita SMS e chamadas internacionais para códigos
0800 (Freephone) Not Recommended Standard Atrás de URA, só vale se aceitar chamada internacional e encaminhar para uma pessoa
Tarifa premium, acesso universal, só recebe Not Recommended Standard Pede confirmar com a operadora o recebimento internacional
Compartilhado, pessoal, M2M/IoT Not Recommended Not Recommended Pede confirmar com a operadora o recebimento internacional
Pager Not supported Not supported Não suportado
Número alugado ou virtual Não é uma categoria da tabela Não é uma categoria da tabela A tabela classifica pelo tipo da linha e não tem uma linha para "alugado"

Três pontos para ler a tabela sem exagerar:

  1. "Not Recommended" é uma recomendação contra, não uma proibição. Fixo e VoIP não são proibidos na documentação que consultamos.
  2. A Meta recomenda número de celular, e é a única linha marcada assim. Isso responde "qual número a Meta prefere", não "meu número será aceito".
  3. A tabela mede a chegada do código, não a aprovação do número para sempre. Nenhuma linha vem com promessa de aceitação.

Um número que só recebe SMS depende da coluna do SMS. No celular ela é "Standard"; no fixo e no VoIP, "Not Recommended". Quem tem fixo ou VoIP precisa de uma linha que atenda a chamada do código.

Os números do painel da ProxyBox são de faixa de celular brasileiro, com DDD. Quem classifica o tipo do número é a Meta, e ela não publica como trata um número alugado. Por isso não dizemos que a Meta o enxerga como celular.

"Owned by you": o que o número ser seu quer dizer

A regra tem três palavras e a Meta não as detalha. A documentação não define "owned". Não diz se vale um contrato de aluguel, um número cedido por um prestador, uma linha no nome de outra pessoa ou uma linha no CNPJ da empresa.

O que a documentação descreve é como a Meta confere a posse: pelo código. Adicionar e verificar o número no painel serve, nas palavras da página, para "verify your ownership" (verificar que o número é seu), e a prova é receber o código por SMS ou ligação e informá-lo. Uma reverificação periódica não aparece na documentação.

Como o número é verificado e registrado

O caminho que a página de registro da Meta descreve tem quatro passos:

  1. Adicionar o número à conta do WhatsApp Business da empresa, a WABA, na sigla em inglês: a conta na Meta onde ficam o número, os modelos de mensagem e a cobrança. Desde 23/09/2026, segundo a Meta sobre o novo modelo de contas, ela se divide em duas: a "WhatsApp account", que guarda o número, e a "Messaging account", que guarda modelos e cobrança.
  2. Pedir o código (request_code), escolhendo SMS ou ligação de voz.
  3. Informar o código (verify_code).
  4. Registrar o número (register) por chamada de API, com um PIN de 6 dígitos.

Quem usa um parceiro da Meta, os chamados BSP (provedores de soluções de negócios, que na documentação aparecem como Solution Partner), recebe do parceiro um link de cadastro chamado Embedded Signup. O registro por API precisa ser feito até 14 dias depois desse cadastro.

O que a Meta informa sobre o código:

  • Validade: "time-limited (typically 10 minutes) and single-use", ou seja, normalmente 10 minutos e uso único.
  • Tentativas: a Meta não publica um número. Diz que várias tentativas falhas "podem causar bloqueio temporário". Quanto tempo dura esse bloqueio, ela não diz.
  • Tamanho do código: a documentação consultada não informa.
  • Número já verificado: pedir o código de novo devolve o erro 136024.
  • Registro: há um limite de 10 chamadas por número a cada 72 horas. Acima disso, vem o erro 133016 e o número fica bloqueado para registro por 72 horas.

O passo a passo do nosso lado está em como cadastrar o número na API oficial. Se o código não chegar, veja código do WhatsApp não chega.

O número não pode estar no WhatsApp comum

A mesma página é clara: "Numbers already in use with WhatsApp cannot be registered unless they are deleted first". Número que já tem conta no WhatsApp comum precisa ter essa conta apagada antes.

Para quem já usa o aplicativo WhatsApp Business no número, há dois caminhos:

  • Apagar a conta do aplicativo e registrar na API. O histórico de mensagens se perde.
  • Coexistência, que mantém o aplicativo Business e a Cloud API no mesmo número. Exige o aplicativo na versão 2.24.17 ou mais nova e um parceiro com Embedded Signup. Ela foi lançada em 19/03/2025. O Brasil não estava na lista de países de fora no lançamento (Índia, Reino Unido, Espaço Econômico Europeu, Turquia, Japão e outros), mas não encontramos uma frase oficial dizendo que o Brasil é suportado. Confirme com o parceiro.

Se o número já foi banido, a Meta exige que ele seja desbanido por apelação antes de ser registrado de novo. As causas mais comuns estão em por que um número da API de WhatsApp é banido.

Outras regras do número que costumam surpreender

  • Teto de números. Um portfólio novo, que é o cadastro da empresa na Meta, começa com no máximo 2 números registrados. O teto sobe para 20 com a verificação da empresa ou com um limite de envio de 2.000.
  • Nome de exibição. É obrigatório no registro e pode ser trocado 10 vezes a cada 30 dias, segundo a Meta. Depois de aprovado, há 14 dias para registrar de novo. Segundo Gupshup e 360dialog, provedores de API (fonte secundária), o nome não pode ser genérico, parecer verificado nem conter nome de produto da Meta, como WhatsApp, Facebook ou Messenger.
  • Verificação da empresa. Segundo a página de limites de mensagens, ela abre caminho para o limite de 2.000 e eleva o teto para 20 números. O que mais ela libera não conseguimos confirmar.
  • Anúncios que abrem conversa no WhatsApp. A Página precisa ter um número vinculado, mas a documentação de anúncios não diz quais tipos de número valem. Sobre número virtual ou fixo nesse uso, a Meta não diz nada.
  • Bloqueios. A política de aplicação prevê bloqueios de 1 a 30 dias e a desativação permanente da conta.

O que a Meta cobra por mensagem é outro assunto, tratado em quanto custa a API oficial do WhatsApp.

E se o número for alugado? O que a Meta não define

O que não está escrito

A Meta escreve "be owned by you" e para aí. Na documentação de números, na Política de Comércio e na Política de Mensagens que consultamos em 15/11/2026, não encontramos uma regra que permita ou proíba número alugado ou de revenda. A página dos Termos da Plataforma não abriu por inteiro na nossa consulta, então vale lê-la antes de decidir.

Isso não é autorização. É uma lacuna. Não vamos dizer que a Meta aceita número virtual ou alugado, porque ela não diz isso.

O que acontece quando o aluguel acaba

O número alugado da ProxyBox dura 30 dias, com renovação automática ligada. Enquanto a renovação estiver em dia, o número fica reservado para a sua conta. Se ela vencer, o número volta para a venda e outra pessoa pode registrar WhatsApp nele.

Para esse cenário, em que o número deixa de ser da empresa e outra pessoa registra WhatsApp nele, a Meta não tem regra publicada para a Cloud API. Não dá para dizer o que acontece com o número registrado na sua conta da Meta, e não vamos supor.

Na prática: quando o alugado cabe e quando não

  • Operação que pode trocar de número sem grande prejuízo, como um teste, um projeto curto ou um canal secundário: o número alugado pode caber, com a renovação em dia e a data do vencimento no seu calendário.
  • Operação que não pode perder o número, porque os clientes já têm esse número salvo e o canal não pode sair do ar: o caminho mais seguro é uma linha em nome da empresa, celular ou fixo contratado em uma operadora. Assim a exigência "owned by you" é cumprida sem depender de interpretação.

Quem avalia o risco é você

A decisão e o risco são seus. Nós não prometemos aceitação, e a Meta muda regras: em 2026 ela mudou o modelo de contas e passou a cobrar as mensagens de serviço. Releia a documentação no dia em que for cadastrar.

O que a ProxyBox entrega, e o que não entrega

O que o número brasileiro para a API oficial da ProxyBox tem:

  • número de faixa de celular brasileiro, com DDD à sua escolha;
  • aluguel por 30 dias, com renovação automática ligada;
  • código no painel e por e-mail;
  • funciona na prática: o número recebe o código de verificação por SMS e consegue ser cadastrado na API oficial; a decisão final sobre cada número continua sendo da plataforma do WhatsApp, e por isso não prometemos aprovação;
  • só SMS: o número não recebe ligação, então peça o código por SMS e nunca por ligação;
  • troca sem custo enquanto o código ainda não chegou; depois que o código chega, não há troca;
  • verificação de conta com documento e selfie antes da primeira compra;
  • a conta na Meta é sua.

O que não entra: a ProxyBox não é BSP nem parceira da Meta, não faz a integração e não promete que a Meta aceitará o número. O preço aparece no painel e na página do número.

Se o que você quer é o aplicativo, e não a API, os caminhos são outros. Veja as páginas de número virtual para WhatsApp Business e de número virtual para WhatsApp, o guia ativar o número no WhatsApp e o artigo WhatsApp sem chip. Para só receber SMS de qualquer serviço, o produto é o número virtual.

O que fazer agora

  1. Decida se o canal pode perder o número. Se não pode, contrate uma linha em nome da empresa. Se pode, o alugado entra na conta, com o risco descrito acima.
  2. Confira o tipo e a situação do número. Celular recebe o código por SMS; fixo e VoIP dependem de ligação; qualquer um deles não pode estar em uso no WhatsApp comum.
  3. Se escolher o alugado, mantenha a renovação automática ligada, peça o código por SMS só com a tela de digitação aberta e siga o passo a passo do cadastro. A página do número brasileiro para a API oficial mostra o preço e a disponibilidade.
  4. Releia a documentação da Meta no dia do cadastro e confira o custo por mensagem em quanto custa a API oficial do WhatsApp.

Neste guia: 1 artigos de apoio

Cada tópico acima tem um artigo próprio, com o passo a passo e os detalhes que não cabem aqui.

  1. Quanto custa a API oficial do WhatsApp em 2026: a conta inteira, da Meta ao número

    A Meta cobra por mensagem entregue, e desde 1º de outubro de 2026 a resposta ao cliente deixou de ser grátis sem limite. Veja o que entra na conta, com exemplos de cálculo e as fontes dos valores.

Ver o índice de API oficial do WhatsApp

Perguntas frequentes

Quais são os requisitos do número na Cloud API do WhatsApp?
Segundo a documentação da Meta (consulta em 15/11/2026), o número precisa ser seu ('owned by you'), ter código de país e DDD (números curtos não valem), conseguir receber ligação de voz ou SMS e ter 'scaled capabilities', expressão que a Meta explica em um artigo da Central de Ajuda que não conseguimos abrir. Além disso, o número não pode estar em uso no WhatsApp comum e precisa ser verificado por código e registrado por chamada de API.
Número fixo ou VoIP funciona na API oficial?
Não são proibidos na documentação que consultamos. Na tabela da Meta, fixo e VoIP aparecem com SMS 'Not Recommended' (não recomendado) e ligação 'Standard' (padrão). A Meta recomenda número de celular e não promete aceitação para nenhum tipo de linha. Para fixo e VoIP, ela orienta pedir o código por ligação e desligar desvio de chamada e URA.
A Meta aceita número virtual ou alugado?
A Meta não define. Ela exige que o número seja 'owned by you' (seu) e, na documentação de números, na Política de Comércio e na Política de Mensagens que consultamos, não achamos regra que permita ou proíba número alugado. A página dos Termos da Plataforma não abriu por inteiro na nossa consulta. Por isso não afirmamos que a Meta aceita. Cabe a você avaliar o risco, e para uma operação que não pode perder o número o caminho mais seguro é uma linha em nome da empresa.
O que acontece se o aluguel do número vencer?
No número alugado da ProxyBox, a renovação automática vem ligada e o número fica reservado para a sua conta enquanto ela estiver em dia. Se vencer, o número volta para a venda e outra pessoa pode registrar WhatsApp nele. A Meta não tem regra publicada para esse caso, então não dá para dizer o que acontece com o número registrado na sua conta da Meta.
O código de verificação chega por SMS ou por ligação?
A Meta aceita as duas formas, SMS ou ligação de voz, e diz que o código tem validade típica de 10 minutos e vale uma vez. O número alugado da ProxyBox só recebe SMS, não recebe ligação: peça sempre o código por SMS. Ele chega no painel e também por e-mail.

Quer aplicar isso na sua operação?

Preço público em reais, PIX e credenciais no painel em minutos. Se não souber qual tipo escolher, descreva a operação no WhatsApp — indicamos o mais barato que resolve.

Este conteúdo é informativo. Proxy é infraestrutura de rede: controlamos origem, exclusividade e geolocalização do IP. Aprovação ou restrição de contas depende também de comportamento de uso, impressão digital do navegador e das políticas internas de cada plataforma. Consulte a política de uso aceitável.

Suporte em português Fale no WhatsApp