Pular para o conteúdo

Novidades

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

Ver em Markdown

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.

Setembro de 2026

  • Por que a conexão fechou: todo 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 e GET /tenants/{id}/connections/{connId}/qr 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); com só connections:read, qr e qrCode vêm null e o status continua disponível (veja Escopos).
  • Pareamento por código: POST /connections/{id}/pairing-code 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). 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 responde 429 com error: new_recipient_cap_reached (veja Limites de envio). GET /connections/{id}/queue 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).
  • 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 e em inglês.
  • Chaves de API (wag_live_…) por projeto, com escopos, rotação sem interrupção e revogação imediata (veja Autenticação).
  • URLs de mídia assinadas: a mídia recebida em message.incoming vem por uma URL assinada, válida até data.media.expiresAt (veja Baixar mídia).
  • Sinais do WhatsApp: connection.status informa o bloqueio temporário de novas conversas (reachout_timelock) e o pareamento travado por passkey (passkey_required); message.delivery e message.send_failed trazem reason: reachout_timelocked.
  • Clientes gerados em TypeScript e PHP.
Esta página ajudou? · Atualizado em 29 set 2026