Apariencia
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.