WhatsApp Business API Oficial (Meta Cloud API)
Envio direto pelo seu número oficial, sem intermediários. Mensagens ilimitadas com templates aprovados.
Desconectado
—
Mensagens enviadas
—
total histórico
Fila pendente
—
aguardando envio
Taxa de entrega
—
últimas 24h
Templates aprovados
—
prontos para uso
🔐 Credenciais Meta Cloud API
↗ Meta Developers
⚠️ ATENÇÃO — 2 armadilhas comuns:
1) Número de TESTE ≠ Número de PRODUÇÃO. Quando cria App WhatsApp, o Meta dá um número de teste (US, começa com +1) que só envia pra Brasil se você adicionar tester manualmente. Pra usar seu número real (+55...), tem que ir na Etapa 2 · Configuração da produção e registrar seu número.
2) Business Verification pendente = envio restrito. Sem CNPJ verificado, você só envia pra até 5 números pré-cadastrados e no máximo 250 conversas/24h. Aprovação: 1-5 dias úteis.
1) Número de TESTE ≠ Número de PRODUÇÃO. Quando cria App WhatsApp, o Meta dá um número de teste (US, começa com +1) que só envia pra Brasil se você adicionar tester manualmente. Pra usar seu número real (+55...), tem que ir na Etapa 2 · Configuração da produção e registrar seu número.
2) Business Verification pendente = envio restrito. Sem CNPJ verificado, você só envia pra até 5 números pré-cadastrados e no máximo 250 conversas/24h. Aprovação: 1-5 dias úteis.
📋 Passo-a-passo completo:
A) Criar o App (uma vez só):
1. Vai em developers.facebook.com/apps → Criar App
2. Caso de uso: Outro → Tipo: Empresa → nome do App:
3. Após criar, adiciona o produto WhatsApp (clica em "Configurar")
4. Vincula ao teu Business Manager (BM verificado)
B) Chegar na tela de configuração (fluxo atualizado 2026):
1. Ainda dentro do App em developers.facebook.com/apps
2. No menu esquerdo, procura Casos de uso (ou Use cases)
3. Encontra "Conectar no WhatsApp" ou "Connect WhatsApp" → clica em Personalizar (botão azul)
4. Abre painel com 3 etapas em "Configuração básica":
• Etapa 1 · Experimente (número teste US — ignora)
• Etapa 2 · Configuração da produção ← É AQUI que você configura
• Etapa 3 · Verificação da empresa
C) Etapa 2 — configura tudo na ORDEM que o Meta pede:
C.1 · Configurar webhooks:
• URL de callback:
• Verifica token: cria uma string qualquer (ex:
• Salva
C.2 · Registre seu número de telefone:
• Clica em Adicionar novo número → digita +5511... (teu número real, NÃO o +1 555)
• Escolhe verificação por SMS ou ligação → recebe código → confirma
• Após verificar, o número aparece com um Phone Number ID (15 dígitos) — anota
C.3 · Adicione informações de pagamento:
• Meta cobra por conversação (a partir da 1000ª/mês)
• Cartão internacional obrigatório — sem isso, envio bloqueia
C.4 · Envia mensagem de teste:
• Só funciona depois dos 3 passos acima concluídos
• Se der erro 130497, é porque Etapa 3 (Business Verification) ainda não passou
D) Copiar WABA ID (WhatsApp Business Account):
1. Em business.facebook.com/settings/whatsapp-business-accounts
2. Clica na tua conta → topo aparece "ID da conta do WhatsApp"
3. Copia (também tem 15 dígitos)
E) Gerar Token PERMANENTE (System User):
1. business.facebook.com/settings/system-users → + Adicionar
2. Nome:
3. Clica no usuário criado → Gerar novo token
4. Escolhe o App WhatsApp que criou no passo A
5. Expiração: NUNCA EXPIRA (crítico — Explorer token vence em 60 dias)
6. Permissões marca:
7. Copia o token INTEIRO — só aparece 1x. Se perder, regenera
F) Etapa 3 · Verificação da empresa (Business Verification — obrigatória):
1. Volta em Casos de uso → Personalizar → Conectar no WhatsApp → menu esquerdo → Etapa 3 · Verificação da empresa
2. Ou direto: business.facebook.com/settings/security → Iniciar verificação
3. Anexa: cartão CNPJ, comprovante endereço do negócio, site verificável
4. Aprovação: 1-5 dias úteis (às vezes até 2 semanas)
5. Sem isso: erro 130497 ao enviar pra qualquer número que não seja "tester"
6. Enquanto espera aprovação: adiciona teu WhatsApp como test recipient no App pra testar
G) Warmup obrigatório (se conta anterior foi banida):
• Dia 1-2: máx 50 msgs/dia (só utility de compra confirmada)
• Dia 3-5: 100-200/dia
• Dia 6-10: 300-500/dia (utility majoritário)
• Dia 11+: escala 20%/dia se Quality Score = ALTA
• Nunca importe 10k+ contatos de uma vez — divide em levas
A) Criar o App (uma vez só):
1. Vai em developers.facebook.com/apps → Criar App
2. Caso de uso: Outro → Tipo: Empresa → nome do App:
WhatsApp API Producao3. Após criar, adiciona o produto WhatsApp (clica em "Configurar")
4. Vincula ao teu Business Manager (BM verificado)
B) Chegar na tela de configuração (fluxo atualizado 2026):
1. Ainda dentro do App em developers.facebook.com/apps
2. No menu esquerdo, procura Casos de uso (ou Use cases)
3. Encontra "Conectar no WhatsApp" ou "Connect WhatsApp" → clica em Personalizar (botão azul)
4. Abre painel com 3 etapas em "Configuração básica":
• Etapa 1 · Experimente (número teste US — ignora)
• Etapa 2 · Configuração da produção ← É AQUI que você configura
• Etapa 3 · Verificação da empresa
C) Etapa 2 — configura tudo na ORDEM que o Meta pede:
C.1 · Configurar webhooks:
• URL de callback:
https://cbpekxkugjrseadjzjjc.supabase.co/functions/v1/wa-webhook• Verifica token: cria uma string qualquer (ex:
webnario_2026_wa) — anota, vai usar no formulário abaixo• Salva
C.2 · Registre seu número de telefone:
• Clica em Adicionar novo número → digita +5511... (teu número real, NÃO o +1 555)
• Escolhe verificação por SMS ou ligação → recebe código → confirma
• Após verificar, o número aparece com um Phone Number ID (15 dígitos) — anota
C.3 · Adicione informações de pagamento:
• Meta cobra por conversação (a partir da 1000ª/mês)
• Cartão internacional obrigatório — sem isso, envio bloqueia
C.4 · Envia mensagem de teste:
• Só funciona depois dos 3 passos acima concluídos
• Se der erro 130497, é porque Etapa 3 (Business Verification) ainda não passou
D) Copiar WABA ID (WhatsApp Business Account):
1. Em business.facebook.com/settings/whatsapp-business-accounts
2. Clica na tua conta → topo aparece "ID da conta do WhatsApp"
3. Copia (também tem 15 dígitos)
E) Gerar Token PERMANENTE (System User):
1. business.facebook.com/settings/system-users → + Adicionar
2. Nome:
WhatsApp API · Função: Admin3. Clica no usuário criado → Gerar novo token
4. Escolhe o App WhatsApp que criou no passo A
5. Expiração: NUNCA EXPIRA (crítico — Explorer token vence em 60 dias)
6. Permissões marca:
whatsapp_business_messaging, whatsapp_business_management, business_management7. Copia o token INTEIRO — só aparece 1x. Se perder, regenera
F) Etapa 3 · Verificação da empresa (Business Verification — obrigatória):
1. Volta em Casos de uso → Personalizar → Conectar no WhatsApp → menu esquerdo → Etapa 3 · Verificação da empresa
2. Ou direto: business.facebook.com/settings/security → Iniciar verificação
3. Anexa: cartão CNPJ, comprovante endereço do negócio, site verificável
4. Aprovação: 1-5 dias úteis (às vezes até 2 semanas)
5. Sem isso: erro 130497 ao enviar pra qualquer número que não seja "tester"
6. Enquanto espera aprovação: adiciona teu WhatsApp como test recipient no App pra testar
G) Warmup obrigatório (se conta anterior foi banida):
• Dia 1-2: máx 50 msgs/dia (só utility de compra confirmada)
• Dia 3-5: 100-200/dia
• Dia 6-10: 300-500/dia (utility majoritário)
• Dia 11+: escala 20%/dia se Quality Score = ALTA
• Nunca importe 10k+ contatos de uma vez — divide em levas
👁
Use o token de System User — não expira. Nunca use o token de usuário do API Explorer.
WhatsApp → API Setup → Phone Number ID (número de 15 dígitos)
Business Settings → WhatsApp Accounts → o ID da conta
📊 Cota de mensagens
Conversas abertas hoje
—
Limite diário: —
—
A Meta define o limite diário por tier de verificação. Negócio verificado começa em 1.000 conversas/dia e pode escalar até ilimitado.
🔔 Webhook de status
Cole essa URL em developers.facebook.com → seu App → WhatsApp → Configuration → Webhook. Não é no Business Manager — é no portal de Developers. Depois de colar, marque o campo
messages em "Webhook fields" pra receber respostas dos leads.Qualquer string que você definir. Coloque a mesma no Meta para verificar o webhook.
🧪 Envio de teste
Envie uma mensagem de template para qualquer número para validar a integração
📋 Templates aprovados
Conecte a API e clique em "Atualizar" para listar os templates