Changelog

Tratamos /v1 como uma superfície estável para sempre. Mudanças que quebram compatibilidade ganham um novo prefixo (/v2) e uma janela longa de descontinuação. Adições e correções de bugs entram em /v1 continuamente.

2026-05 — Lançamento do MVP

• Spec pública OpenAPI 3.1 em /openapi.json.
• llms.txt + llms-full.txt na raiz do marketing.
• Referência de API Scalar no estilo Stripe em /docs/api.
• 117 endpoints documentados em 22 tags.
• Catálogo de eventos de webhook: 19 eventos.
• Conjunto estável de códigos de erro: 26 códigos (veja Erros).

2026-04 — Assinatura de webhook v1

• Assinatura HMAC-SHA256 em toda entrega de saída.
• Headers: X-WhatIsUp-Signature, X-WhatIsUp-Event, X-WhatIsUp-Event-Id, X-WhatIsUp-Correlation-Id.
• 5 tentativas de retentativa com backoff exponencial.
• Dispatcher de entrega baseado em BullMQ; limite de concorrência por host.
• O envelope do webhook carrega api_version: 2026-04.

2026-03 — Reforço do ciclo de vida do canal

• Transições estritas de máquina de estados aplicadas no servidor (código de erro invalid_lifecycle_transition).
• Concorrência otimista nas escritas de ciclo de vida (código de erro concurrent_modification).
• POST /v1/channels/{id}/pair-code como alternativa ao QR.

2026-02 — Grupos + Comunidades

• Superfície completa de grupos no formato Whapi (16 endpoints).
• Comunidades (6 endpoints).
• Eventos de webhook de grupo de entrada.

2026-01 — Beta público inicial

• Canais, mensagens, contatos, conversas, presença, perfil, mídia, webhooks, chaves de API, limites de requisições, status, eventos SSE.
• Pareamento por QR.
• Planos: Trial / Starter / Pro.

O que vem por aí

• Idempotency-Key baseado em header (P1).
• Documentação de UX de postagem de newsletter (P1).
• Ambiente de sandbox / modo de teste (P2).
• Lista de chamadas + histórico (P2).
• Lista de stories + rastreamento de visualizações (P3).

Acompanhe a análise completa de lacunas na nossa matriz de capacidades do WhatsApp interna.