Consultar cómo está ELYRA

Un sistema de monitoreo, un tablero de la empresa o un reporte que se arma solo pueden preguntarle a ELYRA cómo está. Es la familia Consultas: diez llamadas de solo lectura, todas con una credencial que tenga esa familia.

Son las mismas preguntas que hace de fábrica el sistema «ELYRA» del portal (la capacidad Administrar mi ELYRA): él las hace por esta misma puerta, con una credencial propia que solo abre Consultas. Lo que el cliente ve conversando y lo que un sistema lee por la API es lo mismo.

Lo que se promete y lo que no

Todo lo que devuelve Consultas son números y estado. Ni el texto de una conversación, ni lo que un sistema respondió a una llamada, ni la dirección completa de una persona. Quien escribió se nombra por su alias: el canal y la cola del remitente («WhatsApp ···4567»), suficiente para distinguir y no para identificar. Es la misma regla con la que trabaja la evidencia cuando el contenido está apagado.

Como todo lo de esta sección, las diez formas de respuesta son contrato: se pueden añadir campos, nunca quitarlos (Lo que se garantiza).

Las diez preguntas

Llamada	Qué responde
GET /consultas/salud	El semáforo: si la puerta de entrada responde (en pie, caída, sin comprobar, no te hace falta) y cuántos canales están vivos. Prueba los canales al pedirlo.
GET /consultas/alertas	Lo que avisa la campanita del portal: errores de las últimas 24 horas, piezas rotas, entregas rechazadas y topes cerca. En números, con el detalle de lo roto y lo rechazado.
GET /consultas/uso?dias=30	Cómo fue la operación en 7, 30 o 90 días: conversaciones, las que se fueron sin cerrar, las escaladas a una persona, lo no entendido, los sistemas que fallan y la satisfacción.
GET /consultas/canales	Cada canal con su tipo, su estado y su última prueba. Sin credenciales ni configuración.
GET /consultas/sistemas	Cada sistema conectado con su estado y su última prueba; el de fábrica marcado. Sin direcciones ni recetas de acceso.
GET /consultas/capacidades	Lo que ELYRA sabe hacer, por su nombre, con los datos que cada capacidad pide y produce.
GET /consultas/ia	Qué hizo la inteligencia artificial: frases leídas, las que llevó a una capacidad, el acierto, las dudas y lo que falló.
GET /consultas/conversaciones?limite=30	Las últimas conversaciones: quién (por alias), por dónde, cuándo empezó, el último turno y cómo acabó.
GET /consultas/llamadas?limite=25&solo_fallos=false	Lo que ELYRA le pidió a los sistemas: sistema, operación, estado y duración.
GET /consultas/puentes?limite=30	Quién pidió hablar con una persona del equipo, quién atendió y cómo acabó.

Las listas aceptan limite (hasta 100) y vienen de la más reciente atrás.

Un ejemplo: el semáforo cada cinco minutos

curl -s "https://tu-empresa.onelyra.com/api/integraciones/v1/consultas/salud" \
  -H "Authorization: Bearer cs_…"

{
  "puerta": "en pie",
  "canales": 3,
  "canales_vivos": 3,
  "canales_caidos": 0,
  "ultima_conversacion": "2026-10-07T14:12:03-05:00"
}

Un monitoreo que vigile puerta != "en pie" o canales_caidos > 0 ya sabe cuándo avisar. Y alertas.rotos dice cuántas piezas no responden ahora, con su nombre y su motivo en piezas_rotas.

Lo que responde al equivocarse

Código	Qué pasa
sin_permiso (403)	La credencial no tiene la familia consultas. Se marca en su tarjeta.
no_valido (422)	Una ventana de dias que no se ofrece; detail dice cuáles hay.

Las respuestas de entrada (no_autenticado, demasiados_intentos) son las de toda la API: La credencial.

Relacionado: Referencia interactiva · Errores, reintentos y duplicados.