API oficial e regras do WhatsApp

Que número usar na API oficial do WhatsApp?

Por

Fundador do Hernesto

Publicado em · 11 min de leitura

Um chip de celular azul sobre uma superfície preta, com o contato dourado à mostra
Foto: User_Pascal no Unsplash
Neste artigo10 tópicos
  1. 1.Resposta rápida
  2. 2.Que número é aceito
  3. 3.Comum ou Business
  4. 4.Novo ou o que já divulga
  5. 5.Número virtual e VoIP
  6. 6.O que o histórico traz
  7. 7.Os dois prazos
  8. 8.O que é definitivo
  9. 9.Perguntas frequentes
  10. 10.Fontes e metodologia

Resposta rápida

Qualquer número que você controle e que passe na verificação da Meta, com uma exceção que derruba a maioria das tentativas: número em uso no WhatsApp comum não é aceito. Número que já roda no app WhatsApp Business é aceito e entra pela coexistência, continuando no celular. O caminho mais arriscado é o número virtual compartilhado, que ativa e depois cai.

Em resumo

  • A regra que quase ninguém conta: a documentação da Meta diz que número em uso no WhatsApp comum não é suportado, e que número em uso no app WhatsApp Business pode ser registrado.
  • Desde a coexistência, usar o número que você já divulga não significa mais apagar a conta do celular — ele funciona no app e na API ao mesmo tempo.
  • Número virtual compartilhado é o caminho que mais falha, porque o código de verificação precisa chegar a você e porque número reciclado costuma ter conta ativa no WhatsApp comum.
  • Dois prazos derrubam implantação: 14 dias para registrar o número depois do cadastro incorporado e 24 horas para puxar o histórico, que é uma tentativa só.
  • A própria Meta recomenda não começar com número de teste ou pessoal, porque trocar depois é difícil.

Que número a API oficial do WhatsApp aceita?

Aceita um número que seja seu, que consiga receber o código de verificação e que não esteja em uso no WhatsApp comum. Essa última parte é a que decide a sua implantação, e é justamente a que mais aparece errada na busca. Antes de escolher o número do seu atendente de IA no WhatsApp, vale saber que a resposta mudou: o conselho de “compre um número novo e apague o WhatsApp do celular” é de um tempo em que a coexistência não existia.

A documentação da Meta sobre gestão de números é curta e clara nos dois pontos que importam: números já em uso no aplicativo WhatsApp não são suportados, e números em uso no aplicativo WhatsApp Business podem ser registrados. A mesma página recomenda não usar um número de teste ou pessoal no cadastro, porque trocar depois é difícil.

O que ela não faz é publicar lista de operadora, de tipo de linha ou de portabilidade. Então a pergunta útil não é “que tipo de chip serve?”, e sim “esse número está livre, chega até mim e vai continuar comigo daqui a três anos?”.

Seu número está no WhatsApp comum ou no WhatsApp Business?

Essa é a primeira pergunta a responder, porque ela separa dois caminhos completamente diferentes. Muita gente usa “WhatsApp Business” como sinônimo de “WhatsApp do trabalho” e nem sabe qual aplicativo está no celular — é o ícone verde com o telefone (comum) ou o ícone com a letra B (Business).

Onde o número está hojeO que a Meta permiteO que você faz
App WhatsApp BusinessPode ser registrado na API, pela coexistênciaConecta e continua usando o celular normalmente
WhatsApp comumNão é suportado nesse estadoPrecisa sair desse aplicativo antes, ou escolher outro número
Nenhum dos dois (linha nova ou sem WhatsApp)Entra direto na APIComeça do zero, sem histórico e sem reputação
Elaborado pelo Hernesto a partir da documentação da Meta sobre gestão de números e sobre coexistência. Consulta em 10/11/2026.

Se o número do seu negócio está no WhatsApp comum, você tem duas saídas: migrar esse número para o app WhatsApp Business antes de conectar — o que deixa a coexistência disponível — ou aceitar que ele saia do celular. A primeira preserva o aparelho como está; a segunda costuma assustar quem atende no balcão.

Número novo ou o número que você já divulga?

Depende do que custa mais caro para você: refazer a divulgação ou dividir a operação em dois números. O número que você já divulga carrega reputação, está no Google Meu Negócio, nos cartões, na bio do Instagram e na cabeça dos clientes antigos. Um número novo não carrega nada disso — e esse “nada” inclui as conversas que provam que você é você.

CaminhoQuando faz sentidoO que você aceita
O número que você já divulga, pela coexistênciaQuase sempre: negócio com clientela, divulgação feita e equipe pequenaAs limitações da coexistência, como listas de transmissão só para leitura
Número novo dedicadoOperação com setores, volume alto, ou quando o número atual é o celular pessoal do donoRefazer divulgação e começar do zero em reputação
Número virtual ou VoIP compartilhadoPraticamente nunca, para o número principal do negócioRisco de não ativar, de perder a linha e de ficar sem o número depois
Árvore de decisão do Hernesto. Consulta às regras da Meta em 10/11/2026.

Um detalhe que ajuda a decidir: você não precisa escolher para sempre entre um e outro. A documentação de contas de negócio diz que a conta começa com dois números registrados e pode chegar a 20. Dá para conectar o número principal agora e acrescentar um segundo depois, quando a operação crescer — e aí vale conferir também os limites que valem para quem ainda não verificou o negócio.

Número virtual funciona na API oficial?

Funciona em tese e falha com frequência na prática, e o motivo não é mágica: as duas condições que a Meta impõe são exatamente as que um número virtual barato não garante. A primeira é receber o código de verificação. A segunda é não estar em uso no WhatsApp comum.

Um número virtual compartilhado é, por definição, um número que mais gente pode acessar. Se o código de verificação cai numa caixa que não é só sua, você não controla o cadastro. E número reciclado, que já pertenceu a outra pessoa, costuma ter conta ativa no WhatsApp comum — o caso que a documentação diz não ser suportado. Some a isso o fato de que a linha pode simplesmente deixar de ser renovada pelo fornecedor, e o número que está impresso no seu material some.

Vale também desconfiar da origem do conselho. Boa parte das páginas que recomendam número virtual para a API oficial pertence a quem vende número virtual. Não é desonestidade necessariamente, mas é um conselho com interesse embutido, e ele compete com o caminho mais seguro, que é usar o número que você já tem.

O que vem junto do número antigo (e o que fica para trás)?

Vem o que a Meta chama de sincronização da coexistência, e ela tem contorno bem definido. A documentação da coexistência diz que todos os contatos com número de WhatsApp podem ser sincronizados, que as conversas dos seis meses mais recentes podem ser sincronizadas e que conversas em grupo não são sincronizadas.

180 dias

de conversas individuais é o que a coexistência pode trazer do app para a API. Identificador de mídia só chega para o que foi enviado nos 14 dias em torno da conexão, e grupo não vem.

Meta para Desenvolvedores, consulta em 10/11/2026

Na prática isso significa três expectativas a ajustar antes de prometer qualquer coisa para a equipe. Primeira: o texto das conversas antigas chega, mas as fotos e os áudios antigos, em geral, não — a documentação só promete identificador de mídia para o que foi enviado perto da conexão. Segunda: grupo não existe do lado da API, então o que a sua equipe resolve em grupo continua só no celular. Terceira: o cliente precisa autorizar o compartilhamento. Quando ele recusa, a sincronização simplesmente não traz nada, e isso é um resultado normal, não um defeito da plataforma.

Quem for comparar o antes e o depois com calma encontra o resto das consequências no guia da API oficial do WhatsApp, que detalha a coexistência, inclusive a regra de janela de 24 horas que pega todo mundo de surpresa.

Quais prazos derrubam a implantação?

São dois, e os dois são curtos. O primeiro: a documentação de gestão de números diz que o número precisa ser registrado em até 14 dias depois do cadastro incorporado, ou o processo precisa ser refeito. O segundo: depois da conexão de coexistência, há 24 horas para sincronizar o histórico — passou disso, o cliente precisa ser desconectado e refazer o fluxo inteiro.

E tem um detalhe que muda o jeito de implantar: a sincronização é uma tentativa só. A Meta escreve que essa etapa só pode ser feita uma vez e que, para repetir, o cliente precisa primeiro sair e completar o cadastro de novo. Não existe “tenta de novo amanhã”.

Na hora de marcar a conexão com a sua equipe, isso vira uma lista curta:

  1. Conecte num horário em que alguém possa acompanhar, não na sexta à noite.
  2. Mantenha o app WhatsApp Business aberto durante a sincronização, que pode levar alguns minutos.
  3. Confirme o compartilhamento do histórico no próprio celular quando o aviso aparecer.
  4. Confira no mesmo dia se as conversas antigas apareceram, enquanto ainda dá para pedir ajuda.

O que não dá para desfazer depois?

Três coisas, e todas valem uma conversa antes. A primeira é o próprio número: a documentação da Meta recomenda não começar com número de teste ou pessoal porque é difícil trocar depois. Trocar o número da empresa não é só mexer num cadastro — é refazer material, avisar cliente e perder quem guardou o contato antigo.

A segunda é a sincronização do histórico, que é uma tentativa só, como a seção anterior explica. A terceira são as limitações que a coexistência traz para o aplicativo: entre outras, as mensagens temporárias em conversas individuais são desligadas e as listas de transmissão existentes passam a ser só para leitura. Se a sua rotina de vendas depende de lista de transmissão, isso não é detalhe — é mudança de processo.

Vale a pena? Para quem atende mais de uma pessoa no mesmo número, quase sempre: sai do improviso de dividir o celular entre atendentes, que tem os próprios limites, explicados em WhatsApp Business em dois celulares. Mas a decisão precisa ser tomada sabendo o que muda, e não depois que a lista de transmissão de quinta-feira parou de funcionar.

Perguntas frequentes

Posso usar na API o mesmo número que já uso no WhatsApp Business?

Pode. A documentação da Meta diz que números em uso no aplicativo WhatsApp Business podem ser registrados, e é a coexistência que permite manter o número funcionando no celular e na API ao mesmo tempo.

Preciso apagar minha conta do WhatsApp antes de entrar na API?

Não, se o número está no app WhatsApp Business: ele entra pela coexistência e continua no celular. Se o número está no WhatsApp comum, aí sim ele precisa deixar esse aplicativo, porque a Meta não suporta número nesse estado.

Número virtual funciona na API oficial do WhatsApp?

Pode funcionar, mas é o caminho com mais chance de dar errado. O número precisa receber o código de verificação e não pode estar em uso no WhatsApp comum — duas condições que números compartilhados ou reciclados frequentemente não cumprem.

Dá para trocar o número depois de registrar na API?

Não é simples. A própria documentação da Meta recomenda não usar número de teste ou pessoal no cadastro justamente porque trocar depois é difícil. Trate a escolha como definitiva.

Perco as conversas antigas ao migrar para a API?

Pela coexistência, as conversas individuais dos seis meses mais recentes podem ser sincronizadas, se o dono do número autorizar. Conversas em grupo não vêm, e as mídias antigas em geral também não.

Quantos números posso ter na mesma conta?

A documentação de contas de negócio diz que a conta começa com dois números registrados e que esse limite pode ser aumentado até 20.

Fontes e metodologia

Lemos em 10/11/2026 a documentação da Meta para desenvolvedores sobre gestão de números, coexistência e contas de negócio, e cada regra citada aqui vem de lá: número em uso no WhatsApp comum não suportado e número do app WhatsApp Business registrável, prazo de 14 dias para registrar, 24 horas para sincronizar o histórico, sincronização de uma vez só, 180 dias de conversas individuais, identificador de mídia só para o que foi enviado em 14 dias, grupos fora e limite de dois números por conta, ampliável até 20. A descrição de como a trava da sincronização funciona por dentro é da nossa própria implementação da coexistência no Hernesto, onde a reserva no banco acontece antes da chamada à Meta. O que não medimos: não temos número publicado sobre que proporção dos históricos chega de fato em produção, então o guia não afirma nada sobre isso. A árvore de decisão entre número novo, número atual e número virtual é uma síntese nossa, não um teste comparativo de fornecedores.

  1. Onboarding WhatsApp Business App Users (coexistência) — Meta para Desenvolvedores. Acesso em .
  2. Manage Phone Numbers (requisitos e prazo de registro) — Meta para Desenvolvedores. Acesso em .
  3. WhatsApp Business Accounts (limite de números por conta) — Meta para Desenvolvedores. Acesso em .
  4. Messaging Limits (limite inicial de envio) — Meta para Desenvolvedores. Acesso em .

Revisão editorial: este guia é conferido de novo até . Achou algo desatualizado? Escreva para suporte@hernesto.com.br.

Quem escreveu

Lucas Reda

Fundador do Hernesto

Conduz o produto e a integração com as plataformas da Meta: a conexão pela API oficial do WhatsApp, o Direct e os comentários do Instagram, as regras de janela de atendimento e os limites que a IA precisa respeitar antes de falar com o cliente de alguém.

Ver todos os guias de Lucas

Continue lendo

Uma caneta preta apoiada sobre uma pilha de papéis impressos em cima de uma mesa

API oficial do WhatsApp

Dá para usar a API oficial do WhatsApp sem CNPJ?

Dá para usar a API oficial do WhatsApp sem CNPJ? Os quatro portões da Meta, o limite inicial de 250, o que MEI e pessoa física conseguem e o que trava.

· 11 min de leitura