MÓDULO 4.1
Telegram como interfaz de trabajo
Ejecute un bot restringido de consulta y entienda dónde entra la IA.
Qué es
Un bot recibe mensajes a través de la API de Telegram y devuelve respuestas. La inteligencia puede provenir de reglas, de un programa o de una llamada a modelo. La aplicación en el celular no ejecuta sus tareas sola en el servidor: existe un programa intermedio con permisos definidos.
Por qué aprender
Separar interfaz y ejecución evita llamar a cualquier respuesta automática de agente inteligente. Primero construya un camino confiable para recibir y responder; luego conecte la capacidad necesaria.
Conceptos clave
Mensaje; Bot API; programa; agente; resultado.
Qué es
En Telegram, encuentre el BotFather oficial y use /newbot. Elija nombre e identificador según las instrucciones mostradas. El token generado autentica su programa ante Telegram. Guárdelo como TELEGRAM_BOT_TOKEN en un archivo privado; el kit solo tiene valores de ejemplo.
Por qué aprender
Quien controla el token puede operar el bot. Capturas de pantalla del proceso y URLs que contengan el token pueden filtrar acceso. Si hay exposición, revoque el token en BotFather antes de continuar.
Conceptos clave
BotFather; token; variable de entorno; rotación.
Qué es
El bot del kit solo acepta conversaciones privadas e IDs configurados. También solo acepta los comandos conocidos. Verificar el ID es diferente de verificar el nombre visible: los nombres pueden cambiar. Un mensaje de un desconocido no debe activar la lectura de archivos o comandos del sistema.
Por qué aprender
Un bot encontrado en internet puede recibir mensajes inesperados. La autenticación del programa con token no significa autorización de cualquier persona que le hable. Son controles distintos.
Conceptos clave
ID numérico; lista de acceso; conversación privada; comandos fijos.
Qué es
Long polling es el programa preguntar a Telegram por mensajes y esperar un poco cuando no hay novedades. Es simple para aprender y no exige abrir una puerta pública de entrada. Webhook es otra estrategia, en la que Telegram llama a una dirección HTTPS suya; no es necesaria en este laboratorio.
Por qué aprender
Elegir un único modo reduce problemas de configuración. Mantenga una única instancia buscando mensajes para un bot: procesos duplicados pueden disputar actualizaciones.
Conceptos clave
getUpdates; offset; timeout; instancia única; acceso de salida.
Qué es
El kit deliberadamente separa transporte y funciones de trabajo. Comienza determinístico: estado e informe de datos ficticios. Para acoplar IA, defina una función con entrada limitada, timeout, techo de salida y revisión. No exponga codex exec directamente a mensajes públicos ni desactive protecciones para hacerlo funcionar.
Por qué aprender
Un programa predecible permite probar la base sin gastar API. Después, evalúa si la IA mejora la interpretación, resumen o clasificación y mide el resultado con una referencia conocida.
Conceptos clave
Función de dominio; límites; timeout; revisión; datos mínimos.
Qué es
Pruebe remitente permitido, bloqueado, grupo, comando desconocido y datos ausentes. Los logs deben informar tipo de falla y hora, sin token ni mensajes privados completos. En el laboratorio, apagar el proceso debe detener las respuestas: eso prueba que el programa local está en el camino.
Por qué aprender
Una respuesta correcta no prueba que el bot esté restringido ni que recupere red. Un conjunto pequeño de escenarios demuestra las propiedades importantes antes de migrar a una VPS.
Conceptos clave
Autoprueba; falla de red; logs sin secreto; interrupción; diagnóstico.