API oficial da Meta
Passo a passo para conectar a API oficial do WhatsApp Business (Meta), sem QR Code e sem risco de banimento.
A API oficial do WhatsApp Business Platform é a forma de conexão fornecida pela própria Meta. Não usa QR Code, não corre risco de banimento por automação e permite templates aprovados para iniciar conversas. É um adicional pago (R$ 97,90/mês) que precisa estar ativo na sua conta.
Há duas formas de configurar: pela janela Nova Conexão → Meta Oficial ou pelo assistente dedicado Conectar API Oficial Meta (/dashboard/connections/meta-setup), descrito abaixo.
Etapa 1 — Credenciais
📋 Como obter as credenciais:
- Acesse Meta for Developers → seu App → WhatsApp → Configuração da API.
- Copie o Phone Number ID do número desejado.
- Copie o WhatsApp Business Account ID (WABA ID).
- Gere um Token Permanente via System User no Business Manager.
Preencha:
| Campo | Detalhe |
|---|---|
| Nome da Instância | Ex.: meta-vendas. Apenas letras minúsculas, números e hífens. |
| Phone Number ID | Obrigatório. |
| WABA ID | Obrigatório. |
| Token Permanente | Obrigatório. O botão Mostrar/Ocultar exibe o token. |
Clique em ✅ Salvar e Continuar →. Aparece "✅ Conexão criada! Configure o webhook na Meta."
Etapa 2 — Configurar Webhook
O webhook é o endereço para onde a Meta envia as mensagens que seus clientes mandam. Sem ele você envia, mas não recebe.
No Meta for Developers → seu App → WhatsApp → Configuração → Webhooks, preencha:
| Campo na Meta | O que colar |
|---|---|
| URL do Callback | A URL exibida na tela (botão Copiar). |
| Token de Verificação | O token exibido na tela (botão Copiar). |
| Eventos para subscrever | messages e message_status_updates. |
Clique em Ir para Conexões → para terminar.
Depois de conectar
- O cartão mostra 🔵 Gerenciado via Meta API Graph — não há QR Code nem botão de reconectar. Para trocar credenciais, recrie a conexão ("Conexão Meta Oficial é gerenciada via API Graph. Recrie a conexão para atualizar as credenciais.").
- O menu passa a mostrar Templates Meta, onde você sincroniza seus modelos aprovados — veja Templates Meta.
- No Atendimento vale a janela de 24 horas.
- A API oficial não permite verificar se um número tem WhatsApp — o filtro de números precisa de outra conexão.