Mapa interativo

Onboarding na API oficial da Meta sem fricção — 9 etapas do CNPJ ao go-live

Menos atrito no caminho até a API oficial: um mapa do cadastro ao go-live, com os desvios em que a maioria trava e o que fazer em cada etapa.

Tem a senha deste guia ou da comunidade? A da comunidade vale para todos os materiais.

Quero fazer parte e receber esse tipo de conteúdo

Mapa interativo

Onboarding na API oficial da Meta sem fricção — 9 etapas do CNPJ ao go-live

Fluxograma interativo para chegar à WhatsApp Business API oficial com o mínimo de fricção: decisões, bloqueios e atalhos em cada etapa.

Última atualização: 30 de março de 2026

Abrir mapa completo (interativo)

Mapa completo: este material resume as 9 etapas em Mermaid. Para o fluxo único com todos os nós clicáveis, modais por passo e a jornada alinhada ao checklist de preparação, use Mapa de implantação Meta (acesso com a senha do mapa).

Visão geral das 9 etapas

O caminho do CNPJ até a primeira mensagem via API oficial passa por 9 etapas. Cada uma tem decisões, bloqueios possíveis e caminhos alternativos.

flowchart TD E1["1 · CNPJ e empresa"] --> E2["2 · Business Manager"] E2 --> E3["3 · Verificação de empresa"] E3 --> E4["4 · App Meta for Developers"] E4 --> E5["5 · Produto WhatsApp"] E5 --> E6["6 · Conectar número"] E6 --> E7["7 · Webhooks"] E7 --> E8["8 · Templates aprovados"] E8 --> E9["9 · Go-live"]

Etapa 1: CNPJ e empresa

Você precisa de um CNPJ ativo e uma empresa com presença online verificável (site, redes sociais, ou listagem pública).

CNPJ ativo na Receita Federal
Site institucional ou página de negócio acessível publicamente
E-mail corporativo (domínio próprio acelera verificação)

Bloqueio comum: MEI com site genérico. A Meta pode rejeitar a verificação se não conseguir confirmar que a empresa é real e opera no endereço informado.

Etapa 2: Criar Business Manager

O Business Manager (BM) é o centro de controle de todos os ativos da Meta: páginas, apps, números, contas de anúncio.

flowchart TD A{"Já tem BM?"} -->|Sim| B{"Status da BM?"} A -->|Não| C["Criar BM
business.facebook.com"] B -->|Ativa| D["Usar esta BM"] B -->|Restrita| E["Revisão na Meta
ou nova BM"] B -->|Banida| F["Nova BM +
outro admin"] C --> D

Edge cases BM: acesso parcial no BM não autoriza Embedded Signup — peça controle total ao admin. Conta Facebook muito nova ou com limite de criação de empresas: use conta madura ou aguarde. Após criar BM nova, a Meta pode exigir período de recência (ex.: 72h) antes de algumas ações. BM restrita: verifique se ainda há janela de contestação; se a conta foi banida de forma irreversível, só com nova conta Facebook + novo BM (sem reutilizar dados da banida).

Checklist da BM

Nome da BM = nome legal da empresa
Pelo menos 2 admins (evita perda de acesso)
Autenticação de dois fatores ativada para todos os admins
Página do Facebook vinculada (obrigatória para WhatsApp)

Etapa 3: Verificação de empresa

A verificação confirma que sua BM pertence a uma empresa real. É pré-requisito para ter um número de telefone em produção.

Documentos aceitos

Tipo	Exemplos
Registro comercial	Cartão CNPJ, contrato social
Conta de serviços	Conta de luz, telefone ou internet no nome da empresa
Documento fiscal	Nota fiscal, declaração de IR da empresa

flowchart TD V1["Enviar documentos"] --> V2{"Aprovado?"} V2 -->|Sim| V3["BM verificada"] V2 -->|Não| V4["Ler motivo
da rejeição"] V4 --> V5{"Nome ou endereço
diverge do doc?"} V5 -->|Sim| V6["Ajustar BM
e reenviar"] V5 -->|Não| V7["Outro documento
aceito pela Meta"] V6 --> V1 V7 --> V1

Dica: O nome na BM deve ser idêntico ao nome no documento. "Empresa LTDA" ≠ "Empresa". Qualquer divergência = rejeição automática.

Edge cases verificação: se o botão Verificar empresa não aparece, ative Páginas de Notícias no portfólio e confira permissões. E-mails pessoais (Gmail, etc.) no BM podem contribuir para rejeição — prefira domínio do escritório. Status em análise: aguarde em geral 24–72h úteis antes de reenviar documento duplicado.

Etapa 4: Criar app no Meta for Developers

Acesse developers.facebook.com e crie um app do tipo Business.

Tipo do app: Business (não "Consumer" ou "Gaming")
Vincule à BM verificada
Defina o nome do app (aparece para o cliente no Embedded Signup)

Edge case app: app tipo errado ou BM errada vinculada gera erros no fluxo de login e permissões. Revise Business settings do app e dono da BM antes do primeiro Embedded Signup com cliente.

Etapa 5: Adicionar produto WhatsApp

No painel do app, adicione o produto WhatsApp. Isso cria automaticamente uma WABA (WhatsApp Business Account) vinculada à sua BM.

A WABA é criada automaticamente sob a BM que é dona do app
Configure o display name da WABA (aparece para o destinatário)
Configure um método de pagamento na WABA (cartão de crédito ou créditos pré-pagos) — obrigatório para enviar mensagens em produção

Edge case cobrança: o cartão/método da API do WhatsApp (conversas) é independente do pagamento de anúncios Facebook/Instagram. Cada número/WABA pode exigir cadastro próprio; cartão internacional em USD é o cenário mais comum.

Etapa 6: Conectar número

O número de telefone é o ativo mais importante. Ele precisa receber SMS ou chamada para verificação.

flowchart TD N1{"Número novo ou
já no WhatsApp?"} N1 -->|Chip novo| N2["Linha dedicada"] N1 -->|Já no WhatsApp Business| N3{"Manter app no celular
+ API?"} N1 -->|Em outra API
Z-API / Evolution / BSP| N0["Desconectar no app
aguardar 24h+"] N0 --> N1 N3 -->|Sim| N4["Coexistência
QR Code"] N3 -->|Não| N5["Fluxo PIN / migração
conforme política Meta"] N2 --> N6["API / Embedded Signup"] N4 --> N6E{"Elegível?
7+ dias no WAB"} N6E -->|Sim| N6 N6E -->|Não| NW["Usar número mais tempo
no Business App"] NW --> N4 N5 --> N6 N6 --> N7["SMS / voz / PIN ou QR"] N7 --> N8["Número OK"]

Edge cases número: erro “já registrado em uma conta WhatsApp” → desvincule do provedor/BSP anterior no celular e aguarde alguns minutos; se persistir após API não oficial, pode levar semanas de uso estável no Business App. Coexistência exige WhatsApp Business (versão recente), não o app pessoal. PIN: excesso de tentativas → esperar ~12h antes de novo ciclo. Número bloqueado ou limite de telefones na WABA → tratar pelo Gerenciador do WhatsApp / suporte Meta.

Coexistência (QR Code)

A coexistência mantém o WhatsApp Business App no celular e a API oficial no mesmo número, vinculados por QR Code (requisitos e prazos de elegibilidade mudam; o mapa completo detalha passo a passo).

O número continua ativo no WhatsApp Business no celular
Tráfego pela API segue regras e cobrança da plataforma; uso pelo app segue políticas do app
Útil quando o escritório não quer perder o app no telefone nem o histórico elegível à importação

Etapa 7: Configurar webhooks

Webhooks são como a API avisa seu servidor sobre mensagens recebidas, status de entrega, etc.

Configure uma URL HTTPS pública no seu servidor
Implemente o endpoint de verificação (GET com challenge)
Assine os campos do webhook: messages (inclui mensagens recebidas e status de entrega) e message_template_status_update (status de aprovação de templates)
Teste com a ferramenta de teste do painel da Meta

Evite em produção: usar ngrok (ou túnel equivalente) como URL fixa do webhook. Para testes locais funciona; em produção o túnel pode cair ou mudar e você perde eventos. Prefira servidor com HTTPS válido e endpoint estável.

Edge cases webhook: valide X-Hub-Signature-256 com o app secret (rejeite payload sem assinatura válida). Timeouts ou 200 lento podem fazer a Meta reenfileirar ou desativar entregas — responda rápido e processe trabalho pesado fora da thread do request.

Etapa 8: Criar e aprovar templates

Templates são mensagens pré-aprovadas pela Meta. São obrigatórios para iniciar conversas (fora da janela de 24h).

Boas práticas para aprovação rápida

Use linguagem clara e profissional
Inclua o nome da empresa no template
Evite linguagem promocional agressiva
Sempre inclua uma forma de opt-out (para templates de marketing)
Use variáveis nomeadas (, ) com exemplos realistas ao submeter

flowchart LR T1["Criar template"] --> T2["Submeter à Meta"] T2 --> T3{"Status"} T3 -->|OK| T4["Usar em produção"] T3 -->|Rejeitado| T5["Corrigir + resubmit"] T3 -->|Pausado| T6["Quality rating"] T5 --> T2 T6 --> T2

Edge cases templates: conteúdo promocional em categoria utilidade → rejeição. Variáveis sem exemplos realistas atrasam análise. Quality rating baixo ou feedback negativo pode pausar o template ou afetar o número — corrija copy e segmentação antes de escalar volume.

Etapa 9: Go-live e primeiras mensagens

Com tudo configurado, é hora de enviar a primeira mensagem real.

Checklist de go-live

BM verificada
Número registrado e verificado
Método de pagamento configurado na WABA
Webhooks recebendo eventos corretamente
Pelo menos 1 template aprovado
System User Access Token configurado (criado via Business Manager > System Users — não use o token temporário do painel de desenvolvedor)
Monitoramento de quality rating ativo

Limites de envio: Números novos começam no tier de 250 mensagens/24h. Conforme o quality rating se mantém verde, a Meta escala automaticamente: 250 → 1K → 10K → 100K mensagens. Enviar spam no primeiro dia pode derrubar o rating e travar o número no tier mais baixo.

Edge cases go-live: use System User token de longa duração para servidor — token do painel do desenvolvedor é inadequado para produção. BSUID / username (quando aplicável) exigem ajuste de payloads e webhooks. Monitore quality rating do número e limites de throughput além do tier de conversas.

Resumo: edge cases por etapa

Etapa	Situação	Ação típica
1 · CNPJ / empresa	Site fino ou só redes	Garantir rastreabilidade da empresa (CNPJ, contato, políticas) alinhada ao que a Meta consegue conferir.
2 · BM	Sem admin total / BM restrita	Elevate permissão; contestar dentro do prazo ou recomeçar com conta nova se banimento irreversível.
3 · Verificação	Sem botão ou rejeição	Páginas de Notícias; alinhar nome/endereço ao CNPJ; reduzir e-mails pessoais no BM.
4–5 · App / WhatsApp	App tipo errado / cobrança	Business app na BM certa; cadastrar pagamento da WABA separado dos ads.
6 · Número	Outra API ou coex inelegível	Desconectar + espera; manter Business App ativo 7+ dias (ideal 30–60) antes da coex.
7 · Webhooks	Eventos perdidos	HTTPS estável; validar assinatura; resposta rápida.
8 · Templates	Rejeição ou pausa	Categoria correta; exemplos de variáveis; melhorar qualidade percebida.
9 · Go-live	Token errado / rating	System User; aquecer volume com mensagens úteis; acompanhar tiers.

Fluxo completo do onboarding

As 9 etapas em um único fluxograma — útil para antecipar bloqueios e reduzir ida e volta:

flowchart TD START(["CNPJ ativo"]) --> BM["BM criada / ok"] BM --> VER["Verificação empresa"] VER --> APP["App Business"] APP --> WA["Produto WhatsApp"] WA --> NUM["Número conectado"] NUM --> WH["Webhooks"] WH --> TPL["Templates"] TPL --> GO(["Go-live"]) BM -.->|restrita / sem admin| BM_FIX["Contestar ou elevar permissão"] BM_FIX -.-> BM VER -.->|botão ausente| VER_PN["Páginas de Notícias"] VER_PN -.-> VER VER -.->|rejeitada| VER_FIX["Docs + reenvio"] VER_FIX -.-> VER NUM -.->|outra API| NUM_DC["Desconectar + 24h"] NUM_DC -.-> NUM NUM -.->|WAB + histórico| COEX["Coexistência QR"] COEX -.-> NUM WH -.->|túnel / assinatura| WH_FIX["HTTPS + X-Hub-256"] WH_FIX -.-> WH TPL -.->|rejeitado| TPL_FIX["Ajustar template"] TPL_FIX -.-> TPL GO -.->|token dev| SU["System User token"] SU -.-> GO