/ X1 API Oficial
💬
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.
📋 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: WhatsApp API Producao
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: 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: Admin
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: whatsapp_business_messaging, whatsapp_business_management, business_management
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
👁
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
↗ Gerenciar no Meta
Conecte a API e clique em "Atualizar" para listar os templates