API oficial e regras do WhatsApp
Que número usar na API oficial do WhatsApp?
Por Lucas Reda
Fundador do Hernesto
Publicado em · 11 min de leitura

Neste artigo10 tópicos
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á hoje | O que a Meta permite | O que você faz |
|---|---|---|
| App WhatsApp Business | Pode ser registrado na API, pela coexistência | Conecta e continua usando o celular normalmente |
| WhatsApp comum | Não é suportado nesse estado | Precisa sair desse aplicativo antes, ou escolher outro número |
| Nenhum dos dois (linha nova ou sem WhatsApp) | Entra direto na API | Começa do zero, sem histórico e sem reputação |
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ê.
| Caminho | Quando faz sentido | O que você aceita |
|---|---|---|
| O número que você já divulga, pela coexistência | Quase sempre: negócio com clientela, divulgação feita e equipe pequena | As limitações da coexistência, como listas de transmissão só para leitura |
| Número novo dedicado | Operação com setores, volume alto, ou quando o número atual é o celular pessoal do dono | Refazer divulgação e começar do zero em reputação |
| Número virtual ou VoIP compartilhado | Praticamente nunca, para o número principal do negócio | Risco de não ativar, de perder a linha e de ficar sem o número depois |
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:
- Conecte num horário em que alguém possa acompanhar, não na sexta à noite.
- Mantenha o app WhatsApp Business aberto durante a sincronização, que pode levar alguns minutos.
- Confirme o compartilhamento do histórico no próprio celular quando o aviso aparecer.
- 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.
- Onboarding WhatsApp Business App Users (coexistência) — Meta para Desenvolvedores. Acesso em .
- Manage Phone Numbers (requisitos e prazo de registro) — Meta para Desenvolvedores. Acesso em .
- WhatsApp Business Accounts (limite de números por conta) — Meta para Desenvolvedores. Acesso em .
- 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
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.


