Bot de Telegram
Conectá tu Telegram al bot de Lymen, sin configurar nada, para recibir tus avisos de incidentes y consultar el estado de tu organización con comandos como /estado o /incidentes. Ve lo mismo que vos en el portal, solo para leer.
En esta página
Para qué sirve#
Lymen tiene un bot de Telegram propio, que en Telegram se llama @lymen_bot. Cada persona lo conecta con su cuenta de Telegram y, por ese chat:
- Recibe sus avisos de incidentes, los de los perfiles de alerta donde está elegida por Telegram.
- Consulta con comandos: escribe
/estado,/incidenteso/serviciosy el bot le contesta con los datos de su organización.
No hay que crear un bot, ni cargar un token, ni conseguir números de chat. Es la forma más simple de tener Lymen en el celular.
Algunas cosas que podés hacer:
- Ver "¿cómo está todo?" con
/estado, sin abrir el portal. - Enterarte de un incidente en cuanto se abre y tocar Detalle para leer de qué se trata.
- Preguntar por un servicio con
/servicio pagosmientras volvés a casa. - Pausar los avisos un rato con
/silenciar 2h.
Para quién es#
Para cualquier persona de tu organización que tenga el permiso Asistentes de IA › Ver (lo tienen los roles de fábrica Administrador, IT, Dirección y Auditor; ver Asistentes de IA). Cada persona conecta su propio Telegram: el bot la reconoce por su cuenta de Lymen, no por lo que escriba en el chat. Se conecta en Configuración › Integraciones › Telegram: si tu rol tiene Asistentes de IA › Ver pero no Integraciones › Ver, ahí ves solo esta opción, sin las integraciones de la organización.
El bot de Lymen es opcional: quien no lo conecta sigue recibiendo sus avisos por los otros canales, como el email.
Cómo conectarlo, paso a paso#
Necesitás Telegram instalado en tu celular o en tu computadora, con tu cuenta ya abierta.
- En Lymen, entrá a Configuración › Integraciones. Arriba de todo está la sección Telegram, y en ella la opción Bot de Lymen (la recomendada).
- Tocá Conectar Telegram. Lymen genera un enlace personal.
- Tocá el botón que abre Telegram. Si estás en una computadora y Telegram está en tu celular, copiá el enlace y abrilo desde el celular.
- En Telegram se abre el chat con el bot de Lymen. Fijate que el bot sea @lymen_bot y tocá Iniciar (o Start).
- El bot te contesta que falta un paso: confirmar la conexión en el portal. Todavía no quedó conectado.
- Volvé al portal. La tarjeta Telegram muestra, solita, qué cuenta de Telegram se quiere conectar, con su nombre y su @usuario tal como figuran en Telegram. Revisá que sea la tuya y tocá Sí, conectar.
- Listo: la tarjeta pasa a conectado y el bot te manda un saludo que nombra tu organización y te dice que escribas
/ayuda.
Lo que tenés que saber del enlace:
- Vale 10 minutos y se usa una sola vez. La tarjeta te muestra cuánto falta para que venza. Si pasa el tiempo o lo usás, generá uno nuevo.
- Es personal. No se lo mandes a nadie ni lo publiques. Aunque otra persona lo abra, la conexión no se hace sola: falta que vos la confirmes en el portal, viendo qué cuenta de Telegram es.
- Si aparece una cuenta que no es la tuya, tocá No soy yo. Se cancela el pedido, no se conecta nada y el enlace deja de servir. Si querés conectar tu Telegram, generá un enlace nuevo y no lo compartas.
- Tenés 10 minutos para confirmar. Si pasa el tiempo, la tarjeta te avisa "Ese pedido venció" y hay que generar un enlace nuevo.
- Solo funciona en un chat privado con el bot. En un grupo, el bot solo contesta "Escribime por privado".
- Podés tener un solo chat de Telegram conectado por organización. Si ya tenés uno y pedís conectar otro, el portal te avisa que, si confirmás, el chat anterior se desconecta.
Cuando termina, la tarjeta muestra tu nombre en Telegram, desde cuándo estás conectado, cuándo lo usaste por última vez, si tenés los avisos pausados y si ya tenés un contacto enlazado para recibir avisos. Con Mandar mensaje de prueba el bot te escribe en el chat para que confirmes que llega.
Cómo recibir avisos#
Conectar el bot te deja consultar. Para que además te lleguen los avisos, hace falta un contacto con tu mismo email:
- Cargá un contacto en Contactos con el email con el que entrás a Lymen (si ya existe, alcanza). Lymen compara los emails sin distinguir mayúsculas de minúsculas.
- En un perfil de alerta, en A quién y por dónde, elegí a ese contacto con Telegram.
Lymen enlaza el contacto con tu chat solo: lo hace al conectar el bot y también cuando creás o editás un contacto cuyo email es el de una persona ya conectada. En la ficha del contacto, el chat aparece de solo lectura con la leyenda Conectado por el bot de Lymen.
Si todavía no tenés ese contacto, la tarjeta Telegram del portal te avisa que para recibir avisos hace falta uno con tu email.
Cada aviso llega con dos botones:
| Botón | Qué hace |
|---|---|
| Ver en Lymen | Abre el incidente en el portal. |
| Detalle | Te manda en el mismo chat el detalle del incidente, como /incidente. |
El aviso de prueba de un perfil y los avisos de las automatizaciones llegan sin el botón Detalle.
Comandos#
Los comandos se escriben en el chat con el bot. Todos devuelven texto simple, con los problemas primero y en tu zona horaria. Si no hay nada que mostrar, el bot lo dice ("No hay incidentes abiertos.").
| Comando | Qué muestra | Ejemplo |
|---|---|---|
/estado |
El resumen: cómo está todo, cuántos incidentes hay abiertos y cuántos servicios andan mal. Acepta un ambiente. | /estado o /estado qa |
/incidentes |
Los incidentes abiertos (hasta 8), los más graves primero, con su causa probable y qué afectan. Cada uno trae un botón Detalle. Acepta un ambiente. | /incidentes o /incidentes qa |
/incidente <id> |
El detalle de uno: estado, desde cuándo, causa probable, qué afecta y los últimos pasos. Trae un botón Abrir en Lymen. | /incidente I-1731500000 |
/servicios |
Los servicios con su salud, los que andan mal primero (hasta 12). Acepta un ambiente. | /servicios o /servicios qa |
/servicio <nombre> |
Un servicio: pedidos, errores, tiempos, de quién depende y quién lo llama. Si el nombre no existe, sugiere parecidos. Trae un botón Abrir en Lymen. | /servicio pagos |
/anomalias |
Lo que se salió de lo normal en las últimas 24 horas. | /anomalias |
/objetivos |
Tus objetivos de servicio y cuánto margen les queda. | /objetivos |
/infra |
Servidores, los que tienen problemas primero. Acepta un ambiente. | /infra o /infra prod |
/kubernetes |
Clústeres y, en los que andan mal, los pods que fallan. | /kubernetes |
/red |
Equipos de red caídos o con alertas. | /red |
/usuarios |
La experiencia real de tus usuarios: errores y lentitud. | /usuarios |
/plan |
Cuánto usás de tu plan contra cada límite, y el uso por ambiente. | /plan |
/ayuda |
La lista de comandos que vos podés usar. | /ayuda |
/silenciar <rato> |
Pausa los avisos a ese chat. | /silenciar 2h |
/organizacion |
Cambia de organización, si tenés más de una. | /organizacion |
/desconectar |
Corta la conexión. | /desconectar |
Comandos por ambiente#
/estado, /incidentes, /servicios e /infra aceptan el ambiente como una palabra al final:
| Escribís | Qué muestra |
|---|---|
/incidentes qa |
Los incidentes abiertos que afectan algo de QA. |
/servicios prod |
Los servicios de Prod. |
/infra desarrollo |
Los servidores de Desarrollo. |
/estado qa |
El resumen del estado, solo de QA. |
Los tres ambientes se escriben prod, qa y desarrollo. También se entienden produccion y dev. Con un ambiente, el título lo dice ("... en QA") y lo que no tiene ambiente no aparece. Sin la palabra, el bot muestra todo y cada incidente, servicio o servidor dice el suyo ("Ambiente: QA", "pagos (QA)"). Si escribís algo que no es un ambiente, el bot contesta "No conozco ese ambiente. Escribí prod, qa o desarrollo. Por ejemplo: /incidentes qa." y no consulta nada.
/plan agrega "Uso por ambiente" con lo que usa cada ambiente y recuerda que todos suman al mismo plan y que el límite es uno solo. /ayuda explica la palabra de ambiente en una línea.
El id de un incidente (I- y unos números) lo ves en /incidentes y en el portal. Al escribirlo podés poner I-1731500000, i-1731500000 o solo los números. El nombre de un servicio es el que ves en /servicios.
Si escribís algo que no es un comando, el bot te recuerda que por ahora entiende comandos y te manda a /ayuda.
Qué ve el bot#
- Lo mismo que vos ves en el portal, nunca más. Cada comando pide el mismo permiso que la pantalla del portal donde verías ese dato. Si tus roles no te dejan ver Kubernetes,
/kuberneteste contesta "No tenés permiso para ver eso en" el nombre de tu organización. /ayudalista solo lo que podés usar. Los comandos cuyo permiso no tenés no aparecen.- Solo lee. El bot no puede cerrar un incidente, cambiar una regla, crear una ventana de mantenimiento ni tocar ninguna configuración.
- Los cambios de permisos valen en el momento. Cada vez que escribís, Lymen vuelve a mirar que sigas activo y con el permiso Asistentes de IA › Ver. Si ya no, el bot te dice "Tu acceso a esta organización ya no está activo." y borra la conexión.
- Lo que sale de tu organización son tus datos tal como son: los nombres de tus servicios y servidores aparecen como los ves en el portal.
Quedan siempre afuera el Llavero y sus credenciales, Usuarios y roles y la configuración de tu organización, igual que con los asistentes de IA.
Pausar los avisos#
/silenciar pausa los avisos solo a ese chat de Telegram:
| Escribís | Qué pasa |
|---|---|
/silenciar 30m |
Pausa 30 minutos. |
/silenciar 2h |
Pausa 2 horas. |
/silenciar 1d |
Pausa 1 día. |
/silenciar no |
Reanuda los avisos. |
El máximo es 7 días. La tarjeta Telegram del portal muestra hasta cuándo están pausados.
Pausar no cambia nada más: el email y los demás canales siguen avisando como siempre, y los perfiles de alerta quedan igual. Un aviso que cae durante la pausa no se manda después a Telegram, así que el incidente puede estar abierto sin que Telegram te haya avisado: seguí mirando el email o el portal. Los comandos de consulta siguen andando.
Varias organizaciones#
Si perteneces a más de una organización de Lymen, podés conectar el mismo chat a todas (hasta 10): repetí los pasos de conexión desde el portal de cada una. El bot responde de a una por vez, la actual.
/organizacionmuestra la lista y, con un botón por cada una, elegís cuál pasa a ser la actual. Con una sola, te lo dice.- Los comandos que escribas van siempre a la organización actual, y te saludan con su nombre al conectar.
- Los avisos de cada organización llegan por ese chat sin importar cuál sea la actual.
Desconectar#
Hay dos caminos, los dos cortan en el momento:
- Desde el portal: en Configuración › Integraciones › Telegram, en la opción Bot de Lymen, tocá Desconectar y confirmá.
- Desde Telegram: escribí
/desconectar. Si tenés varias organizaciones, desconecta la actual.
Al desconectar se borra el vínculo y el contacto deja de estar enlazado: no te llegan más avisos por el bot de Lymen. Para volver a conectar, generá un enlace nuevo. Si desactivan o eliminan a la persona en Usuarios, el bot deja de contestarle.
Seguridad y privacidad#
- Los mensajes pasan por Telegram. Telegram es un servicio de un tercero: lo que el bot te escribe y lo que vos le escribís viaja por sus servidores y vale su política de privacidad, no la de Lymen. Antes de usarlo, revisá las políticas de datos de tu organización, sobre todo si en tus logs o eventos puede haber datos de pacientes o de otras personas. Las reglas de Privacidad ayudan: lo que se enmascara o se borra antes de guardarse tampoco llega al chat.
- Lymen no guarda el contenido de los mensajes en su servicio central: no queda registro de los avisos que pasan ni de lo que escribís ni de lo que el bot responde. Solo se recuerda a qué organizaciones está conectado cada chat. La consulta se resuelve en tu organización.
- Si preferís no usar Telegram así, podés no conectar nada y recibir avisos por email.
- Solo vos usás tu conexión. El enlace es personal, de un solo uso y vence a los 10 minutos. Además, nadie queda conectado sin que vos lo confirmes en el portal viendo qué cuenta de Telegram es: quien quede conectado recibe tus avisos y consulta con tus permisos, por eso confirmá solo si es tu cuenta. El bot solo atiende en chats privados.
- Los datos no pueden dar órdenes al bot. El bot manda texto simple, sin formato ni enlaces armados con datos, y lo que escribís no se ejecuta: se usa solo como el nombre de un servicio o el id de un incidente. Es de solo lectura.
- Queda registro. Conectar y desconectar Telegram queda en la Auditoría.
- Hay un límite de uso. Si escribís demasiados mensajes por minuto, el bot ignora los que pasan del límite.
Límites#
- Solo lectura. No hay acciones: no se reconocen ni se cierran incidentes desde el chat.
- Solo comandos. Por ahora el bot no responde preguntas escritas con tus palabras, solo los comandos de la tabla.
- Sin grupos. El bot no atiende en grupos de Telegram. Para avisar a un grupo o a un canal de equipo, usá Slack, Microsoft Teams o un webhook (ver Integraciones).
- Un chat por persona y por organización.
- Las respuestas son cortas: se muestran los primeros resultados y el bot indica cuántos quedan para mirar en el portal.
Problemas comunes#
- "Falta confirmar la conexión en el portal." Abriste el enlace y tocaste Iniciar, pero la conexión todavía no está hecha. Volvé a Configuración › Integraciones › Telegram, revisá que la cuenta de Telegram que aparece sea la tuya y tocá Sí, conectar. Mientras no confirmes, el bot no responde comandos ni te manda avisos. Si ya pasaron más de 10 minutos, generá un enlace nuevo.
- "Este chat ya está conectado a otra cuenta de esta organización." Ese chat de Telegram ya lo usa otra persona de tu organización. Esa persona tiene que escribirle
/desconectaral bot (o tocar Desconectar en su portal); después generá un enlace nuevo y conectá. Si el chat es tuyo y usás otro usuario de Lymen, conectá con ese usuario. - En el portal aparece una cuenta de Telegram que no es la mía. Tocá No soy yo: no se conecta nada. Alguien abrió tu enlace, así que no lo compartas más y, si querés conectar, generá uno nuevo.
- "Ese enlace ya no sirve. Generá uno nuevo desde el portal." El enlace venció (10 minutos), ya se usó o no es de tu organización. Volvé a Configuración › Integraciones › Telegram, tocá Conectar Telegram y abrí el enlace nuevo.
- No veo la opción Bot de Lymen en Integraciones › Telegram. El bot de Lymen no está disponible en tu instalación, o tus roles no incluyen Asistentes de IA › Ver. Pedilo a un administrador o por soporte.
- Conecté el bot pero no me llegan avisos. Revisá en este orden: que exista un contacto con tu mismo email y que esté activo; que ese contacto esté elegido con Telegram en un perfil de alerta; que no tengas los avisos pausados con
/silenciar(la tarjeta lo muestra); y que el incidente cumpla el filtro y el horario del perfil (mirá Avisos enviados en el incidente). Para confirmar que el canal anda, usá Mandar mensaje de prueba. - "No tenés permiso para ver eso en…". Tus roles no incluyen el permiso del área de ese comando. El bot ve lo mismo que vos en el portal. Pedíselo a un administrador (ver Usuarios y roles).
- "Tu acceso a esta organización ya no está activo." Te desactivaron o tus roles ya no incluyen Asistentes de IA › Ver. El bot borró la conexión. Si corresponde, pedí que te la devuelvan y conectá de nuevo.
- Bloqueé el bot (o borré el chat) y ya no me llega nada. Telegram avisa a Lymen y la conexión se borra. Desbloqueá al bot en Telegram y volvé a conectar desde el portal.
- No me contesta nada. Probá
/ayuda. Si el bot te explica cómo conectarte, conectá de nuevo desde el portal. Si dice "No pude consultar tu organización. Probá de nuevo en un rato.", esperá un momento y repetí. - Escribí en un grupo y solo dice "Escribime por privado". El bot atiende únicamente en chats privados. Abrí un chat directo con el bot.
/serviciodice que no encuentra el servicio. Escribí el nombre tal como figura en/servicios. El bot te sugiere los parecidos.- Cambié de celular. Abrí Telegram en el celular nuevo con tu misma cuenta y seguí usando el mismo chat. Si usás otra cuenta de Telegram, conectá de nuevo y confirmá en el portal: el chat nuevo reemplaza al anterior.
- Estoy en varias organizaciones y el bot me responde de la que no quiero. Escribí
/organizaciony elegí la correcta.