Conectar o WhatsApp Oficial da Meta

O canal Oficial usa a API da própria Meta — mais burocrático de configurar que o não-oficial, mas sem risco de banimento por causa do EnchaT.

Antes de começar

Você vai precisar de um App criado em developers.facebook.com com o produto WhatsApp adicionado. Esse cadastro é feito direto no site da Meta, fora do EnchaT — a Meta pede verificação da empresa para uso em produção.

Cadastrar a instância no EnchaT

Preencha o .env com as credenciais do App

No arquivo .env da sua instalação, preencha WHATSAPP_APP_SECRET e WHATSAPP_VERIFY_TOKEN com os valores do seu App na Meta, e reinicie: docker compose up -d.

Abra a aba WhatsApp e clique em Nova instância

Escolha o tipo Oficial. Preencha o número (com DDI, ex.: 5511999990000), um nome de exibição, o Phone Number ID e o Access Token — os dois últimos vêm do painel do seu App na Meta.

Configurar o webhook na Meta

No painel do seu App, em WhatsApp → Configuração, aponte o webhook para:

https://SEU_DOMINIO/api/webhooks/whatsapp

(ou http://SEU_IP:8080/api/webhooks/whatsapp se você ainda não configurou um domínio). Use o mesmo WHATSAPP_VERIFY_TOKEN que você colocou no .env no campo “Verificar token” da Meta, e assine o campo messages.

A janela de 24 horas se aplica aqui

Fora de uma janela de 24 horas desde a última mensagem do cliente, o canal Oficial só envia mensagens usando um modelo aprovado pela Meta — texto livre não funciona nesse período. Veja A janela de 24 horas e os modelos de mensagem.

Como saber que deu certo

Mande uma mensagem de teste para o número conectado — ela deve aparecer no Inbox do EnchaT em segundos.

Se algo der errado

Veja As mensagens não chegam ou não saem.