`instance.qr_required`

Se envía cuando: Una instancia necesita que escanees un código QR.

Qué trae data: Un objeto instance con status: "qr_required". El QR no viaja en el evento: pídelo con GET /instances/{instance}/qr (ver Instancias y conexión).

Para qué sirve: Mostrar el QR en tu propia aplicación o avisar a quien debe escanearlo.

Ejemplo

El cuerpo que recibe tu servidor (datos ficticios):

json

{
  "id": "evt_01EXAMPLE00000000000000008",
  "type": "instance.qr_required",
  "created_at": "2026-01-01T12:00:00.000000Z",
  "workspace_id": "ten_01EXAMPLE00000000000000000",
  "data": {
    "instance": {
      "id": "ins_01EXAMPLE00000000000000000",
      "name": "Support line",
      "status": "qr_required",
      "phone_number": "5255000000003",
      "profile_name": "Acme Support"
    }
  }
}

Todos los eventos comparten el mismo sobre (id, type, created_at, workspace_id, data) y los mismos headers de firma. Cómo verificarla, qué responder y cómo se reintenta: Webhooks.

instance.qr_required ​

Ejemplo ​

`instance.qr_required`

Ejemplo