Novidades
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.
Setembro de 2026
- Por que a conexão fechou: todo
connection.statusde fechamento trazreason(transient,restart_required,replaced,qr_not_scanned,logged_outoumanual),willReconnect(se a API reconecta sozinha) estatusCode. - QR code só para quem pode parear:
GET /connections/{id}/qreGET /tenants/{id}/connections/{connId}/qrdevolvem o QR code apenas a quem tem o escopoconnections:write(escanear o QR conecta um número, comoPOST /connections/{id}/pairing-code); com sóconnections:read,qreqrCodevêmnulle o status continua disponível (veja Escopos). - Pareamento por código:
POST /connections/{id}/pairing-codedevolve 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}/sendresponde429comerror: new_recipient_cap_reached(veja Limites de envio).GET /connections/{id}/queuemostra o limite e o uso (limits.newRecipientsPerDay,usage.newRecipients,warmup.endsAt). Umtoque não é um telefone nem um JID válido agora responde400comerror: 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.incomingvem por uma URL assinada, válida atédata.media.expiresAt(veja Baixar mídia). - Sinais do WhatsApp:
connection.statusinforma o bloqueio temporário de novas conversas (reachout_timelock) e o pareamento travado por passkey (passkey_required);message.deliveryemessage.send_failedtrazemreason: reachout_timelocked. - Clientes gerados em TypeScript e PHP.
Esta página ajudou? · Atualizado em 29 set 2026