Ir al contenido

instance.disconnected ​

Se envía cuando: Una instancia se desconectó, o se cerró su sesión desde el teléfono.

Qué trae data: Un objeto instance. Cuando WhatsApp cerró la sesión, trae reason: "logged_out" y el estado logged_out: hay que conectar de nuevo y escanear un QR nuevo.

Para qué sirve: Alertar a tu equipo de que una instancia dejó de estar disponible.

Ejemplo ​

El cuerpo que recibe tu servidor (datos ficticios):

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

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.