Evento por instância

connection.update

Mudanca de estado da conexao da instancia.

flag: connectionUpdated

Requisição

http

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

Payload

json

{
  "data": {
    "connection": "open",
    "lastConnection": "2026-07-04T18:50:00Z",
    "type": "connected"
  },
  "event": "connection.update",
  "instance": {
    "connectionStatus": "online",
    "externalAttributes": {},
    "id": 1,
    "name": "codechat",
    "ownerJid": "[email protected]"
  },
  "timestamp": "2026-07-04T18:00:00Z"
}

typestring

obrigatório, não aceita `null`. Subtipo normalizado da conexao. Valores possíveis: `pair.success`, `connected`, `disconnected`, `logged.out`, `stream.replaced`, `keepalive.timeout`, `keepalive.restored`, `connect.failure`, `manual.reconnect`, `pair.error`, `stream.error`, `cat.refresh.error`.

connectionstring

obrigatório, não aceita `null`. Estado externo da conexao. Valores possíveis: `connecting`, `open`, `close`, `replaced`, `timeout`.

statusReasonnumber

opcional, não aceita `null`. Codigo numerico de motivo quando diferente de zero; omitido quando zero.

lastConnectionstring

opcional, não aceita `null`. Timestamp RFC3339 UTC quando informado; omitido quando ausente.

messagestring

opcional, não aceita `null`. Mensagem tecnica quando informada; omitida quando vazia.

Observações de entrega

`statusReason`, `lastConnection` e `message` usam `omitempty`; quando estao zerados ou vazios, nao aparecem no JSON.
Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.