https://documentacion.onelyra.com/seguimiento/salud-del-documento/ · Actualizado el 25 de octubre de 2026
Cada documento se revisa solo. Mientras lo configuras, ELYRA lo recorre entero y te avisa de lo que impediría que una conversación funcione: una opción que no lleva a ninguna parte, un dato que nadie pregunta, un sistema apagado, un paso donde la gente se va. Esos avisos se leen en la línea El documento observa, arriba del documento.
Un carro no te enseña un informe: enciende un testigo. Con mirarlo sabes dónde está el problema y cuánto urge, y decides si puedes seguir andando o tienes que parar. La salud del documento funciona igual.
La línea lleva seis testigos, uno por cada familia de avisos:
| Testigo | Qué vigila | |
|---|---|---|
| El camino de la conversación | Que cada opción lleve a algún sitio y que ninguna conversación se quede sin salida | |
| Los datos que se piden y se usan | Que lo que se pregunta se use, y que lo que se usa venga de alguna parte | |
| Los sistemas conectados | Que los sistemas a los que llama la conversación estén encendidos, respondan y devuelvan lo que se espera de ellos | |
| Las personas y el portero | Que al pasar a una persona haya alguien, y que el portero ofrezca lo que existe | |
| Lo que enseña el uso real | Por dónde se va la gente, qué opciones nadie elige y qué tarda demasiado, con las conversaciones de verdad | |
| El orden de la casa | Lo que no rompe una conversación pero confunde a quien configura: nombres repetidos, propósitos en blanco | |
Y se leen así:
| Cómo se ve | Qué quiere decir | |
|---|---|---|
| Apagado, casi transparente | Nada que decir en esa familia | |
| 3 | Amarillo, con un número | Avisos: algo funciona peor de lo que podría. Se puede seguir, y conviene revisarlo |
| 1 | Rojo, con un número | Un error: hay un camino que no funciona |
| 1 | Rojo y titilando | Un error por el que está pasando gente en los últimos 30 días. Es lo primero que se arregla |
Un rojo quieto es un problema que todavía no ha alcanzado a nadie; uno que titila ya le está pasando a alguien. Por eso solo titila ese.
Al pulsar un testigo se abre la lista con solo sus avisos; al pulsarlo otra vez vuelve la lista entera. Cada aviso dice el caso concreto («La opción “Soporte” llama una capacidad que ya no existe») y, al pulsarlo, el documento lleva al bloque donde ocurre.
El círculo con la interrogación de cada aviso lleva a su ficha en esta misma página: qué significa y cómo se apaga. Un testigo se apaga solo en cuanto se arregla la causa; no hay que marcarlo como resuelto.
Algunos avisos, como una pregunta donde mucha gente se va, se pueden responder cuando la causa ya se conoce: en el documento de la capacidad, el aviso ofrece «¿Sabes por qué?». La respuesta se guarda como un saber de esa capacidad y el aviso deja de acusarse mientras ese saber siga vigente.
Una ficha por cada aviso que puede dar el documento, agrupadas por su testigo. El texto del aviso en el portal cambia con cada caso; la ficha explica el aviso en general.
Error Un ciclo sin salida entre capacidades
Qué significa. Una capacidad llama a otra a secas y esa vuelve a la primera, también a secas: la conversación gira sin que nadie pueda salir, hasta que ELYRA la corta.
Cómo se arregla. Pon una condición, un menú o una pregunta en alguna de las llamadas del ciclo, o quita la llamada que vuelve.
Error Un flujo que no hace nada
Qué significa. El flujo no pregunta nada ni ejecuta nada. Al abrirlo, la conversación se corta con un error.
Cómo se arregla. Dale al menos una pregunta o una operación, o deja de llamarlo.
Error Un menú más largo de lo que el canal enseña
Qué significa. Cada canal tiene un máximo de opciones por lista. Las que pasan de ese máximo no le llegan a nadie.
Cómo se arregla. Reparte las opciones en dos menús, por ejemplo con una opción «Más» que abra el segundo.
Error Un paso que ejecuta y no sigue
Qué significa. Un paso hace su trabajo y no continúa hacia nada. La persona espera una respuesta que nunca llega.
Cómo se arregla. Dile al paso qué viene después: un mensaje, otra pregunta o la despedida.
Error Una capacidad que no se puede ejecutar por filas
Qué significa. El bloque «Por cada fila» ejecuta una capacidad una vez por fila de un archivo, y esa capacidad (o alguna que llama) necesita a una persona delante: un menú, un puente, un archivo, o una pregunta sin nombre de dato. Quien mande el archivo oirá que no se puede.
Cómo se arregla. El texto del hallazgo nombra el hueco exacto. Arréglalo en esa capacidad, o apunta el bloque a otra que solo pregunte, decida y ejecute.
Error Una opción apunta a un flujo que no existe
Qué significa. La opción lleva a un flujo que se borró. Quien la elige se queda sin respuesta.
Cómo se arregla. Apunta la opción a una capacidad que exista, o quítala.
Error Una opción apunta a una operación que no existe
Qué significa. La opción ejecuta una operación que se borró. Quien la elige se queda sin respuesta.
Cómo se arregla. Apunta la opción a otra operación o capacidad, o quítala.
Error Una opción llama a una capacidad que no existe
Qué significa. La opción apunta a una capacidad que se borró. Quien la elige se queda sin respuesta.
Cómo se arregla. Apunta la opción a otra capacidad, o quítala del menú.
Error Una opción sin destino
Qué significa. Una opción del menú no lleva a ningún sitio. Quien la elige no recibe respuesta.
Cómo se arregla. Abre el menú y dile a la opción qué hace: qué capacidad llama, o quítala.
Aviso Dos bloques dejan su resultado en el mismo dato
Qué significa. Dos bloques del mismo tipo (dos servicios, dos lotes) dejan cómo acabaron en el mismo dato, y un camino lo lee después de los dos: solo verá el resultado del segundo, porque el segundo pisa al primero.
Cómo se arregla. En el ⚙ de uno de los dos, cambia «Dónde deja su resultado» por otro nombre (por ejemplo resultado_altas) y haz que el camino mire ese.
Aviso El «si no» no va de último
Qué significa. Las condiciones se leen en orden y gana la primera que se cumple. El «si no» se cumple siempre, así que lo que va detrás de él no se mira nunca.
Cómo se arregla. Mueve el «si no» al final de la lista.
Aviso Se ofrece una capacidad sin darle lo que necesita
Qué significa. La capacidad ofrecida necesita unos datos para trabajar, y en este camino nadie se los da. Quien la elige no puede terminar.
Cómo se arregla. Pregunta esos datos antes de ofrecerla, o entrégaselos desde la opción que la llama.
Aviso Un ciclo entre capacidades
Qué significa. Una capacidad acaba volviendo a otra que ya pasó. Hay por dónde salir (un menú, una condición), así que puede ser el reintento que querías, pero conviene saberlo.
Cómo se arregla. Si es a propósito, nada. Si no, quita la llamada que vuelve.
Aviso Una capacidad que termina sin ofrecer nada
Qué significa. Se llega a ella desde el último menú, y al acabar no pregunta ni despide: la persona se queda sin saber qué hacer.
Cómo se arregla. Ciérrala con un menú de «¿algo más?» o llamando a la capacidad de cierre.
Aviso Una sección sin opciones
Qué significa. Quien entra a la sección encuentra «no hay opciones configuradas».
Cómo se arregla. Añádele opciones o quítala del menú.
Aviso Se pregunta algo que nadie usa
Qué significa. La respuesta no la usa ninguna operación ni ningún mensaje: la persona contesta para nada.
Cómo se arregla. Quita la pregunta o usa la respuesta donde haga falta.
Aviso Un mensaje menciona un dato que nadie produce
Qué significa. El texto nombra un dato entre llaves que no sale de ninguna parte. La persona vería las llaves tal cual, así que ELYRA quita ese trozo al enviarlo.
Cómo se arregla. Cambia el dato por uno que exista. Cuando hay candidatos, el aviso los ofrece con un botón.
Aviso Un mensaje repite el mismo dato
Qué significa. El mismo dato aparece varias veces en el mensaje y la persona lo lee duplicado.
Cómo se arregla. Deja el dato una sola vez.
Aviso Una operación usa un dato que nadie produce
Qué significa. La petición al sistema lleva un dato que ningún paso anterior pregunta ni calcula. ELYRA frena la llamada antes de enviarla incompleta.
Cómo se arregla. Pregunta ese dato antes de la operación, o corrige su nombre en la petición.
Error El sistema de una operación está fallando
Qué significa. La última comprobación del sistema conectado falló, y la operación que lo usa no va a funcionar.
Cómo se arregla. Abre el sistema en Conexiones, mira el motivo y vuelve a probarlo.
Aviso El sistema de una operación está apagado
Qué significa. El sistema se apagó a propósito. Mientras siga así, la operación que lo usa no se ejecuta.
Cómo se arregla. Enciéndelo en Conexiones, o quita la operación si ese sistema ya no se usa.
Aviso Se espera sacar un dato de donde nunca ha venido
Qué significa. La operación lee un dato de una ruta de la respuesta, y esa ruta no ha aparecido en ninguna respuesta real.
Cómo se arregla. Revisa la ruta contra una respuesta real del sistema: el nombre exacto importa, mayúsculas y espacios incluidos.
Aviso Un listado busca su lista donde no está
Qué significa. El listado espera la colección en una ruta de la respuesta que no ha venido en ninguna respuesta real.
Cómo se arregla. Corrige la ruta de la colección con una respuesta real del sistema delante.
Aviso Un listado usa un dato que sus elementos no traen
Qué significa. Cada elemento del listado muestra un dato que, en las respuestas reales, los elementos no traen. Saldría vacío.
Cómo se arregla. Cambia el dato por uno que los elementos sí traigan.
Aviso Un mensaje espera un dato que el sistema nunca ha enviado
Qué significa. En las respuestas reales que ELYRA ha visto de ese sistema, el dato que el mensaje menciona no ha venido nunca.
Cómo se arregla. Comprueba el nombre exacto del dato en la respuesta del sistema. Cuando hay candidatos, el aviso los ofrece con un botón.
Aviso Una escritura sin comprobación
Qué significa. La operación escribe en un sistema y no tiene cómo comprobar el resultado. Si el sistema tarda demasiado en contestar, no se puede saber si lo escrito quedó registrado.
Cómo se arregla. Configura en la operación la consulta que comprueba si quedó, para que ELYRA lo mire cuando la respuesta no llegue.
Aviso El portero está anclado a un bloque que no existe
Qué significa. El portero despierta en un punto concreto del documento, y ese punto se borró. Así no despierta nunca.
Cómo se arregla. Vuelve a elegir dónde despierta, en Comportamiento.
Aviso El portero ofrece capacidades que no existen
Qué significa. Entre las capacidades que el portero puede ofrecer hay algunas que se borraron. No se ofrecen, pero siguen en su lista.
Cómo se arregla. Guarda otra vez el portero en Comportamiento: las que no existen salen de la lista.
Aviso Nadie puede cerrar la conversación a mano
Qué significa. Con los comandos que tiene la puerta, ni la persona ni el agente pueden cerrar la conversación: se cierra sola tras unas horas de silencio.
Cómo se arregla. En Comandos, enciende «Cerrarla» para la persona o para el agente.
Aviso Nadie tiene el permiso que pide «Por cada fila»
Qué significa. El bloque exige un privilegio y ninguna persona de la agenda lo tiene. Quien mande el archivo oirá que le falta permiso.
Cómo se arregla. Dale ese privilegio en Personas a quien pueda lanzar lotes, o cambia el nombre del permiso en el bloque.
Aviso Se pasa a un equipo sin nadie
Qué significa. «Pasar a una persona» avisa a un equipo que no tiene a nadie. La persona oirá que no hay quien la atienda.
Cómo se arregla. Pon gente en el equipo desde la Central, o apunta el bloque a otro equipo.
Aviso Se pide calificar una atención que no existe
Qué significa. El bloque «Calificar» pide la nota de quien atendió, pero en este camino nadie pasa a una persona. El voto se guarda como de la conversación.
Cómo se arregla. Pon el bloque en «esta interacción», o usa esta encuesta como la del cierre de un «Pasar a una persona».
Aviso Lo que la gente escribe en un menú queda en duda
Qué significa. Cuando la persona escribe en vez de elegir, ELYRA duda a menudo, y casi siempre en la misma opción.
Cómo se arregla. Describe esa opción por lo que resuelve, no por el objeto que toca: «Saber en qué va mi caso», mejor que «Caso».
Aviso Mucha gente se va en este paso
Qué significa. Una parte grande de quienes llegan a esta pregunta se va sin contestar. Puede ser una pregunta que no se entiende, o que pide algo que la persona no tiene a mano.
Cómo se arregla. Reescribe la pregunta más clara o más corta. Si la causa se conoce, respóndela con «¿Sabes por qué?» en el documento de la capacidad y el aviso deja de acusarse.
Aviso Una opción que nadie elige
Qué significa. Por el menú pasó gente que eligió otras opciones, y esta no la eligió nadie en el periodo observado.
Cómo se arregla. Quítala si no hace falta, o cambia su nombre si es que no se entiende.
Aviso Una operación mucho más lenta que las demás
Qué significa. En las llamadas reales, esta operación tarda varias veces lo que tardan las demás. La persona espera.
Cómo se arregla. Revisa la operación y su sistema: una consulta más estrecha o un filtro pueden bastar.
Aviso Dos capacidades con el mismo nombre
Qué significa. Hay otra capacidad que se llama igual. En los menús y en los selectores no se distinguen.
Cómo se arregla. Unifícalas con el botón del aviso (lo que usaba una pasa a la otra) o cámbiale el nombre a una.
Aviso Sin propósito
Qué significa. Falta la línea que dice qué sabe hacer. Es lo que lee quien llega al documento, y lo que usa ELYRA para entender cuándo ofrecerlo.
Cómo se arregla. Escribe una línea con lo que resuelve, en palabras de quien lo usa.
Aviso Un saber que no cuelga de ninguna capacidad
Qué significa. Una respuesta guardada como saber quedó suelta, sin la capacidad que le daba contexto. Se citaría sin saber de qué habla.
Cómo se arregla. Muévela a la capacidad que le corresponde, o bórrala.
