Pular para o conteúdo principal

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.

Mudado​

  • messageId é o único identificador de mensagem exposto. O ID nativo do canal (wamid da Meta / key.id do Baileys) nunca é retornado. Operações de mensagem usam o messageId do gateway no path (POST /v1/messages/{messageId}/react, DELETE /v1/messages/{messageId}, etc.). quotedMessageId é o messageId do gateway da mensagem citada.
  • Webhooks canônicos entre canais. message:received e message:status têm o mesmo shape em Baileys / WABA / Instagram. Mídia inbound vem em media.downloadUrl. Status de message:status é lowercase: sent | delivered | read | failed | deleted.
  • Mídia: o handle de upload pra Meta é mediaHandle (body de POST /v1/messages e resposta de POST /v1/media/upload).

v0.1.0 — 2026-05-21​

Release inicial pública do wpp-gateway.

Adicionado​

  • 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.
  • 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.
  • 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.
  • SDK React: Provider, hooks (usePhones, useChannelStatus, useQrCode), componentes (BaileysQRConnect, BaileysPairingConnect, WabaEmbeddedSignup, WabaManualConnect, ConnectChannelWizard).

Conhecidos​

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