Changelog

Histórico de mudanças relevantes na API REST e nos webhooks do wpp-gateway.

A API segue versionamento de URL: /v1/*. Breaking changes promovem para /v2/*. Adições não-breaking continuam em /v1/*.

Unreleased

Mudanças no main ainda não publicadas.

Release inicial pública do wpp-gateway.

Canais: Baileys (QR + pairing code), WABA (manual + Embedded Signup), Instagram (OAuth).
Messages: 15 tipos de conteúdo (text, image, video, audio, document, sticker, location, contact, button, list, template, cta_url, location_request, address_message, flow).
Operações de mensagem: react, edit, delete, read, typing.
Media: download via signed URL, upload Meta, resumable upload, TTL 7d com ACK pattern.
IA: transcrição (Whisper), OCR (gpt-4o-mini vision), summary, classify, AI Agent embarcado com knowledge base (pgvector RAG).
Webhooks: registro por phone, HMAC-SHA256, 8 retries com backoff exponencial, DLQ, replay manual.
Events SSE: /v1/events/stream para dashboards real-time.
WABA Templates: CRUD + Meta sync, suporte a carousel, OTP, flow buttons, limited time offer.
WABA Calls: signaling SDP (make/accept/reject/hangup), recording upload, transcrição.
WABA Groups: CRUD, participants, admins, join requests, send messages.
WABA Flows: CRUD + Meta sync, encryption RSA-OAEP para data_exchange, executions tracking.
Lookup: verificação de números (Baileys only).
Billing: invoices, Asaas (Pix/boleto/cartão), dunning automatizado.
Admin observability: audit logs, error events, AI usage analytics.
SDK React: Provider, hooks (usePhones, useChannelStatus, useQrCode), componentes (BaileysQRConnect, BaileysPairingConnect, WabaEmbeddedSignup, WabaManualConnect, ConnectChannelWizard).

Scopes granulares de API key ainda não implementados (campo scopes aceito mas não validado).
PDFs no OCR ainda não suportados (apenas image/*).
Webhook template:status e call:* payloads ainda em estabilização — schemas podem evoluir.