Fase 0

Rastro, prova de conceito do webhook WhatsApp

Esta tela confirma que o app está de pé. A validação real acontece quando uma conversa Click-to-WhatsApp chega pelo webhook e aparece no endpoint técnico de referrals.

Webhook

/api/webhook/whatsapp

GET responde ao challenge do Meta. POST valida X-Hub-Signature-256, grava o evento cru e responde 200.

Inspeção de atribuição

/api/debug/referrals

Lista os últimos ctwa_clid e adId extraídos dos webhooks salvos.

Checklist local

  1. 01Subir Postgres com docker compose up -d.
  2. 02Rodar npx prisma migrate dev.
  3. 03Preencher .env com ENCRYPTION_KEY e dados do cliente piloto.
  4. 04Rodar npm run seed:client.
  5. 05Configurar o webhook no Meta apontando para /api/webhook/whatsapp.
  6. 06Abrir /api/debug/referrals para ver ctwa_clid e adId dos eventos recebidos.