Configuração Meta e WhatsApp Business (Cloud API)

O Convord processa pedidos e mensagens recebidos pela WhatsApp Cloud API. Os valores abaixo são lidos do .env do servidor no grupo de config whatsapp.

Pré-requisitos

1. Um app Meta Business com o produto WhatsApp habilitado e um telefone WhatsApp Business ativo (teste ou produção).
2. Uma URL HTTPS pública estável para webhooks (use um túnel como ngrok para testes locais).
3. Documentação oficial: WhatsApp Cloud API — Get Started.

Variáveis do servidor (.env)

Chaves usadas para chamadas Graph e verificação de webhook:

• WHATSAPP_API_TOKEN — Token temporário ou de usuário do sistema da Meta. Lembre-se de rotacionar tokens expirados em produção.
• WHATSAPP_PHONE_NUMBER_ID — De WhatsApp → API Setup: Phone number ID.
• WHATSAPP_VERIFY_TOKEN — String secreta que você inventa; o campo “Verify” do webhook da Meta deve usar o mesmo valor.
• WHATSAPP_API_URL — Opcional; ex.: https://graph.facebook.com/v18.0 (atualize a versão quando fizer upgrade).

URL do webhook

Use esta URL completa como “Callback URL” da Meta: https://convord.com/webhook/whatsapp

• Verificação GET: hub.verify_token deve corresponder a WHATSAPP_VERIFY_TOKEN.
• Eventos POST: mensagens recebidas chegam neste endpoint; o app trata validação e processamento.

Após a configuração

Quando “Verify” for bem-sucedido na Meta, envie uma mensagem de teste de um número permitido e inspecione os logs da aplicação. Erros Graph geralmente incluem detalhes no corpo da resposta.

Mais informações

Leia junto com o Guia de integração para vinculação de clientes e operações.

Guia completo Meta Developer (Etapas 1–7, repositório) →