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

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.
| Caminho | Como funciona | Para quem faz sentido |
|---|---|---|
| Direto na Cloud API | A empresa cria um app no Meta for Developers, gera tokens e desenvolve a integração | Times de engenharia que vão construir o próprio sistema |
| Plataforma com cadastro incorporado | A empresa entra com a conta da Meta dentro da plataforma, escolhe o portfólio e conecta o número em poucas telas | Quem quer atender, vender e automatizar sem escrever código |
| Por um BSP | Um provedor de soluções de negócios (BSP) parceiro da Meta faz a conexão e pode oferecer suporte e faturamento próprios | Empresas 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.
| Item | O que a Meta pede | Onde configurar |
|---|---|---|
| Conta e portfólio | Conta do Facebook ou conta gerenciada da Meta e um portfólio empresarial | Meta Business Suite |
| Número de telefone | Número seu, com código de país e área, capaz de receber SMS ou ligação; códigos curtos não são aceitos | WhatsApp Manager ou cadastro incorporado |
| Número livre | Número que não esteja em uso em outra conta do WhatsApp, a não ser pela coexistência | App do WhatsApp ou WhatsApp Business no celular |
| Nome de exibição | Nome ligado à empresa e dentro das diretrizes da Meta | WhatsApp Manager |
| PIN de duas etapas | PIN de 6 dígitos definido no registro do número | WhatsApp Manager ou API |
| Pagamento | Forma de pagamento da conta de mensagens | Meta 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.
| Erro | O que acontece | Como evitar |
|---|---|---|
| Usar um número ativo no app sem planejar | O registro falha ou o histórico se perde | Decidir antes entre apagar a conta do app e usar a coexistência |
| Conta criada no portfólio da agência | A empresa perde o controle do número | Criar a conta no portfólio da própria empresa |
| Nome de exibição genérico ou com nome de pessoa | Nome recusado e mensagens bloqueadas | Usar o nome da marca, igual ao do site |
| Dados da verificação diferentes do CNPJ | Verificação recusada | Copiar nome legal e endereço do registro oficial |
| Número atrás de URA | O código de verificação não chega | Garantir que a ligação ou o SMS chegue a uma pessoa |
| Moeda errada na conta | A cobrança fica em outra moeda para sempre | Escolher 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.


