Bot de Telegram
Makion incluye un bot de Telegram integrado: una interfaz móvil para tu propio servidor Makion. Desde el bot puedes elegir un proyecto, escoger un rol, enviar una tarea con texto o adjuntos, ver cómo se transmite la respuesta en directo, recibir los archivos que produce el agente, aprobar y aplicar elementos de la cola de envío autónoma y gestionar solicitudes de Support / Consult — casi todo lo que hace la app de escritorio en el trabajo diario.
El bot se ejecuta en el mismo servidor que el backend de escritorio y asocia tu cuenta de Telegram a la misma identidad de desarrollador de Makion que se usa para iniciar sesión. No hay cuentas separadas: tus proyectos, roles, historial de chat y permisos son exactamente los mismos en ambos.
El bot no puede abrir la conexión SAP por sí mismo. El túnel del connector de SAP se adjunta desde la app de escritorio; desde el teléfono puedes ver su estado y dirigir las ejecuciones, pero establecer el túnel es una acción de escritorio. Consulta Sistemas.
Iniciar y vincular el bot#
El bot es el mismo que se usa para iniciar sesión con QR de Telegram. Para usarlo:
- Abre el bot de Makion de tu organización en Telegram y envía
/start(o/menu). Tu administrador puede indicarte el bot correcto. - El bot asocia tu cuenta de Telegram a un desarrollador de Makion. Si aún no tienes ningún rol, te lo indica — pide a tu administrador que te conceda un rol y acceso al proyecto, exactamente igual que en el escritorio. Consulta Usuarios y acceso.
- Una vez que tengas acceso, aparece el menú principal con un teclado de botones siempre visible sobre el campo de entrada.
Iniciar sesión en el escritorio desde el bot#
El bot también puede completar un inicio de sesión de escritorio sin escanear un código QR. En la pantalla de inicio de sesión del escritorio se muestra un código QR; en lugar de escanearlo, toca 🔑 Log in on the computer en el bot (o envía /login). El bot confirma el inicio de sesión pendiente del escritorio y la app inicia sesión en su siguiente sondeo.
Quién puede usarlo#
La identidad y los permisos coinciden exactamente con el modelo de escritorio:
- La primera persona que abre el bot se convierte en superadmin.
- Todos los demás empiezan sin acceso hasta que un superadmin les concede un rol. Hasta entonces, el bot lo indica de forma cortés.
- Solo ves los proyectos a los que perteneces; un superadmin ve todos los proyectos.
Comandos#
Todos los comandos también aparecen en el propio menú / de Telegram junto al campo de entrada, así que nunca tienes que memorizarlos.
| Command | What it does |
|---|---|
/start, /menu |
Abre el menú principal y el teclado de botones. |
/login |
Confirma un inicio de sesión de escritorio pendiente (la alternativa al QR). |
/projects |
Elige un proyecto. |
/mode |
Elige un rol para el agente. |
/chats |
Lista y reanuda los chats recientes del proyecto. |
/clear |
Borra el historial y el contexto del chat actual. |
/cancel |
Detiene la tarea que se está ejecutando. |
/requests |
Abre el menú de solicitudes de Support / Consult. |
/shipqueue |
Abre la revisión de la cola de envío autónoma. |
/support |
Envía un informe de un solo mensaje al soporte de Makion. |
/help |
Muestra una tarjeta de ayuda breve. |
/admin |
Abre el menú de admin (solo superadmin; los administradores del proyecto solo ven el conmutador de motor por proyecto). |
Botones del menú#
El menú principal muestra un teclado de botones persistente para que las acciones comunes estén a un toque de distancia. Al tocar un botón se ejecuta su acción en lugar de enviar la etiqueta como una tarea.
| Button | What it does |
|---|---|
| 📁 Projects | Elige un proyecto. Tras elegirlo, la lista de roles se abre automáticamente. |
| 🎭 Mode | Elige un rol (consulta Roles en el selector). |
| 🕘 Chats | Lista los chats recientes del proyecto; toca uno para reanudarlo, o inicia un chat nuevo. |
| 🗑 Clear chat | Borra el historial y el contexto del chat actual. |
| 🔑 Log in on the computer | Confirma un inicio de sesión de escritorio pendiente. |
| 🔌 SAP | Muestra si hay un connector de SAP adjunto para este proyecto. |
| ❓ Help | Muestra la tarjeta de ayuda. |
| 🚀 Ship-queue | Revisa, aprueba y aplica las propuestas del agente autónomo (consulta La cola de envío en tu teléfono). |
| 📋 Requests | Crea y gestiona solicitudes de Support / Consult (consulta Solicitudes de Support y Consult). |
| 🆘 Support | Describe un problema en un solo mensaje; se envía al soporte de Makion. |
| ⚙️ Admin | Abre el menú de admin. Se muestra solo a un superadmin. |
Enviar una tarea#
Simplemente envía un mensaje de texto — se trata como una tarea para el agente, ejecutada sobre el proyecto seleccionado con el rol seleccionado. Puedes adjuntar contexto primero:
- Adjunta un documento o una foto y luego envía el texto de la tarea. El archivo pasa al espacio de trabajo de la tarea como un adjunto (hasta unos 20 MB por archivo).
- Los archivos producidos que el agente crea durante la ejecución vuelven al chat como documentos.
La respuesta se transmite dentro de un único mensaje, actualizándose en directo a medida que el agente trabaja, con un pie de página de "trabajando" en marcha para que un paso largo nunca parezca atascado. Las respuestas largas se dividen en varios mensajes. Si una ejecución se queda completamente en silencio durante varios minutos — casi siempre una llamada atascada al modelo de IA — el bot la detiene por su cuenta y te indica que lo intentes de nuevo. Envía /cancel para detener tú mismo una ejecución.
El historial de conversación, la sesión del motor reanudada y el último rol usado son los mismos registros que usa el escritorio (limitados a tu identidad de desarrollador × proyecto), así que puedes iniciar una tarea en tu teléfono y continuarla en el escritorio, y viceversa.
Roles en el selector#
El selector 🎭 Mode agrupa los roles del mismo modo que el escritorio, bajo 🛠 Development, 💼 Consulting y 🆘 Support. Un candado 🔒 marca un rol que puede cambiar SAP (un rol con escritura); un rol sin candado es de solo lectura. Esto refleja cómo funcionan los roles: a los roles de solo lectura se les entregan físicamente solo herramientas de lectura, así que no pueden cambiar SAP independientemente de cómo esté redactada tu tarea.
Si tienes permiso para crear proyectos, aparece ➕ New project en la lista de proyectos y te pide un nombre.
La cola de envío en tu teléfono#
El menú 🚀 Ship-queue es la puerta de revisión humana para el modo autónomo, en tu teléfono. Lista las propuestas del agente autónomo e impulsa exactamente el mismo flujo de aprobar y aplicar que el escritorio — nada de la cola ha tocado SAP hasta que un humano lo aplica.
| Action | What it does |
|---|---|
| Toca una propuesta | Ábrela para ver su requisito, su justificación y su carga útil. |
| ✅ Approve | Registra la aprobación de una propuesta pendiente. No escribe en SAP. |
| ❌ Reject | Registra el rechazo. No escribe en SAP. |
| 🗑 Delete | Elimina una propuesta de la cola. |
| 🚀 Apply | Escribe una propuesta aprobada en SAP a través del connector adjunto. |
| 🚀 Apply all | Escribe y activa todas las propuestas aprobadas, en el proceso de dos fases, tras una confirmación. |
| 🧹 Clear rejected | Elimina todas las propuestas rechazadas. |
| 🧹 Clear not-applied | Elimina todas las propuestas que no se han aplicado. |
| 🕘 Runs | Lista las ejecuciones autónomas recientes y abre una para ver sus pasos y su resumen. |
| 🔄 Refresh | Recarga la cola. |
Una aplicación transmite su progreso en un mensaje en directo e informa de un resumen final honesto (escrito, omitido, o fallido con la propia razón de SAP). Aplicar es la única acción que escribe en SAP, y requiere un connector adjunto — consulta el Modelo de seguridad.
Solicitudes de Support y Consult#
El menú 📋 Requests gestiona el ciclo de vida de las solicitudes de Support / Consult desde el teléfono, usando las mismas reglas que la cola de Requests del escritorio.
| Action | What it does |
|---|---|
| ➕ New request | Crea una solicitud: elige 🆘 Support o 💼 Consult, define el impacto y la urgencia, y luego envía un título (con detalles opcionales). |
| Toca una solicitud | Ábrela para ver su estado, su cuerpo, sus hallazgos y sus notas. |
| 🔬 Investigate (read-only) | Inicia una investigación de solo lectura de la solicitud; reábrela más tarde para leer los hallazgos. |
| 📝 Note | Añade una nota a la solicitud. |
| 📋 To triage / ⏸ Put on hold | Mueve la solicitud a través de su ciclo de vida (una pausa pide un motivo). |
| ✅ Approve / ❌ Reject / ⏸ Park | Registra una decisión. Aprobar y rechazar piden un código de cierre y notas. Solo administradores del proyecto. |
El menú de admin#
⚙️ Admin expone las acciones de configuración que de otro modo son inaccesibles desde el teléfono. Un superadmin las ve todas; un administrador del proyecto solo ve el conmutador Engine por proyecto. Cada acción pasa por las mismas puertas de permisos que el escritorio.
| Action | What it does |
|---|---|
| 🧠 Engine | Cambia el motor de IA del proyecto actual. |
| 🤖 Model | Cambia el modelo global (superadmin). |
| ⬆️ Server update | Comprueba y activa una autoactualización del servidor, tras una confirmación (superadmin). |
| 🧩 Retro proposals | Revisa, aprueba o rechaza las propuestas de aprender-de-los-errores (superadmin). Consulta Retro. |
| 🛡 Security audit | Ejecuta la auditoría de seguridad de solo lectura y ve sus hallazgos (superadmin). |
Lo que el bot deliberadamente no puede hacer#
El bot cubre el trabajo diario, pero algunas cosas se quedan en el escritorio por diseño:
- Abrir la conexión SAP. El túnel del connector de SAP se adjunta desde la pestaña Sistemas del escritorio. El botón 🔌 SAP solo informa de si hay un connector adjunto; una tarea o una aplicación que escribe en SAP necesita que ese connector de escritorio esté activo.
- Gestionar miembros, roles y acceso a proyectos. Conceder roles y añadir personas a los proyectos es una acción de escritorio. Consulta Usuarios y acceso.
- Editar la metodología y el conocimiento. Las reglas base, la metodología por rol y los archivos de la base de conocimiento se editan en la pestaña Metodología del escritorio.
- Configurar las credenciales del motor. Añadir una clave de API o completar el inicio de sesión de una suscripción para un motor se hace en el escritorio.
Idioma#
La interfaz del bot es bilingüe (ucraniano / inglés) y sigue el idioma de tu Telegram, con el inglés por defecto.
Páginas relacionadas#
- Iniciar sesión y proyectos — el inicio de sesión de escritorio que el bot puede completar.
- Cómo funcionan los roles — solo lectura frente a escritura, y el candado 🔒 en el selector.
- Modo autónomo — la cola de envío que el bot te permite aprobar y aplicar.
- Requests — el ciclo de vida de Support / Consult.
- Modelo de seguridad — por qué las aplicaciones necesitan un connector, y cómo se controlan las escrituras.