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

Como ativar a API oficial do WhatsApp: pré-requisitos, Meta ou BSP, verificação da empresa, nome de exibição, número, templates, custos e erros.

Para ativar a API oficial do WhatsApp Business você precisa de quatro coisas: um portfólio empresarial na Meta (o antigo Gerenciador de Negócios), uma conta do WhatsApp Business (WABA), um número de telefone que possa receber SMS ou ligação e um nome de exibição que represente a sua empresa. Com isso, você conecta o número à Cloud API, diretamente pela Meta ou por meio de um provedor parceiro (BSP), cadastra uma forma de pagamento e começa a enviar mensagens. A verificação da empresa não é obrigatória para dar o primeiro passo, mas é ela que libera volume e mais números.

A parte técnica é rápida. O que trava é documentação desencontrada, número mal escolhido e nome de exibição recusado.

Atenção: se você ainda está decidindo entre API oficial e ferramentas que "leem o QR Code", leia antes API oficial do WhatsApp x não oficial. Este guia parte do princípio de que você já escolheu o caminho oficial.

Pré-requisitos

Antes de abrir qualquer painel, separe:

• Conta pessoal no Facebook de quem vai administrar (um sócio ou alguém fixo da empresa, não um freelancer).
• Portfólio empresarial na Meta com o nome jurídico, endereço e site da empresa, iguais aos do cartão CNPJ.
• Site no ar com o nome da empresa visível. Ajuda muito na verificação e na aprovação do nome. Se você não tem um, veja quanto custa um site ou uma landing page simples.
• E-mail no domínio da empresa (contato@suaempresa.com.br), para a verificação por e-mail.
• Número de telefone que você controle, com código de país e DDD. Short codes não são aceitos.
• Cartão de crédito ou outra forma de pagamento para a conta de cobrança do WhatsApp.
• Documentos da empresa: cartão CNPJ, contrato social ou outro documento oficial, e uma conta de consumo ou extrato com o mesmo endereço, caso a Meta peça comprovação.

Direto pela Meta ou via BSP?

Os dois usam a mesma Cloud API, hospedada pela Meta. Muda quem integra e quem dá suporte.

Nossa recomendação: se você tem um desenvolvedor e vai construir um chatbot ou integração sob medida, o acesso direto é mais barato e flexível. Se a sua equipe precisa de uma caixa de entrada pronta amanhã e não tem ninguém técnico, um BSP resolve. Em qualquer caso, exija que o portfólio, a WABA e o número fiquem no nome da sua empresa.

Passo a passo direto pela Meta

1. Crie ou organize o portfólio empresarial

No Meta Business Suite, crie o portfólio com os dados exatamente como estão no CNPJ. Divergências pequenas (abreviações, endereço diferente, site com outro nome) são a causa mais comum de verificação recusada.

2. Crie um app no painel de desenvolvedores

Em developers.facebook.com, crie um app do tipo empresa, vinculado ao seu portfólio, e adicione o produto WhatsApp. A Meta cria uma conta do WhatsApp Business e um número de teste para você enviar mensagens a poucos destinatários cadastrados. Use esse momento para testar o webhook e o envio antes de mexer no número real.

3. Adicione o número da empresa

Ao adicionar o número, você informa o nome de exibição, a categoria do negócio e confirma a posse com um código por SMS ou ligação. Depois disso, o número precisa ser registrado na Cloud API, e nesse registro você define um PIN de verificação em duas etapas. Guarde esse PIN num cofre de senhas da empresa: ele é exigido para mudar configurações e até para excluir o número.

4. Gere um token permanente

O token temporário do painel expira rápido. Para produção, crie um usuário do sistema no portfólio com acesso à WABA e gere um token. Ele fica em variável de ambiente no servidor, nunca no front-end.

5. Configure o webhook

O webhook é o endereço do seu sistema que recebe as mensagens dos clientes e os status (enviada, entregue, lida).

6. Cadastre a forma de pagamento

Na conta de cobrança do WhatsApp, adicione o cartão; sem isso, mensagens pagas não saem.

7. Inicie a verificação da empresa

No Centro de Segurança do portfólio, envie os documentos. Pode ser no dia 1 (detalhes abaixo).

Passo a passo via BSP

Com um provedor, o fluxo costuma ser guiado: você cria conta na plataforma, clica em "conectar WhatsApp", faz login com o Facebook do administrador, escolhe portfólio, nome de exibição e número, confirma o número por SMS ou ligação e cadastra a forma de pagamento.

Antes de assinar, pergunte: a WABA fica no meu portfólio? Se eu cancelar, levo o número? O preço das mensagens é repassado sem margem? Existe fidelidade?

Verificação da empresa

A verificação comprova à Meta que a empresa existe e que você a representa. Segundo a documentação de limites de mensagens da Meta, portfólios novos começam podendo iniciar conversas com até 250 pessoas diferentes a cada 24 horas (fora da janela de atendimento). Para subir para 2.000, um dos caminhos é justamente verificar a empresa (ou enviar 2.000 mensagens de alta qualidade em 30 dias). A verificação também eleva o limite de números registrados no portfólio, que começa em 2.

Dicas que evitam recusa:

• Nome jurídico e endereço idênticos ao documento.
• Site com o nome da empresa, informações de contato e, de preferência, CNPJ no rodapé.
• E-mail de verificação no domínio do site, não Gmail.
• Documento legível, atualizado, sem cortes.

Não existe prazo oficial fixo: com dados batendo, costuma levar alguns dias.

Nome de exibição

É o nome que aparece para o cliente no perfil e no topo da conversa. A Meta revisa esse nome, e a documentação descreve que a revisão acontece automaticamente quando a conta sobe de limite de mensagens. O resultado chega por notificação no Business Suite e por webhook.

Regras práticas, segundo as diretrizes da Meta e dos provedores:

• O nome precisa ter relação clara com a empresa (razão social, nome fantasia ou marca presente no site).
• Nada de termos genéricos sozinhos ("Clínica", "Delivery", "Atendimento").
• Evite palavras que sugiram vínculo oficial que você não tem.
• Capitalização normal, sem emojis nem pontuação decorativa.

Se for recusado, você pode corrigir e reenviar ou recorrer pelo suporte. A documentação limita as trocas de nome a 10 a cada 30 dias, e, depois de aprovado, é preciso registrar o número de novo em até 14 dias para o nome novo valer.

O número: novo, migrado ou em coexistência

Essa é a decisão que mais pesa no dia a dia.

Número novo

Mais simples e limpo. Pode ser um chip novo ou uma linha fixa (a confirmação sai por ligação). Você divulga o número novo e mantém o antigo só para transição.

Migrar o número atual (sair do app)

O número precisa não estar em uso no WhatsApp: você exclui a conta do app (ou do WhatsApp comum) e então registra na API. Conversas antigas não vão junto, então faça backup antes. Depois disso, o número só funciona pela API: o app no celular deixa de existir para ele.

Coexistência com o app WhatsApp Business

Aqui o número continua no app do celular e ganha conexão com a API. Segundo a documentação da Meta:

• Exige o app WhatsApp Business versão 2.24.17 ou superior e a conexão é feita por um parceiro tecnológico ou BSP, via cadastro guiado.
• Contatos e até 6 meses de conversas individuais podem ser sincronizados (conversas em grupo, não).
• A vazão fica limitada a 20 mensagens por segundo, o que é muito para uma pequena empresa.
• Mensagens enviadas pelo app continuam gratuitas; as enviadas pela API seguem a tabela da Cloud API.
• Alguns recursos do app mudam: listas de transmissão ficam somente leitura, mensagens temporárias e de visualização única são desativadas nas conversas individuais, entre outros.
• Se você desinstalar o app, a conexão cai. Mantenha o celular configurado.

Coexistência é ótima para quem tem um número conhecido e quer um bot de IA respondendo enquanto a equipe segue no celular. Para operação grande, um número dedicado à API costuma ser mais organizado.

Templates (mensagens de modelo)

Quando o cliente fala com você, abre uma janela de 24 horas em que você responde livremente. Para iniciar conversa fora dessa janela (lembrete, confirmação, promoção), só com templates aprovados.

Boas práticas:

• Escolha a categoria certa: utilidade (confirmações, lembretes, status), marketing (promoções, novidades) ou autenticação (códigos). A Meta pode recategorizar se achar que você errou, e marketing costuma ser mais caro.
• Use variáveis com exemplos claros: "Olá, {{1}}, sua consulta é em {{2}}".
• Inclua opção de saída em mensagens de marketing.

Custos

Desde julho de 2025, a Meta cobra por mensagem entregue, com preços diferentes por categoria e país. Mensagens que o cliente envia para você não são cobradas. Em novembro de 2026, cada número tem uma cota gratuita mensal de mensagens de serviço, e mudanças de outubro de 2026 passaram a cobrar parte das mensagens dentro da janela. Os valores mudam por trimestre, então consulte sempre a tabela oficial da Meta. Explicamos as categorias e as mudanças recentes em API oficial x não oficial e o orçamento completo (Meta + IA + servidor) em quanto custa um chatbot com IA no WhatsApp.

Erros comuns (e como evitar)

Checklist final

• Portfólio com dados idênticos ao CNPJ e administrador da empresa
• Site no ar com o nome da marca
• Decisão sobre o número: novo, migração ou coexistência
• Número confirmado, registrado e com PIN guardado
• Nome de exibição alinhado à marca
• Verificação da empresa enviada
• Token permanente e webhook configurados
• Forma de pagamento cadastrada
• Templates principais aprovados

Com a API ativa, o próximo passo é decidir o que automatizar. O guia de chatbot com IA no WhatsApp para empresas mostra o que costuma funcionar melhor.

Quer que alguém configure isso com você?

A Mobgeek configura a API oficial e implanta agentes de IA e WhatsApp com tudo no nome da sua empresa: portfólio, número, templates, IA e integração com agenda ou CRM. Projetos a partir de R$ 4.900, mais os custos mensais de uso (mensagens da Meta, IA e servidor). Se quiser uma estimativa para o seu caso, peça um orçamento.