Meta Business: como configurar para o WhatsApp do zero

A documentação da Meta espalha essa configuração por seis páginas diferentes, e nenhuma diz em que ordem fazer. O resultado é previsível: o projeto de API trava antes da primeira linha de código, num painel que ninguém entende direito.

Este guia é a sequência inteira, na ordem em que ela funciona — incluindo o passo que a maioria descobre tarde demais, quando o número já está registrado no lugar errado.

A hierarquia que explica tudo

Quase toda confusão no Meta Business vem de não enxergar que são quatro objetos encaixados, não uma configuração única.

O portfólio comercial precisa ser seu. Se o fornecedor criar tudo dentro do dele, trocar de plataforma no futuro deixa de ser decisão técnica e vira negociação.

Passo a passo

1. 1

   Crie ou identifique o portfólio comercial

   Em business.facebook.com. Se a empresa já anuncia no Facebook ou no Instagram, ele provavelmente já existe — use o mesmo, não crie outro. Portfólio duplicado divide o histórico e complica a verificação depois.

   business.facebook.com › Configurações do negócio

2. 2

   Crie a conta comercial do WhatsApp (WABA)

   Em Contas › Contas do WhatsApp › Adicionar. A WABA é o objeto que vai guardar seus números, seus templates e seus limites de envio. Uma empresa pode ter mais de uma, mas comece com uma só.

3. 3

   Escolha um número que esteja livre

   O número não pode estar registrado no WhatsApp comum nem no Business. Se estiver, precisa ser apagado da conta antes — e o histórico de conversas não vai junto. É por isso que a maioria usa um número novo e mantém o antigo em operação durante a transição.

4. 4

   Cadastre o nome de exibição

   É o nome que o cliente vê mesmo sem ter você salvo. Passa por revisão da Meta e precisa ter relação clara com a empresa: “Atendimento” ou “Vendas” são recusados; o nome da marca, não. Sai em horas na maioria dos casos.

5. 5

   Crie o app no painel de desenvolvedores

   Em developers.facebook.com, um app do tipo Business com o produto WhatsApp adicionado. É dele que saem o phone-number-id e o token — e é aqui que a maioria confunde o ID do número com o ID da conta comercial, o que produz o erro 33.

6. 6

   Troque o token temporário por um permanente

   O token que aparece no painel vale 24 horas e serve só para o primeiro teste. Produção exige um token de usuário do sistema, criado em Configurações do negócio › Usuários › Usuários do sistema, com as permissões whatsapp_business_messaging e whatsapp_business_management.

A verificação da empresa

É a etapa mais demorada e a que mais gera dúvida — inclusive sobre se é obrigatória. A resposta prática: para testar, não; para operar de verdade, sim.

O caminho é Central de Segurança › Iniciar verificação. No Brasil, os documentos que costumam ser aceitos:

• Cartão CNPJ emitido pela Receita Federal, com a razão social exatamente como cadastrada no portfólio.
• Comprovante de endereço em nome da empresa — conta de luz, água, telefone fixo ou extrato bancário recente.
• Site próprio com o mesmo nome e endereço, e um e-mail no domínio da empresa. Não é documento, mas pesa na análise.
• Telefone que atenda e confirme o código, quando a Meta pedir confirmação por ligação.

Os papéis, e quem deve ter cada um

Ao contratar uma plataforma, conceda acesso de parceiro. Não transfira a propriedade da conta comercial — é a diferença entre trocar de fornecedor num dia e negociar por semanas.

Erros que custam dias

Se você já usa o número no aplicativo

É a situação mais comum de quem migra, e a que tem a decisão mais difícil: o número que os clientes conhecem está no WhatsApp Business e precisa sair de lá para entrar na API. O histórico não vai junto.

Na prática, há dois caminhos. O primeiro é registrar um número novo na API e manter o antigo atendendo durante a transição, migrando a divulgação aos poucos. O segundo é migrar o número conhecido e aceitar a perda do histórico. O primeiro é quase sempre melhor — e fica indolor se o que você divulga for um endereço editável em vez do número cru.

Perguntas frequentes

Resumo

• A ordem é: portfólio → WABA → número → nome de exibição → app → token.
• O número precisa estar livre; se já atende clientes, o histórico se perde.
• Nome de exibição genérico é recusado. Use o nome da marca.
• Token temporário dura 24 horas — produção exige usuário do sistema.
• A verificação da empresa é o que destrava os limites maiores de envio.
• A conta comercial fica no seu portfólio, sempre. O fornecedor entra como parceiro.