Evento por instância

qrcode.updated

Novo QR Code disponivel para pareamento da instancia.

flag: qrcodeUpdated

Requisição

http

POST /webhooks/codechat HTTP/1.1
Content-Type: application/json
x-webhook-event: qrcode.updated

Payload

json

{
  "data": {
    "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA",
    "code": "2@abc",
    "count": 1,
    "expiresAt": "2026-07-04T18:01:00Z",
    "expiresInSeconds": 60
  },
  "event": "qrcode.updated",
  "instance": {
    "connectionStatus": "qr_code",
    "externalAttributes": {},
    "id": 1,
    "name": "codechat",
    "ownerJid": null
  },
  "timestamp": "2026-07-04T18:00:00Z"
}

countnumber

obrigatório, não aceita `null`. Quantidade de QRs emitidos nesta tentativa.

codestring

obrigatório, não aceita `null`. Codigo bruto do QR Code.

base64string

obrigatório, não aceita `null`. Imagem do QR Code em data URL base64.

expiresInSecondsnumber

obrigatório, não aceita `null`. Tempo restante informado pelo canal de QR, em segundos.

expiresAtstring

obrigatório, não aceita `null`. Timestamp RFC3339 UTC calculado para expiracao do QR Code.

Observações de entrega

Evento emitido pelo fluxo de QR, nao diretamente por um struct de evento do whatsmeow.
Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.