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 — 8 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 interativo abaixo: nós clicáveis, modais por passo e jornada do CNPJ ao go-live. Para abrir em tela cheia, use Mapa em tela cheia.

Abrir mapa interativo

Visão geral das 8 etapas

O caminho do CNPJ até a primeira mensagem via API oficial passa por 8 etapas. Cada uma tem decisões, bloqueios possíveis e caminhos alternativos. As etapas seguem a mesma sequência do mapa interativo acima.

flowchart TD E1["1 · Comece aqui"] --> E2["2 · CNPJ e dados da empresa"] E2 --> E3["3 · Requisitos Meta:
BM + Verificação"] E3 --> E4["4 · Preparação do WhatsApp"] E4 --> E5["5 · Revisão Final"] E5 --> E6["6 · Conexão Meta
(Coexistência)"] E6 --> E7["7 · Templates"] E7 --> E8["8 · Operação"]

Etapa 1: Comece aqui

Antes de avançar, alinhe as definições com o cliente. O mapa interativo detalha cada conceito no nó clicável.

Business Manager (BM): centro de controle dos ativos Meta (páginas, apps, números, contas de anúncio)
WABA: WhatsApp Business Account — a conta que conecta o número à API oficial
Coexistência: modo que mantém o WhatsApp Business App no celular + API no mesmo número
Embedded Signup: fluxo de conexão integrado ao BSP (substitui o registro manual)

Por que definições primeiro? Muitos bloqueios surgem porque cliente e implantador usam termos diferentes para o mesmo recurso. Alinhar vocabulário antes de começar reduz ida e volta.

Etapa 2: CNPJ e dados da empresa

Você precisa de um CNPJ ativo e uma empresa com presença online verificável.

CNPJ ativo na Receita Federal
Website completo ou Instagram com nome do escritório visível
E-mail corporativo (domínio próprio acelera verificação)
Telefone e e-mail cadastrados no CNPJ acessíveis pelo cliente

Bloqueio comum: MEI com site genérico ou ausência de presença online. A Meta pode rejeitar a verificação se não conseguir confirmar que a empresa é real e opera no endereço informado. Sem website, um Instagram bem preenchido com o nome da empresa pode ser suficiente.

Etapa 3: Requisitos Meta — BM + Verificação

Esta etapa concentra todos os pré-requisitos na plataforma Meta: Business Manager, 2FA, página do Facebook e verificação da empresa. No mapa interativo, é a etapa mais extensa.

Business Manager

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["Contestar restricao
ou nova BM"] B -->|Banida| F["Nova conta Facebook
+ novo BM"] 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 (2FA) ativada para todos os admins
Página do Facebook vinculada (obrigatória para WhatsApp)

Verificação de empresa

A verificação confirma que a 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.

Se você é Tech Provider (BSP / ISV): as etapas 4 e 5 abaixo descrevem o fluxo do cliente final (conexão direta). Se você é quem opera a plataforma e faz o Embedded Signup para seus clientes, primeiro complete os passos de Tech Provider logo abaixo — e só depois siga para a Etapa 4 com cada cliente.

Caminho Tech Provider: Criar app + Adicionar produto WhatsApp

Estes passos são feitos uma vez pelo tech provider, antes de onboardar qualquer cliente via Embedded Signup.

TP-1: 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 do tech provider
Defina o nome do app — é o que aparece para o cliente no Embedded Signup

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

TP-2: Adicionar produto WhatsApp

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

A WABA é criada automaticamente sob a BM 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.

flowchart TD TP1["Acessar developers.facebook.com"] --> TP2["Criar app tipo Business"] TP2 --> TP3["Vincular à BM verificada"] TP3 --> TP4["Adicionar produto WhatsApp"] TP4 --> TP5["WABA criada automaticamente"] TP5 --> TP6["Configurar display name"] TP6 --> TP7["Configurar pagamento (USD)"] TP7 --> TP8(["Pronto para Embedded Signup
com clientes"])

Etapa 4: Preparação do WhatsApp

Garanta que o WhatsApp Business está ativo, o número está livre e o celular está disponível para a ligação de conexão.

WhatsApp Business (não o pessoal) instalado e ativo no número
Número não conectado a outra API (Z-API, Evolution, etc.) — se conectado, desconectar e aguardar 24h
Celular em mãos no dia da ligação de conexão

Conta WhatsApp restrita: se a conta aparece restrita no Gerenciador do WhatsApp, atualize o perfil comercial (site válido) e peça análise à Meta. Aguarde a liberação antes de prosseguir.

Etapa 5: Revisão Final

Antes de agendar a ligação de conexão, revise todos os pré-requisitos. O mapa interativo agrupa tudo o que precisa estar OK.

CNPJ ativo e dados da empresa consistentes
BM com admin + 2FA + página Facebook vinculada
Empresa verificada (ou em análise com previsão de aprovação)
WhatsApp Business ativo no número, sem outra API
Celular disponível para ligação

Objetivo: zerar pendências antes da ligação. Cada item não resolvido aqui pode travar a conexão ao vivo e gerar reagendamento.

Etapa 6: Conexão Meta (Coexistência)

Na ligação com o cliente, a conexão acontece via Coexistência: o WhatsApp Business App permanece no celular enquanto a API oficial é ativada no mesmo número.

flowchart TD CON_START(["Iniciar ligação"]) --> SHARE["Compartilhar tela"] SHARE --> REQ["Verificar requisitos
Coexistência"] REQ --> ELEG{"Número elegível?
7+ dias no WAB"} ELEG -->|Sim| LOGIN["Login Facebook Business"] ELEG -->|Não| WAIT["Usar número
por mais tempo"] WAIT --> ELEG LOGIN --> BM["Selecionar Portfólio
de Negócios"] BM --> WAB["Conectar WhatsApp
Business existente"] WAB --> NUM["Adicionar número
e confirmar nome"] NUM --> QR["QR Code:
Compartilhar Contatos"] QR --> SCAN{"QR escaneado?"} SCAN -->|Sim| IMPORT{"Importar histórico?"} SCAN -->|Não| DBG["Verificar app v2.24.17+"] DBG --> QR IMPORT --> SYNC["Sincronizando"] SYNC --> OK["Conectado"] OK --> POS["Pós-conexão:
automações + dispositivos"] POS --> PAG{"Cartão internacional
cadastrado?"} PAG -->|Sim| DONE["Conexão pronta"] PAG -->|Não| CAD["Cadastrar cartão USD"] CAD --> PAG

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. 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.

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: 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 ({{nome}}, {{pedido_id}}) 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 8: Operação

Com WABA conectada e templates aprovados, a conta está operacional. É hora da primeira mensagem real.

Checklist de operação

BM verificada
Número registrado e conectado via Coexistência
Método de pagamento (cartão USD) configurado na WABA
Pelo menos 1 template aprovado
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.

Resumo: edge cases por etapa

Etapa	Situação	Ação típica
1 · Comece aqui	Termos desalinhados	Alinhar definições (BM, WABA, Coexistência, Embedded Signup) antes de começar.
2 · CNPJ / empresa	Site fino ou só redes	Garantir rastreabilidade da empresa (CNPJ, contato, políticas) alinhada ao que a Meta consegue conferir.
3 · Requisitos Meta	BM restrita / sem admin / botão ausente / rejeição	Contestar dentro do prazo ou nova conta; Páginas de Notícias; alinhar nome/endereço ao CNPJ; reduzir e-mails pessoais no BM.
TP · Tech Provider	App tipo errado / BM errada / pagamento ausente	Criar app tipo Business vinculado à BM verificada; adicionar produto WhatsApp; configurar cartão USD na WABA.
4 · WhatsApp	Outra API ou conta restrita	Desconectar + espera 24h; atualizar perfil comercial e pedir análise se restrita.
5 · Revisão Final	Pendências não resolvidas	Zerar checklist antes da ligação — evita reagendamento.
6 · Conexão	Coex inelegível / QR falha	Manter Business App ativo 7+ dias; verificar versão do app; importar histórico se aplicável.
7 · Templates	Rejeição ou pausa	Categoria correta; exemplos de variáveis; melhorar qualidade percebida.
8 · Operação	Rating baixo / tier travado	Aquecer volume com mensagens úteis; acompanhar tiers e quality rating.

Fluxo completo do onboarding

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

flowchart TD START(["Comece aqui"]) --> CNPJ["CNPJ e empresa"] CNPJ --> REQ["Requisitos Meta:
BM + Verificação"] REQ --> WAB["Preparação WhatsApp"] WAB --> REV["Revisão Final"] REV --> CON["Conexão Meta
(Coexistência)"] CON --> TPL["Templates"] TPL --> LIVE(["Operação"]) REQ -.->|restrita / sem admin| REQ_BM["Contestar ou elevar permissão"] REQ_BM -.-> REQ REQ -.->|botão ausente| REQ_PN["Páginas de Notícias"] REQ_PN -.-> REQ REQ -.->|verificação rejeitada| REQ_DOC["Docs + reenvio"] REQ_DOC -.-> REQ WAB -.->|outra API| WAB_DC["Desconectar + 24h"] WAB_DC -.-> WAB WAB -.->|conta restrita| WAB_FIX["Atualizar perfil + análise"] WAB_FIX -.-> WAB CON -.->|coex inelegível| CON_WAIT["Mais tempo no WAB"] CON_WAIT -.-> CON TPL -.->|rejeitado| TPL_FIX["Ajustar template"] TPL_FIX -.-> TPL