Guia Meta Cloud API

API Oficial do WhatsApp Business

⚠️ Aviso Importante

A Meta Cloud API é significativamente mais complexa que a Evolution API.

Tempo estimado de configuração: 2-3 horas
Requisitos: Conta business, verificação, aprovação de aplicativo

Meta Cloud API vs Evolution API

Característica Evolution API Meta Cloud API
Tempo de Setup ✅ 5-10 minutos ❌ 2-3 horas
Complexidade ✅ Muito fácil ❌ Muito complexa
Tipo de Conta ✅ Qualquer WhatsApp ❌ Só WhatsApp Business
Aprovação ✅ Não precisa ❌ Precisa aprovação Meta
Custo ✅ Grátis (self-hosted) ⚠️ 1000 conversas grátis/mês
Confiabilidade ⚠️ Baseada em WhatsApp Web ✅ API Oficial Meta
Suporte ⚠️ Comunidade ✅ Suporte Meta oficial

💡 Nossa Recomendação

Use Evolution API se você:

  • Está começando agora
  • Quer testar rapidamente
  • Não quer burocracia
  • Quer gastar zero

Use Meta Cloud API apenas se você:

  • Precisa de API oficial do Meta
  • Tem tempo para configurar
  • Já tem WhatsApp Business
  • Precisa de suporte empresarial

O que você vai precisar

Processo Detalhado

Fase 1: Criar Contas (30-60 min)

  1. Acesse developers.facebook.com
  2. Crie uma conta de desenvolvedor (se não tiver)
  3. Acesse business.facebook.com
  4. Crie um Business Manager
  5. Configure informações da empresa

Fase 2: Criar Aplicativo (20-30 min)

  1. No Meta for Developers, clique "Criar Aplicativo"
  2. Escolha "Negócios" como tipo
  3. Dê um nome ao aplicativo
  4. Vincule ao Business Manager
  5. Adicione o produto "WhatsApp"

Fase 3: Configurar WhatsApp (30-45 min)

  1. Adicione número de telefone business
  2. Verifique o número via SMS ou chamada
  3. Configure perfil do negócio
  4. Obtenha credenciais da API
  5. Gere Access Token permanente

Fase 4: Teste e Verificação (1-2 semanas)

  1. Configure webhook URL
  2. Teste em modo sandbox
  3. Submeta para revisão da Meta
  4. Aguarde aprovação (pode levar dias)
  5. Mova para produção

⏰ Tempo Real Esperado

Setup técnico: 2-3 horas
Aprovação da Meta: 3-14 dias (em média)
Total: Pode levar até 2 semanas

Informações de Configuração

Após completar todo o processo, você terá:

Phone Number ID: wamid.XXXXXXX...

WhatsApp Business Account ID: 123456789...

Access Token: EAAxxxxxxxxxxxxxx...

Verify Token: (você define)

Use essas credenciais no Setup Wizard do bot.

Recursos Oficiais

Getting Started
Guia oficial Meta
Documentação
Docs completa da API
WhatsApp Manager
Gerenciar contas
Meus Apps
Dashboard de apps

Recomendação Final

💚 Comece com Evolution API!

Se você está em dúvida, comece com a Evolution API. É muito mais fácil, rápido e você pode testar seu bot imediatamente.

Depois, se precisar migrar para Meta Cloud API, você pode fazer isso sem problemas. O bot já estará pronto, você só troca o provedor de WhatsApp.

Ver Guia Evolution API
Ir para Setup Wizard Voltar ao Dashboard