API oficial do WhatsApp

Qual número usar na API oficial do WhatsApp e como cadastrar

Resposta rápida

Para escolher o número para API oficial do WhatsApp, ele precisa ser seu, ter código do país e DDD e conseguir receber um código por SMS ou ligação. Celular é o tipo recomendado pela Meta; fixo e virtual funcionam por ligação. Número que já está no aplicativo só entra depois de excluído ou pela coexistência. Quem dispara pela estrutura da AD PRO não precisa levar número.

Por AD PRO TecnologiaPublicado em 7 min de leitura
Neste conteúdo (8 partes)

Qual número posso usar na API oficial do WhatsApp?

A regra da Meta vale para todos os tipos: o número precisa ser seu, ter código do país e código de área (números curtos, os short codes, não são suportados) e conseguir receber um código de verificação por SMS ou por ligação de voz. Dentro dessas condições, o tipo muda a facilidade do cadastro.

Tipos de número e como cada um recebe o código de cadastro (documentação da Meta)
Tipo de númeroCódigo por SMSCódigo por ligaçãoO que observar
CelularPadrãoPadrãoÉ o tipo recomendado pela Meta
Fixo (linha fixa)Não recomendadoPadrãoAlguém precisa atender a ligação do código na hora do cadastro
Virtual (VoIP)Não recomendadoPadrãoConfirme com o fornecedor que o número recebe SMS e ligações internacionais de código
0800 (toll-free)DependeDependeSó é aceito se receber chamadas internacionais e encaminhar a uma pessoa. Número atrás de URA que não atende o cadastro não é suportado
PagerNão suportadoNão suportadoNão serve

A documentação também marca como não recomendados os números compartilhados, pessoais, de tarifa premium, só de entrada e de máquina a máquina. Na dúvida entre celular e fixo, o celular encurta o cadastro. Se o nome de exibição também ainda é dúvida, veja nome de exibição do WhatsApp API.

Posso usar o número que já está no WhatsApp ou no WhatsApp Business?

É a dúvida que mais trava a primeira campanha. A documentação da Meta diz que números já em uso no WhatsApp não podem ser registrados na API sem serem excluídos antes. Existem três saídas:

Três caminhos para quem já usa o número no aplicativo
CaminhoComo funcionaVantagemCuidado
Número novo para a APIVocê registra outro número e mantém o antigo no aplicativoNão mexe no atendimento atualOs clientes passam a ver um número diferente nas campanhas
Excluir a conta do aplicativoVocê exclui a conta daquele número no aplicativo e só depois registra na APIMantém o número que o cliente já conheceFaça o backup do que precisa antes: o aplicativo deixa de ser usado naquele número
CoexistênciaO mesmo número fica no aplicativo WhatsApp Business e na API ao mesmo tempoAtendimento no celular e API em paraleloExige parceiro da Meta no cadastro, versão 2.24.17 ou mais nova do aplicativo e tem limites (abaixo)

Na coexistência, a Meta lista estes limites: velocidade fixa de 20 mensagens por segundo; grupos não são sincronizados nem suportados na API; listas de transmissão do aplicativo ficam desativadas (as existentes passam a somente leitura); mensagens temporárias e de visualização única ficam desativadas nas conversas individuais; e o cadastro desconecta os aparelhos vinculados, que depois podem ser vinculados de novo (WhatsApp para Windows não é suportado). Há 24 horas, depois do cadastro, para sincronizar o histórico de mensagens. Se o aplicativo ficar sem uso por cerca de 14 dias, a conexão pode cair.

Para campanhas grandes, a coexistência não é o melhor desenho, porque a velocidade é fixa em 20 por segundo (o padrão é 80 por segundo por número). O passo a passo para sair do aplicativo e entrar na API está em migrar WhatsApp Business para API oficial.

Como cadastrar o número na API oficial, passo a passo?

  1. 1
    Confirme que o número é seu

    A Meta exige que o número seja de propriedade da empresa. Chip no nome de um sócio ou de um funcionário é fonte de dor de cabeça quando a pessoa sai.

  2. 2
    Libere o número

    Se ele está no aplicativo, escolha entre excluir a conta ali ou fazer a coexistência. Se foi banido no WhatsApp, o recurso do banimento vem antes de qualquer registro.

  3. 3
    Defina o nome de exibição

    Ele é obrigatório no registro e aparece no perfil do número. Siga as regras de nome de exibição.

  4. 4
    Peça o código

    A Meta envia o código por SMS ou ligação de voz. Deixe o aparelho ou a linha à mão na hora do cadastro, com alguém pronto para receber o SMS ou atender a ligação.

  5. 5
    Defina o PIN de duas etapas

    O PIN é obrigatório no registro, é pedido para trocar o PIN ou excluir o número e só pode ser desligado no WhatsApp Manager. Guarde em local seguro, com mais de uma pessoa sabendo.

  6. 6
    Verifique o status

    O número só envia quando está conectado. Veja status do número do WhatsApp API.

  7. 7
    Verifique a empresa

    Isso eleva o teto de números e abre o caminho para limites maiores. Veja verificação da empresa na Meta.

Quantos números posso ter e mais números aumentam o volume?

Um portfólio novo começa limitado a dois números registrados. A Meta eleva o teto para 20 quando a empresa é verificada ou quando o portfólio chega ao limite de 2.000 pessoas em 24 horas. O ponto que surpreende: o limite de envio é por portfólio, e não por número, desde 7 de outubro de 2025. Todos os números do portfólio dividem o mesmo limite, e um número sozinho pode consumir tudo. Ter mais números ajuda a separar marcas, setores e atendimento, mas não multiplica a capacidade de disparo.

As faixas atuais são 250, 2.000, 10.000, 100.000 e ilimitado de pessoas diferentes em 24 horas. O detalhamento está em limite de envio do WhatsApp API. No disparo pela estrutura da AD PRO, a campanha sai do portfólio dela, e não do seu.

E se o número foi banido no WhatsApp ou a conta está restrita?

Número banido no WhatsApp precisa de recurso antes de ser registrado na API; a Meta é direta nesse ponto. Já a restrição que a Meta aplica a uma conta da API (por violar a política) é outro assunto, com prazos e recurso próprios, explicado em conta restrita no WhatsApp API. Os Termos do WhatsApp proíbem o envio em massa automatizado e o uso de versões modificadas do aplicativo, e o WhatsApp informa que usa aprendizado de máquina e denúncias de usuários para detectar e banir contas.

O que cuidar ao trocar o número ou migrar de provedor?

  • O PIN antes de tudo. Ele é exigido para trocar o PIN e para excluir o número. Sem ele, a migração para.
  • Número entre contas. A Meta permite migrar números de uma conta do WhatsApp Business para outra. As regras do fluxo estão no guia de migrar número entre provedores.
  • Templates. Cada idioma é um template e conta no limite da conta. Confira o que acompanha a migração antes de desligar o provedor atual.
  • Janela de pausa. Faça a troca fora de data de campanha. Um número que muda no meio de um disparo gera atendimento duplicado e dúvida no cliente.
Ficha de decisão do número (copie e preencha)
Número candidato: (__) _____-____
O número é da empresa (CNPJ) e não de uma pessoa?  [ ] sim  [ ] não
Tipo:  [ ] celular  [ ] fixo  [ ] virtual  [ ] 0800
Recebe SMS?  [ ] sim  [ ] não    Recebe ligação de voz?  [ ] sim  [ ] não
Está no aplicativo WhatsApp ou WhatsApp Business?  [ ] não  [ ] sim
  Se sim, escolha: [ ] excluir a conta do aplicativo  [ ] coexistência  [ ] usar número novo
Foi banido alguma vez no WhatsApp?  [ ] não  [ ] sim (fazer o recurso antes)
Nome de exibição escolhido: ______________________
PIN de duas etapas guardado por: ______________________ e ______________________
Uso principal:  [ ] atendimento  [ ] campanhas  [ ] os dois
Decisão:  [ ] registrar na minha API  [ ] disparar pela estrutura da AD PRO

Quem dispara pela AD PRO precisa ter número próprio?

Se o seu caso é só campanha, o desenho de disparo em massa sem API própria costuma ser o mais curto: você envia a planilha, a copy e o criativo; a AD PRO trata a base, envia o teste em números reais e dispara depois da sua aprovação. Se o número da empresa precisa ser o remetente das campanhas, a estruturação na sua conta é o caminho, e o hub de disparo em massa mostra as duas opções lado a lado. Para entender os custos de cada uma, veja quanto custa disparo em massa.

Perguntas frequentes

Posso usar um número fixo na API oficial do WhatsApp?

Pode, desde que o número seja seu, tenha código do país e de área e receba a ligação com o código de verificação. A Meta marca o SMS como não recomendado para linha fixa, então o código vem por ligação de voz. Alguém precisa atender na hora.

Posso usar o número do WhatsApp Business que já uso no celular?

Só depois de excluir a conta daquele número no aplicativo ou pela coexistência, que mantém o número no aplicativo e na API ao mesmo tempo. A coexistência tem limites: velocidade fixa de 20 mensagens por segundo e listas de transmissão desativadas.

Posso usar um número virtual (VoIP) na API?

A Meta aceita número virtual, com código por ligação de voz, e marca o SMS como não recomendado. Antes de comprar, confirme com o fornecedor que o número recebe SMS e ligações internacionais de código.

Quantos números posso registrar na API oficial?

Um portfólio novo começa com dois números e vai a 20 depois da verificação da empresa ou ao atingir o limite de 2.000 pessoas em 24 horas. O limite de envio é por portfólio, então mais números não aumentam o volume que você pode disparar.

A AD PRO precisa do meu número para disparar?

Não. No serviço de disparo, a campanha sai pela API oficial, na estrutura da AD PRO. Você só precisa de número próprio se contratar a estruturação da API oficial na sua conta, com valor base de R$ 2.000.

Fontes
AD PRO Tecnologia

Dispare sem registrar número nenhum

Envie a planilha e a copy para a AD PRO. A campanha sai pela API oficial, na estrutura dela, depois do teste que você aprova.

  • Disparo pela API oficial do WhatsApp, da estrutura da AD PRO
  • Base tratada: sem duplicados, números validados, DDI e DDD padronizados
  • Teste em números reais antes de disparar, com a sua aprovação
  • Preço final já com a tarifa da Meta, pago só pelo que foi entregue
  • Relatório de entrega por campanha

Já é cliente? Crie a demanda, aprove o teste e baixe o relatório no portal de disparos, operado com a Nexor Company, empresa parceira do mesmo grupo.

Suas informações ficam com o time da AD PRO. Nada de spam.