instance.error

Se envía cuando: Una instancia falló.

Qué trae data: Un objeto instance con status: "error" y error (un código en minúsculas, por ejemplo gateway_unavailable).

Para qué sirve: Alertar y reintentar la conexión con POST /instances/{instance}/connect.

Ejemplo

El cuerpo que recibe tu servidor (datos ficticios):

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

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.