Skip to content
WhatIsUp.dev

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-10 — Saúde do número e anti-ban

  • A auto-proteção vem desligada desde 29/10/2026 (auto_protect é false por padrão em /v1/channels/{id}/pacing). O gateway avisa sobre a saúde do número e só desacelera as mensagens pra gente nova se você ligar a auto-proteção.
  • Saúde do número (GET /v1/channels/{id}/health, webhook channel.health) e auto-proteção: mensagens pra quem nunca escreveu pro número são espaçadas conforme a saúde dele. Respostas nunca atrasam.
  • Os limites do próprio WhatsApp por número (GET /v1/channels/{id}/limits, webhook channel.limits).
  • Ritmo de envio (GET/PUT /v1/channels/{id}/pacing) e um proxy por número (/v1/channels/{id}/proxy, códigos de erro proxy_*).
  • O gateway nunca recusa um envio por causa da saúde do número ou dos limites do WhatsApp. Um envio pra alguém novo enquanto o WhatsApp bloqueia conversas novas volta 202 com warnings (new_chat_restricted, new_chat_capped); o antigo 429 new_chat_restricted acabou.
  • Testes de proxy acima do limite por minuto respondem 429 proxy_test_limit.

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 operações documentadas em 85 paths na spec OpenAPI 3.1.
  • Catálogo de eventos de webhook: 25 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.
  • 8 tentativas de retentativa com backoff exponencial limitado (base 1s, teto 5min).
  • Fila de entrega durável com limite de concorrência por host.
  • O envelope do webhook carrega api_version: "v1". (A string 2026-04 de revisões anteriores desta documentação nunca foi emitida pelo gateway.)

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.