# Novidades

Fonte: https://apiwpp.com/docs/novidades
Seção: Atualizações
Atualizado em: 2026-09-29

As mudanças da API que afetam quem a integra, da mais recente para a mais antiga, e a promessa de compatibilidade.

A API só muda de forma compatível: tipos de evento, campos e operações novos. Uma mudança que quebra integrações existentes é anunciada aqui antes, com o prazo e o caminho de migração.

> **Prepare a integração para crescer**
>
> Como a API ganha tipos de evento, campos e valores novos a qualquer momento, ignore os campos e os tipos de evento que o seu sistema não conhece, e responda `2xx` a eles. Os [clientes gerados](https://apiwpp.com/docs/clientes/typescript) já leem assim os valores novos.

## Setembro de 2026

- **Por que a conexão fechou**: todo [`connection.status`](https://apiwpp.com/docs/webhooks/connection-status) de fechamento traz `reason` (`transient`, `restart_required`, `replaced`, `qr_not_scanned`, `logged_out` ou `manual`), `willReconnect` (se a API reconecta sozinha) e `statusCode`.
- **QR code só para quem pode parear**: [`GET /connections/{id}/qr`](https://apiwpp.com/docs/api/conexoes/qr-code-e-status) e [`GET /tenants/{id}/connections/{connId}/qr`](https://apiwpp.com/docs/api/projetos/qr-code-como-imagem) devolvem o QR code apenas a quem tem o escopo `connections:write` (escanear o QR conecta um número, como [`POST /connections/{id}/pairing-code`](https://apiwpp.com/docs/api/conexoes/codigo-de-pareamento)); com só `connections:read`, `qr` e `qrCode` vêm `null` e o status continua disponível (veja [Escopos](https://apiwpp.com/docs/referencia/escopos)).
- **Pareamento por código**: [`POST /connections/{id}/pairing-code`](https://apiwpp.com/docs/api/conexoes/codigo-de-pareamento) devolve um código de 8 caracteres para conectar o número digitando-o no celular, em vez de escanear o QR code, e até quando ele vale (`expiresAt`; veja [Parear um número](https://apiwpp.com/docs/guias/parear-um-numero)). Ele não evita o pedido de passkey.
- **Aquecimento e destinatários novos**: um número conectado há menos de 14 dias envia com limites menores, e cada número tem um limite de destinatários novos por 24 horas; acima dele, [`POST /connections/{id}/send`](https://apiwpp.com/docs/api/mensagens/enviar-mensagem) responde `429` com `error: new_recipient_cap_reached` (veja [Limites de envio](https://apiwpp.com/docs/guias/limites-de-envio)). [`GET /connections/{id}/queue`](https://apiwpp.com/docs/api/mensagens/fila-do-numero) mostra o limite e o uso (`limits.newRecipientsPerDay`, `usage.newRecipients`, `warmup.endsAt`). Um `to` que não é um telefone nem um JID válido agora responde `400` com `error: invalid_recipient` (veja [Códigos de erro](https://apiwpp.com/docs/referencia/codigos-de-erro)).
- **Documentação pública** com guias em português e a referência da API gerada da especificação OpenAPI 3.1, com a seção de webhooks. A especificação pode ser baixada [em português](https://apiwpp.com/docs/openapi.pt-BR.json) e [em inglês](https://apiwpp.com/docs/openapi.json).
- **Chaves de API** (`wag_live_…`) por projeto, com escopos, rotação sem interrupção e revogação imediata (veja [Autenticação](https://apiwpp.com/docs/autenticacao)).
- **URLs de mídia assinadas**: a mídia recebida em [`message.incoming`](https://apiwpp.com/docs/webhooks/message-incoming) vem por uma URL assinada, válida até `data.media.expiresAt` (veja [Baixar mídia](https://apiwpp.com/docs/api/midia/baixar-midia)).
- **Sinais do WhatsApp**: [`connection.status`](https://apiwpp.com/docs/webhooks/connection-status) informa o bloqueio temporário de novas conversas (`reachout_timelock`) e o pareamento travado por passkey (`passkey_required`); [`message.delivery`](https://apiwpp.com/docs/webhooks/message-delivery) e [`message.send_failed`](https://apiwpp.com/docs/webhooks/message-send-failed) trazem `reason: reachout_timelocked`.
- **Clientes gerados** em [TypeScript](https://apiwpp.com/docs/clientes/typescript) e [PHP](https://apiwpp.com/docs/clientes/php).
