Pular para o conteúdo

Como conseguir a API oficial do WhatsApp Business: passo a passo

O que você precisa ter, os caminhos possíveis (direto com a Meta ou por um parceiro) e o passo a passo para ativar a API oficial do WhatsApp Business em 2026, com base na documentação da Meta.

Marlos Carmo

Fundador da Tolky

Atualizado em 16 de novembro de 2026

12 min de leitura
Como conseguir a API oficial do WhatsApp Business: passo a passo

Compartilhar

Quem pesquisa "como conseguir a API do WhatsApp" quase sempre está no mesmo ponto: o celular da empresa não dá mais conta, as conversas se perdem entre aparelhos e alguém sugeriu automatizar. A dúvida seguinte é se precisa de aprovação, quanto tempo leva e se o número atual pode ser aproveitado.

A boa notícia é que o acesso ficou mais simples. Desde que a Meta concentrou tudo na Cloud API, não há servidor para instalar e o cadastro pode ser feito em minutos. O que trava os projetos costuma ser o que vem antes: número já usado no app, portfólio sem verificação, nome de exibição recusado.

Este guia organiza o caminho com base na documentação oficial da Meta consultada em 16 de novembro de 2026. Regras da Meta mudam; confira sempre os links citados antes de planejar.

Atualizado em novembro de 2026.

O que é a API oficial do WhatsApp Business?

A API oficial do WhatsApp Business é a forma autorizada pela Meta de conectar um número de WhatsApp a sistemas, chatbots, agentes de IA e CRMs, com envio e recebimento de mensagens por software. Hoje ela é oferecida como Cloud API, hospedada pela própria Meta.

A antiga versão On-Premises, que a empresa instalava nos próprios servidores, foi encerrada. Segundo a Meta, desde 1º de julho de 2024 novos números só podem ser registrados na Cloud API, e a última versão do cliente On-Premises expirou em 23 de outubro de 2025. Fonte: encerramento da On-Premises API, consultada em 16/11/2026.

Na prática, "API oficial" é o oposto de ferramentas que simulam o WhatsApp Web, que expõem o número a bloqueio. Para entender as vantagens do canal oficial, veja os benefícios da WhatsApp Business API.

Quais são os caminhos para conseguir a API?

Há três caminhos para chegar à API oficial: montar a integração direto na Cloud API, conectar por uma plataforma que usa o cadastro incorporado da Meta ou contratar por um BSP. Os três levam ao mesmo lugar, um número registrado na Cloud API, mas mudam quem cuida da tecnologia.

CaminhoComo funcionaPara quem faz sentido
Direto na Cloud APIA empresa cria um app no Meta for Developers, gera tokens e desenvolve a integraçãoTimes de engenharia que vão construir o próprio sistema
Plataforma com cadastro incorporadoA empresa entra com a conta da Meta dentro da plataforma, escolhe o portfólio e conecta o número em poucas telasQuem quer atender, vender e automatizar sem escrever código
Por um BSPUm provedor de soluções de negócios (BSP) parceiro da Meta faz a conexão e pode oferecer suporte e faturamento própriosEmpresas que preferem um contrato com o provedor e suporte dedicado

O cadastro incorporado (Embedded Signup, na documentação) é o fluxo em que o login da Meta abre dentro da ferramenta do parceiro. A empresa autoriza o acesso, cria ou escolhe a conta do WhatsApp e verifica o número sem sair da plataforma. Fonte: visão geral do Embedded Signup, consultada em 16/11/2026.

O que você precisa ter antes de começar?

Antes de qualquer cadastro, separe cinco itens: acesso a um portfólio empresarial da Meta, o número que será usado, o nome de exibição, os dados da empresa para a verificação e uma forma de pagamento. A tabela resume o que a documentação pede e onde cada item é configurado.

ItemO que a Meta pedeOnde configurar
Conta e portfólioConta do Facebook ou conta gerenciada da Meta e um portfólio empresarialMeta Business Suite
Número de telefoneNúmero seu, com código de país e área, capaz de receber SMS ou ligação; códigos curtos não são aceitosWhatsApp Manager ou cadastro incorporado
Número livreNúmero que não esteja em uso em outra conta do WhatsApp, a não ser pela coexistênciaApp do WhatsApp ou WhatsApp Business no celular
Nome de exibiçãoNome ligado à empresa e dentro das diretrizes da MetaWhatsApp Manager
PIN de duas etapasPIN de 6 dígitos definido no registro do númeroWhatsApp Manager ou API
PagamentoForma de pagamento da conta de mensagensMeta Business Suite

Fontes: primeiros passos na Cloud API e números de telefone comerciais, consultadas em 16/11/2026.

O número precisa ser novo?

Não, mas precisa estar livre. Pela documentação, números em uso no WhatsApp só podem ser registrados na API depois de apagados da conta atual. A exceção é a coexistência, que mantém o número no app WhatsApp Business e o conecta à API ao mesmo tempo. Explicamos o recurso em coexistência no WhatsApp: o app e a API no mesmo número.

Passo a passo para conseguir a API oficial

O caminho mais comum, por cadastro incorporado, tem cinco passos e pode ser concluído no mesmo dia quando os itens acima estão prontos. Quem integra direto na Cloud API passa pelos mesmos pontos, só que dentro do painel de desenvolvedor.

Passo 1: Organize o portfólio empresarial

Confirme quem é administrador do portfólio na Meta Business Suite. A conta do WhatsApp precisa ficar no portfólio da sua empresa, não no de uma agência ou de um funcionário. Isso evita perder o acesso ao número quando alguém sai.

Passo 2: Escolha o caminho e o provedor

Decida se vai integrar direto, usar uma plataforma com cadastro incorporado ou contratar um BSP. Pergunte ao provedor se a conta fica em seu nome, como funciona a cobrança da Meta e se ele suporta coexistência, caso queira manter o app.

Passo 3: Conecte a conta e verifique o número

No cadastro incorporado, você entra com a conta da Meta, escolhe o portfólio, cria a conta do WhatsApp (a documentação atual chama de Messaging account) e informa o número. A Meta envia um código por SMS ou ligação para confirmar a posse.

Passo 4: Defina o nome de exibição e o PIN

Informe o nome que aparecerá para os clientes e defina o PIN de verificação em duas etapas, de 6 dígitos. Um nome sem relação com a empresa, com nome de pessoa ou formatação fora das regras pode ser recusado. Guarde o PIN: ele é pedido para trocar o próprio PIN ou excluir o número.

Passo 5: Registre o número e configure o pagamento

O número precisa estar com status conectado para enviar e receber mensagens. Cadastre a forma de pagamento da conta de mensagens. No Brasil, a Meta fatura em reais pela Facebook Brasil desde 1º de julho de 2026, e a moeda escolhida na criação da conta não pode ser trocada depois. Fonte: preços da plataforma, consultada em 16/11/2026.

Preciso verificar a empresa na Meta?

A verificação do negócio não é obrigatória para começar, mas é ela que destrava limites maiores, mais números e o pedido de conta comercial oficial. É feita na Central de Segurança da Meta Business Suite.

Pelo processo descrito pela Meta, você informa nome legal, endereço, telefone e site da empresa, exatamente como constam no registro oficial. Se a Meta não encontrar o registro, pode pedir documentos como contrato social ou cartão de CNPJ e comprovantes de endereço. Depois, você confirma o vínculo por e-mail, telefone, SMS, WhatsApp ou verificação de domínio. Fonte: verificar a empresa na Meta Business Suite, consultada em 16/11/2026.

Com a empresa verificada e o nome aprovado, o número pode pedir o status de conta comercial oficial, que mostra a marca de verificação azul. Veja como solicitar a conta comercial oficial do WhatsApp.

Quais limites valem no começo?

Todo portfólio novo começa com limites baixos de envio e de números, que sobem conforme a empresa se verifica e envia mensagens de qualidade. Eles não afetam o atendimento a quem escreve primeiro, só o volume de contatos iniciados pela empresa.

  • Limite de mensagens: o portfólio novo começa em 250 usuários únicos por período móvel de 24 horas para mensagens fora da janela de atendimento. Os níveis seguintes são 2.000, 10.000, 100.000 e ilimitado. O limite vale para o portfólio inteiro, compartilhado entre os números.
  • Como subir para 2.000: verificar a empresa (ou ter a verificação feita pelo parceiro que fez o cadastro) ou enviar 2.000 mensagens fora da janela para números únicos em 30 dias, com templates de qualidade alta.
  • Números por portfólio: começa em dois números registrados e sobe para 20 quando a empresa é verificada ou atinge o limite de 2.000.

Fontes: limites de mensagens e números de telefone comerciais, consultadas em 16/11/2026.

Quanto custa usar a API oficial?

A Meta cobra por mensagem entregue desde 1º de julho de 2025, com valores diferentes por categoria e por país. Mensagens que o cliente envia para a empresa não são cobradas pela Meta. Plataformas e provedores cobram à parte pelo software.

Os valores e as regras mudaram de novo em 1º de outubro de 2026, quando mensagens de serviço e de utilidade dentro da janela passaram a ser cobradas, com franquia mensal de mensagens de serviço por número. Os detalhes estão no guia de custos do WhatsApp Business. Para estimar o custo com o seu volume, use o simulador de preços do WhatsApp, gratuito.

Fora da janela, a empresa só fala com templates aprovados e com quem deu opt-in. O roteiro de campanhas está em janela de 24 horas, templates e campanhas.

Erros comuns que atrasam a ativação

A maioria dos atrasos vem de detalhes de cadastro, não de tecnologia. Use a tabela como checklist antes de começar.

ErroO que aconteceComo evitar
Usar um número ativo no app sem planejarO registro falha ou o histórico se perdeDecidir antes entre apagar a conta do app e usar a coexistência
Conta criada no portfólio da agênciaA empresa perde o controle do númeroCriar a conta no portfólio da própria empresa
Nome de exibição genérico ou com nome de pessoaNome recusado e mensagens bloqueadasUsar o nome da marca, igual ao do site
Dados da verificação diferentes do CNPJVerificação recusadaCopiar nome legal e endereço do registro oficial
Número atrás de URAO código de verificação não chegaGarantir que a ligação ou o SMS chegue a uma pessoa
Moeda errada na contaA cobrança fica em outra moeda para sempreEscolher BRL na criação, se a empresa fatura no Brasil

Onde a Tolky entra?

A Tolky é um AI CRM conversacional que se conecta à API oficial do WhatsApp Business, direto com a Meta (Cloud API) ou pela Gupshup, parceira oficial da Meta. Na conexão direta, você usa o botão "Conectar com Meta", que abre o cadastro incorporado: entra com a conta da Meta, escolhe o portfólio e conecta o número, sem instalar nada.

Quando habilitada para a sua conta, a coexistência mantém o número no app WhatsApp Business do celular. Nesse caso, se alguém do time responde pelo celular, a IA pausa naquela conversa. Depois de conectado, o número passa a ser atendido por agentes de IA, com transição para pessoas e histórico no CRM. Veja a integração com o WhatsApp e a solução de atendimento no WhatsApp.

A Tolky não substitui as regras da Meta: verificação do negócio, aprovação de nome e limites de envio continuam valendo para qualquer provedor. Também não há canal de SMS nem de e-mail na plataforma.

Perguntas frequentes

Preciso de CNPJ para conseguir a API oficial do WhatsApp?

Para começar, a Meta pede um portfólio empresarial e um número válido. Para verificar o negócio, porém, é preciso comprovar nome legal, endereço e telefone da empresa, o que no Brasil normalmente envolve o CNPJ. Sem verificação, a empresa fica nos limites iniciais.

Quanto tempo leva para ativar a API?

Com portfólio, número livre e nome de exibição prontos, o cadastro incorporado pode ser concluído no mesmo dia. A verificação do negócio e a revisão do nome podem levar mais tempo e não têm prazo fixo publicado pela Meta.

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

Sim, de duas formas. Você pode apagar a conta do app e registrar o número na API, ou usar a coexistência, quando disponível, para manter o número no app e na API ao mesmo tempo, com o histórico de até 180 dias sincronizado.

Dá para usar a API oficial sem programar?

Sim. Plataformas com cadastro incorporado fazem a conexão em poucas telas e já trazem atendimento, campanhas e automações prontos. Programar só é necessário quando a empresa quer construir o próprio sistema sobre a Cloud API.

Como a Meta cobra pelo uso da API oficial?

Segundo a página de preços da Meta, a cobrança é por mensagem entregue, com valor por categoria e por país, e a fatura sai na Meta Business Suite. Plataformas e provedores cobram o próprio software à parte. Veja o guia de custos.

Qual a diferença entre BSP e plataforma com cadastro incorporado?

O BSP é um parceiro da Meta que fornece o acesso à API e pode oferecer suporte e cobrança próprios. Uma plataforma com cadastro incorporado conecta o número dentro da própria ferramenta. Algumas plataformas oferecem os dois caminhos.

O que acontece se eu sair da plataforma depois?

Se a conta do WhatsApp estiver no portfólio da sua empresa, o número continua seu e pode ser conectado a outro provedor, seguindo o processo de migração da Meta. Por isso vale criar a conta no próprio portfólio desde o início.


Conclusão

Conseguir a API oficial do WhatsApp Business em 2026 é menos uma questão técnica e mais de preparo: portfólio em nome da empresa, número livre ou coexistência planejada, nome de exibição correto e verificação do negócio para crescer. Com isso em ordem, a conexão leva minutos, e o trabalho passa a ser o que fazer com as conversas. Para ver os outros temas, consulte o Guia do WhatsApp Business.

Veja a integração com o WhatsApp, consulte os planos ou fale com o time →. Vamos conversar?

Compartilhar

Tags

  • como conseguir a API oficial do WhatsApp
  • #WhatsApp Business API
  • Cloud API
  • cadastro incorporado
  • verificação do negócio Meta
  • BSP WhatsApp
  • número para WhatsApp API
  • limite de mensagens WhatsApp

Sobre o autor

Marlos Carmo

Fundador da Tolky

Marlos Carmo é empreendedor em IA e fundador da Tolky, a infraestrutura e AI CRM da era conversacional que unifica atendimento inteligente, multicanalidade (como WhatsApp e voz), CRM vivo e inteligência operacional em um único ecossistema. É finalista do SXSW Innovation Awards e integrante do Francesco's Economy, rede global de jovens empreendedores com foco em inovação e impacto social. Atua conectando Inteligência Artificial e transformação digital em projetos para grandes organizações.

Próximo passo

Quer levar isso para a sua operação?

A Tati, assistente de IA da Tolky, entende o seu cenário em poucas perguntas, sugere o melhor caminho e te conecta com uma pessoa do time levando todo o contexto.

Leia também