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

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