Como ter a API oficial do WhatsApp: passo a passo (2026)

Duas portas para a mesma API

Só existe uma API oficial: a WhatsApp Business Platform, cuja versão atual é a Cloud API, hospedada pela Meta. O que muda é por onde você entra. Na prática, a escolha depende menos de preço e mais de uma pergunta: quem vai cuidar da parte técnica?

Rota	Como entra	Como paga	O que você precisa	Número continua no app?	Para quem
Direto na Meta (Cloud API)	Você cria um app em developers.facebook.com, adiciona o caso de uso do WhatsApp e liga o portfólio	Cartão cadastrado na conta do WhatsApp, só a tarifa da Meta	Alguém que programe: webhook próprio, token permanente de usuário do sistema, chamada de registro do número	Não. A Meta só oferece Coexistência pelo cadastro de parceiros	Empresa com desenvolvedor e sistema próprio para integrar
Por provedor ou plataforma (Embedded Signup)	Você clica em conectar o WhatsApp na plataforma e uma janela da Meta faz portfólio, conta e número	Tarifa da Meta + mensalidade ou margem do provedor; o pagamento é combinado com ele	Login do Facebook com acesso ao portfólio e o número em mãos	Sim, se o provedor oferece (app do WhatsApp Business 2.24.17 ou mais novo)	Quem quer caixa de entrada, chatbot e disparo prontos, sem programar

A rota direta tem um atalho para testar: ao criar o app, a Meta gera uma conta e um número de teste que dispensam forma de pagamento. Segundo a documentação, dá para mandar a primeira mensagem de teste para o seu celular com o token temporário da tela de configuração, que expira em pouco tempo. Para produção, o seu desenvolvedor cria um usuário do sistema no portfólio e gera um token permanente. Quem prefere a segunda porta encontra no comparativo dos melhores provedores de API oficial do WhatsApp a margem que cada um cobra sobre a tabela da Meta, e as análises da 360dialog (licença fixa por número, sem margem) e da Twilio (pensada para quem programa) mostram os dois extremos do mercado.

Passo a passo para ter a API oficial

1Escolha a rota antes de criar qualquer conta

A pergunta é uma só: alguém da empresa vai programar? Se sim, a rota direta na Meta custa apenas a tarifa por mensagem, e o trabalho fica com o seu desenvolvedor (receber as mensagens num webhook, guardar o token, montar a tela de atendimento). Se não, a rota é um provedor ou uma plataforma que conecta o número pelo assistente oficial da Meta, o Embedded Signup. Nos dois casos a API é a mesma Cloud API, hospedada pela Meta: a versão instalada em servidor próprio (On-Premises) teve o último cliente expirado em 23 de outubro de 2025 e não aceita cadastro novo.

2Crie ou escolha o Portfólio Empresarial com o nome legal certo

O Portfólio Empresarial (o antigo Gerenciador de Negócios, em business.facebook.com) é quem vai ser dono de tudo. Use o que a empresa já tem para o Instagram e os anúncios, se houver, e confira dois campos antes de seguir: o nome legal tem de ser idêntico à razão social do cartão CNPJ, com Ltda, SLU ou ME do jeito que está lá. Prefira informar um site no ar, com HTTPS e a razão social no rodapé: a Meta usa o domínio como uma das formas de confirmação (HTTPS e rodapé são recomendação nossa). Uma letra diferente aqui é o tipo de divergência que faz a verificação voltar recusada semanas depois. Deixe pelo menos duas pessoas da empresa com controle total: a verificação só pode ser iniciada por quem tem esse nível de acesso.

3Separe o número e decida o que acontece com o app

O número precisa ser da empresa, ter DDI e DDD e receber SMS ou ligação para o código. Fixo serve; em fixo, peça o código por ligação. Se o número já tem WhatsApp, há dois caminhos: apagar a conta do aplicativo antes de registrar na API, o que tira o número do celular, ou usar a Coexistência pelo provedor, que mantém o app do WhatsApp Business funcionando junto com a API. No cadastro você cria o PIN de verificação em duas etapas, com seis dígitos. Anote em lugar que não dependa de um funcionário: sem ele não se remove o número, e a migração fica mais difícil.

4Crie a conta do WhatsApp e escreva o nome de exibição pela regra da Meta

Pelo assistente do provedor ou pelo painel de desenvolvedor, você cria a conta do WhatsApp Business (WABA) dentro do portfólio, com nome de exibição, categoria e fuso horário. O nome precisa ter relação clara com a razão social ou com a marca que aparece no site e nas redes. Termo genérico sozinho (“Pizzaria”), nome de lugar sozinho (“Recife”), as palavras “Oficial” ou “Verificado”, menção a Meta ou WhatsApp e formato de site ou e-mail são recusados. Marca que não lembra a razão social pode usar “Marca by Razão Social”. A tabela mais abaixo traz exemplos de negócios brasileiros.

5Cadastre o pagamento e registre o número

Na rota direta, você cadastra um cartão na conta do WhatsApp (Configurações da empresa, contas do WhatsApp, pagamento) e o seu desenvolvedor chama o endpoint de registro do número com o PIN: adicionar o número no painel não basta para enviar pela Cloud API. Na rota por provedor, a Meta manda combinar o pagamento com ele (saldo pré-pago, cartão na plataforma ou linha de crédito do parceiro). Desde julho de 2026 a Meta abre contas do WhatsApp em real para empresas com país de cobrança Brasil, e quem é faturado mensalmente por linha de crédito recebe fatura da Facebook Serviços Online do Brasil, paga por boleto.

6Comece a atender e peça a verificação no mesmo dia

Você não precisa esperar a verificação para responder clientes: a Meta libera o envio logo após o cadastro, com teto de 250 contatos em 24 horas iniciados pela empresa e 2 números por portfólio. Em paralelo, abra a Central de Segurança do Meta Business Suite e clique em iniciar verificação. A Meta procura um registro que corresponda aos dados informados; se não encontrar, pede documento (registro da empresa, documento fiscal emitido pelo governo ou extrato bancário da pessoa jurídica) e depois confirma por e-mail, telefone, SMS, WhatsApp ou domínio. O prazo oficial é de até 14 dias úteis para a decisão.

Se o objetivo final é um chatbot, os passos 3 a 5 acontecem dentro da plataforma escolhida, na mesma janela da Meta, e o resto do trabalho (fluxos, teste, divulgação) está em como criar um chatbot para WhatsApp. Quem ainda está no aplicativo e não sabe se precisa da API encontra a comparação em diferença entre WhatsApp Business e WhatsApp normal.

Nome de exibição: o que passa e o que volta

O nome aparece no topo da conversa e na lista de chats só depois de aprovado; antes disso fica apenas no perfil. A revisão não acontece no primeiro dia: a Meta só analisa o nome quando o portfólio se qualifica para limites maiores. Os exemplos abaixo são ilustrativos, montados pela redação sobre as diretrizes da Central de Ajuda da Meta; a decisão final é sempre da revisão.

Nome pedido	Razão social e presença	Tendência	Por quê
Odonto Sorriso Campinas	Odonto Sorriso Clínica Ltda, site com a mesma marca	Tende a passar	Relação direta com a razão social e com a marca pública
Pizzaria	Forno Bello Alimentos ME	Recusado	Termo genérico sozinho, sem marca
Loja Oficial Casa Verde	Casa Verde Decorações Ltda	Recusado	A palavra “Oficial” está vetada; use “Casa Verde Decorações”
Dra. Paula Mendes	Paula Mendes Dermatologia Ltda, site e Instagram como clínica	Pode passar	Nome de pessoa é aceito quando fontes externas mostram a natureza do negócio
Fala Inglês by Leme Idiomas	Leme Idiomas Ltda, marca Fala Inglês no site	Tende a passar	O formato “by” é o que a Meta indica quando a marca não lembra a razão social
WhatsApp Vendas Leme	Leme Idiomas Ltda	Recusado	Menção a WhatsApp no nome

Dá para trocar o nome até 10 vezes a cada 30 dias. Depois de uma troca aprovada, o número precisa ser registrado de novo em até 14 dias, detalhe que costuma pegar quem está na rota direta.

O que cada etapa libera (e o que ainda trava)

A dúvida mais comum depois do cadastro é "por que não consigo mandar para a minha lista inteira?". A resposta está na escada de limites, que desde 7 de outubro de 2025 vale por portfólio: todos os números do mesmo portfólio dividem o mesmo teto. Conferido na documentação da Meta em 23 de setembro de 2026:

Quando	Libera	Ainda trava	Fonte
Logo após o cadastro	Respostas ilimitadas a quem escreveu (janela de 24 horas), 250 contatos por dia iniciados pela empresa, 2 números no portfólio	Campanha para lista maior que 250 pessoas por dia; terceiro número	Meta, Messaging limits e Phone numbers
Empresa verificada, ou 2.000 templates de qualidade alta entregues a pessoas diferentes em 30 dias	2.000 contatos por dia (depois de a Meta revisar a qualidade), até 20 números, nome de exibição elegível para revisão	Selo azul ainda não; exige conta oficial	Meta, Messaging limits, Phone numbers e Central de Ajuda (nome de exibição)
Usou metade do limite nos últimos 7 dias com qualidade alta	Degrau seguinte (10.000, 100.000, ilimitado) em até 6 horas, automático	Nada novo; queda de qualidade não rebaixa mais o limite desde outubro de 2025	Meta, Messaging limits
30 dias ou mais na plataforma, empresa verificada, duas etapas ativas, nome aprovado	Pedido de conta oficial (selo azul), que exige empresa notória na imprensa	Tende a ser negado sem cobertura em veículos de grande circulação (conteúdo pago não conta); novo pedido só após 30 dias	Meta, Official Business Accounts

O limite conta pessoas diferentes alcançadas fora da janela de atendimento em 24 horas corridas, não mensagens. Uma loja que só responde quem chama pelo link do WhatsApp nunca esbarra nele. Quem planeja campanha deve ler o degrau antes: a conta completa está em como fazer disparo em massa no WhatsApp. O limite atual aparece no Gerenciador do WhatsApp, em Ferramentas da conta, Limites de mensagens.

A checagem de posse: de quem é a conta?

Esta é a parte que o assistente de cadastro não mostra, e é a que dói quando a empresa troca de provedor ou de agência. A API oficial é portátil por desenho: número e nome aprovado podem ser migrados entre provedores. Mas só migra quem controla as peças. Responda às cinco perguntas logo depois do cadastro:

Pergunta	Onde conferir	Está certo se	Sinal de alerta
A conta do WhatsApp está no portfólio da sua empresa?	Configurações da empresa, Contas, Contas do WhatsApp	A conta aparece no seu portfólio e o provedor aparece como parceiro com acesso	A conta só existe no portfólio do provedor e você a vê como compartilhada, ou não a vê
Quem sabe o PIN de duas etapas?	Anotação interna da empresa	O PIN está guardado pela empresa, não só no provedor ou com um funcionário	Ninguém da empresa sabe; migrar ou desconectar o número vai depender de terceiros
Quantas pessoas da empresa têm controle total do portfólio?	Configurações da empresa, Usuários, Pessoas	Duas ou mais, com e-mail da empresa	Uma só, ou apenas a agência que fez a instalação
O chip ou a linha fixa está em nome da empresa e acessível?	Operadora	A linha recebe SMS ou ligação hoje, na loja ou com o responsável	Chip de ex-funcionário ou pré-pago que pode ser desativado
Quem paga a Meta e em qual moeda?	Conta do WhatsApp, Pagamento; ou o painel do provedor	Você sabe se paga direto (cartão) ou pelo provedor, e a conta está em real	Conta antiga em dólar com cobrança no Brasil: a Meta marcou 30 de junho de 2027 como prazo para migrar para real

Duas respostas em alerta já justificam uma conversa com quem fez a instalação antes de qualquer campanha. A perda de acesso a um número que vende é parecida, nas consequências, com o banimento: o plano de contingência de como recuperar conta do WhatsApp banida serve para os dois casos.

Quanto custa o primeiro mês: escola de idiomas em Recife

Exemplo ilustrativo, com volume típico de pequena empresa, calculado pela redação com a tabela da Meta para números brasileiros: escola de inglês em Recife com um número, cerca de 450 conversas por mês iniciadas por alunos e interessados, 1.400 respostas enviadas pela escola dentro da janela de 24 horas e 350 lembretes de aula mandados como template de utilidade fora da janela de 24 horas (quando o aluno não escreveu na véspera). Nenhuma campanha de marketing.

Até 30 de setembro de 2026: respostas grátis + 350 × R$ 0,0350 = R$ 12,25 de Meta no mês.
A partir de 1º de outubro de 2026: as primeiras 1.000 respostas do mês continuam grátis (franquia por número), as 400 restantes pagam a tarifa de utilidade: 400 × R$ 0,0350 = R$ 14,00. Somando os lembretes, a conta da Meta fica em R$ 26,25, se a tabela em real se mantiver. As ressalvas estão em preço da API do WhatsApp em 2026.
O que decide a conta é a rota: direto na Meta, os R$ 26,25 são tudo, mas alguém programou e mantém a integração. Por provedor, soma-se a mensalidade: de R$ 0 em alguns planos gratuitos com canal oficial (segundo o comparativo de provedores) até centenas de reais em plataformas com equipe e IA, ou € 49 por número na licença mais barata da 360dialog (conferida no comparativo de provedores em 7 de setembro de 2026).

Repare na proporção: nesse porte, quando há mensalidade de provedor, a tarifa da Meta costuma ser a menor linha da conta. Quem compara provedores só pela margem por mensagem tende a subestimar a conta; a mensalidade e as horas de quem programa pesam mais.

Prefere a porta sem programar?

A SendPulse conecta o número à Cloud API pelo assistente oficial da Meta, aceita Coexistência com o app do WhatsApp Business e entrega caixa de entrada e chatbot no mesmo plano.

Criar conta grátis na SendPulse →

ou compare os melhores chatbots para WhatsApp

Divulgação: alguns conteúdos do zapfunil incluem links de parceiros, pelos quais podemos receber comissão sem custo extra para você. Isso não influencia nossas avaliações.

Erros comuns e como confirmar que resolveu

O código de registro não chega: o número ainda está ativo num WhatsApp instalado, ou é fixo e você pediu SMS. Verificação: abra o WhatsApp no aparelho com esse chip; se as conversas aparecem, a conta existe e precisa ser apagada (ou o caminho é a Coexistência). Em linha fixa, peça o código por ligação.
Verificação recusada por nome: a razão social do portfólio difere do documento enviado. Verificação: copie a razão social do cartão CNPJ, cole no campo de nome legal e compare com o documento enviado, inclusive a sigla Ltda ou ME. Na leitura da redação, vale alinhar também o rodapé do site, porque divergências costumam gerar pedido de nova documentação.
Número adicionado, mensagem que não sai (rota direta): adicionar o número no Gerenciador do WhatsApp não o registra na Cloud API. Verificação: confirme com o desenvolvedor que a chamada de registro foi feita com o PIN de seis dígitos; sem ela, o número não envia pela API.
Integração que para sozinha no dia seguinte: o sistema está usando o token temporário da tela de configuração. Verificação: o token em produção deve ser de um usuário do sistema, com as permissões de gerenciamento e de mensagens do WhatsApp.
Terceiro número recusado: portfólio sem verificação fica em 2 números. Verificação: a Central de Segurança mostra o status da verificação; o teto sobe para 20 quando a empresa é verificada ou atinge o limite de 2.000. Enquanto isso, as rotas com dois números no aparelho estão em como adicionar dois números no WhatsApp Business.

Dicas antes de divulgar o número

Teste o número de fora: peça a alguém que não tem a empresa salva para abrir o link wa.me e confirme que a mensagem chega na plataforma, não no celular antigo. O validador de número de WhatsApp confere o formato com DDI e DDD antes de você imprimir o número em cartão ou fachada. E, na nossa recomendação, não peça a verificação com o site fora do ar: o domínio é uma das formas de confirmação que a Meta oferece, e um site que não abre elimina essa opção.

Próximos passos

Com a API ativa, a decisão seguinte é a ferramenta de atendimento. O ranking dos melhores chatbots para WhatsApp ordena as plataformas por custo real, e a análise da SendPulse detalha a plataforma parceira do zapfunil. Veja também todos os tutoriais e as ferramentas grátis.

Fontes consultadas em 23 de setembro de 2026

Como apuramos: lemos a documentação oficial da Meta e a Central de Ajuda listadas acima em 23 de setembro de 2026. Não abrimos portfólio novo, não registramos número e não submetemos verificação para este tutorial: os passos seguem a documentação, e os exemplos de nome de exibição e o cenário da escola são ilustrações da redação, não casos reais. A lista de documentos da Meta não cita documentos brasileiros pelo nome; a menção ao cartão CNPJ é a nossa leitura da categoria "registro da empresa". Tarifas em real (marketing R$ 0,3217, utilidade R$ 0,0350) da tabela oficial consultada em julho de 2026. A SendPulse é parceira de afiliados do zapfunil.

Perguntas frequentes

Quanto custa ter a API oficial do WhatsApp?

O cadastro não custa nada. A Meta cobra por mensagem entregue: na tabela em real consultada em julho de 2026, R$ 0,3217 por mensagem de marketing e R$ 0,0350 por utilidade ou autenticação para números brasileiros. A partir de 1º de outubro de 2026, a mensagem de atendimento passa a custar a tarifa de utilidade do país, com 1.000 mensagens de atendimento grátis por mês para cada número. Pela rota direta você paga só isso; por provedor, soma a mensalidade ou a margem dele.

Preciso de CNPJ para ter a API oficial?

Para começar, não: a Meta libera o envio logo após o cadastro, com o teto de 250 contatos por dia. Para verificar a empresa, sim, na prática: os documentos aceitos são de pessoa jurídica (registro da empresa, documento fiscal emitido pelo governo, extrato bancário da empresa), e a lista da Meta não cita documentos brasileiros pelo nome. MEI tem CNPJ, então serve (leitura da redação). Sem verificação, o único caminho para subir de degrau é entregar 2.000 templates de qualidade alta em 30 dias.

Quanto tempo leva para ter a API oficial?

Para o cadastro do portfólio, da conta e do número, a documentação da Meta não traz um prazo; pela documentação, o envio fica disponível depois do registro, com o limite inicial de 250 contatos em 24 horas. O que leva tempo é a verificação da empresa: a Meta fala em até 14 dias úteis para a decisão, e um erro de razão social leva a uma nova rodada de análise. A conta oficial com selo azul só pode ser pedida depois de 30 dias na plataforma.

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

Pode, de dois jeitos. Pela Coexistência, oferecida por provedores pelo cadastro oficial da Meta, o número continua no app do celular e passa a funcionar também na API; o que você digita no app segue grátis e o que sai pela API é cobrado. A Coexistência tem limites: 20 mensagens por segundo, grupos não sincronizam e listas de transmissão ficam só para leitura. O outro jeito é apagar a conta do app e registrar o número direto na API, e aí ele deixa de funcionar no celular.

É melhor contratar direto na Meta ou por um provedor?

Direto na Meta é mais barato quando você tem desenvolvedor, porque não há mensalidade nem margem, mas você monta tudo: webhook, token permanente, tela de atendimento e suporte. Provedor faz sentido quando a empresa quer atendimento, chatbot e disparo prontos, quer pagar tudo numa fatura só, com o provedor, ou quer ajuda na verificação. O comparativo de provedores do zapfunil mostra quanto cada um cobra por cima da tabela.

Ter a API oficial dá o selo azul?

Não. O selo azul é a conta oficial (Official Business Account), um pedido separado que exige 30 dias na plataforma, empresa verificada, verificação em duas etapas, nome de exibição aprovado e notoriedade em veículos de imprensa de grande circulação. A própria Meta avisa que a verificação da empresa não dá selo. Sem conta oficial, o nome de exibição aprovado continua aparecendo nas conversas, só que sem o selo azul.

E a tal API não oficial, que conecta pelo QR Code?

Não é a API do WhatsApp: são ferramentas que automatizam o WhatsApp Web lendo a tela do aplicativo. Violam os Termos de Serviço e o número pode ser banido sem aviso, levando histórico e contatos. Tudo o que este tutorial descreve é a WhatsApp Business Platform, a única API que a Meta oferece.

Como ter a API oficial do WhatsApp

Quanto a Meta vai cobrar pelo seu volume?