Cómo conectar HappyCapy a Telegram: ejecuta un agente de IA completo en cualquier chat
Tu agente de HappyCapy —con todas sus herramientas, skills y capacidades— accesible directamente desde Telegram.
La mayoría de los bots de Telegram responden preguntas. El puente de Telegram de HappyCapy ejecuta claude --print: cada mensaje que envías activa una sesión completa de Claude Code con acceso a Bash, operaciones de archivos, búsqueda web, generación de imágenes y más de 300,000 Skills. Pídele que extraiga datos de un sitio web, que escriba un script de Python y lo ejecute, o que genere un video. Lo hará. Eso no es un chatbot. Es un agente que resulta que vive en tu chat de Telegram.
Por Qué Esto Es Diferente de un Bot de Telegram
Crear un bot de Telegram es un proyecto de fin de semana. Te registras con BotFather, obtienes un token, llamas a la API de Bots de Telegram, pasas los mensajes entrantes a una API de LLM y devuelves la respuesta. El resultado es una sofisticada máquina de autocompletado. No tiene sistema de archivos. No puede ejecutar código. No puede activar flujos de trabajo. No puede hacer nada que la API del LLM no pueda hacer en una única respuesta sin estado.
La arquitectura de HappyCapy es diferente en cada capa. HappyCapy se ejecuta como un sandbox de Linux siempre activo en Fly.io, con acceso root, Python 3.11, Node.js v24 y almacenamiento persistente de archivos. Cuando llega tu mensaje de Telegram, el puente llama a claude --print con tu mensaje como entrada. Esa invocación tiene acceso completo a herramientas: ejecución de Bash, lectura/escritura de archivos, búsqueda web, generación de imágenes, generación de video y toda la biblioteca de más de 300,000 Skills. El agente puede abrir una nueva shell, ejecutar un script, leer la salida y devolvértela, todo dentro del mismo turno de conversación.
La brecha práctica entre estos dos enfoques no es incremental. Un bot de Telegram genérico puede decirte el clima. El bot de Telegram de HappyCapy puede escribir código para extraer datos climáticos de tres APIs, compararlos, graficar un gráfico, guardarlo como PNG y enviártelo como imagen, todo en un solo mensaje, sin que tengas que salir de Telegram.
| Función | Bot de Telegram Genérico | Bot de Telegram de HappyCapy |
|---|---|---|
| Responde preguntas | Sí | Sí |
| Ejecuta comandos de Bash | No | Sí |
| Escribe y ejecuta código | No | Sí |
| Accede a archivos persistentes | No | Sí |
| Genera imágenes con IA | No (necesita integración aparte) | Sí, de forma nativa |
| Genera video | No | Sí |
| Extracción de datos web (scraping) | No | Sí |
| Acceso a más de 300,000 Skills | No | Sí |
| Funciona 24/7 sin tu computadora | No | Sí (Fly.io siempre activo) |
| Historial de conversación por usuario | Limitado | Completo y persistente |
Lo Que Realmente Puedes Hacer
La lista de capacidades no es teórica. Esto es lo que los usuarios hacen hoy:
- Pedirle al bot que extraiga datos de un sitio web y devuelva datos estructurados como tabla o JSON
- Hacer que escriba un script de Python, lo ejecute en el sandbox y devuelva el stdout, sin necesidad de un IDE
- Generar una imagen con IA a partir de un prompt y recibirla directamente en el chat de Telegram
- Activar cualquiera de los más de 300,000 Skills de HappyCapy en medio de la conversación: generación de PDF, creación de hojas de cálculo, diapositivas PPTX, síntesis de audio
- Buscar en la web, leer múltiples fuentes y devolver un resumen sintetizado con citas
- Crear y guardar archivos en almacenamiento persistente, y luego recuperarlos o actualizarlos en mensajes posteriores
- Ejecutar tareas programadas: el agente puede correr un script cada mañana y enviarte la salida por mensaje
- Monitorear una URL o un endpoint de API y avisarte cuando algo cambie
- Procesar documentos subidos: pega un enlace a un CSV y recibe el análisis
- Encadenar flujos de trabajo de varios pasos que de otra forma requerirían alternar entre cinco herramientas diferentes
Ventajas
- Siempre activo, sin necesidad de laptop. El sandbox corre en la infraestructura de Fly.io. Puedes escribirle al bot desde tu teléfono a las 2am y ejecutará código en un servidor que nunca tienes que tocar.
- Una sola interfaz para todo. En lugar de abrir Claude, luego un editor de código, luego un navegador, luego una herramienta de imágenes, un solo mensaje de Telegram activa todo eso.
- El contexto persiste. El historial de conversación se guarda por usuario. Puedes hacer referencia a algo que preguntaste hace tres días sin tener que volver a explicar el contexto.
- Acceso root completo en el sandbox. El agente puede instalar paquetes, escribir archivos y ejecutar cualquier comando de Unix. Sin las restricciones que impondría un chatbot de consumo.
- Más de 300,000 Skills disponibles al instante. Cualquier flujo de trabajo que se haya empaquetado como Skill de HappyCapy está a una frase de distancia.
- Compartible. Dale el nombre de usuario del bot a un colega o cliente. Varios usuarios pueden interactuar simultáneamente, cada uno con su historial de conversación aislado.
- Nivel gratuito disponible. El puente de Telegram en sí no añade ningún costo adicional sobre tu plan existente de HappyCapy.
Casos de Uso Reales
El desarrollador freelance que dejó su laptop en la oficina. Subiste un commit, detectaste un error en los logs de despliegue, y ya estás saliendo por la puerta. Desde tu teléfono le escribes al bot: "Trae los últimos logs de despliegue del servidor y dime de qué se está quejando la línea 847". Treinta segundos después tienes la respuesta. Le respondes: "Escribe un parche y abre un PR". Listo. Sin abrir la laptop.
El dueño de pequeño negocio que monitorea métricas a diario. En lugar de iniciar sesión en cinco tableros cada mañana, el bot ejecuta un resumen programado. Cada 8am: extrae datos de ingresos de Stripe, conteo de visitantes de una API de analítica y niveles de inventario de Shopify. Formatea el resumen y lo envía como mensaje de Telegram antes de terminar el primer café. La configuración tomó una sola conversación con el bot.
El investigador que necesita extracción rápida de datos. Estás leyendo un artículo y quieres contrastar un conjunto de datos con otras tres fuentes. Cambiar a un navegador, navegar a cada fuente, descargar CSVs y hacer una comparación toma 20 minutos. Escribirle al bot con las URLs y una descripción de lo que necesitas toma dos. El bot extrae, analiza, compara y devuelve una tabla.
El padre que configuró un ayudante de tareas escolares. Los niños ya tienen una cuenta de Telegram. El bot de HappyCapy fue agregado a un grupo familiar. Puede explicar problemas de matemáticas paso a paso, generar diagramas, escribir preguntas de práctica y revisar respuestas, sin anuncios, sin creación de cuentas y sin el ciclo de distracción de un chatbot de consumo. El padre conserva el token de administrador; los niños obtienen una herramienta enfocada.
Cómo Configurarlo
La configuración toma menos de cinco minutos si tienes una cuenta de HappyCapy. El proceso comienza con BotFather de Telegram: escríbele a @BotFather, ejecuta /newbot, elige un nombre y recibe un token de bot, una cadena que se ve como 7384920156:AAF.... Ese token es todo lo que HappyCapy necesita para saber hacia dónde dirigir las conversaciones.
Dentro de HappyCapy, el Skill de Telegram se encarga del resto. Ejecuta el Skill, pega tu token de bot cuando se te solicite, y el puente queda activo. El Skill inicia un bucle de sondeo (polling) en el sandbox que escucha los mensajes entrantes de Telegram y los dirige a través de claude --print con acceso completo a herramientas. El historial de conversación se guarda por ID de usuario de Telegram, así que cada persona que le escribe a tu bot obtiene su propia sesión persistente.
El Skill completo con scripts de configuración, documentación de variables de entorno y opciones de configuración para limitación de tasa y listas de usuarios permitidos está disponible en github.com/ndpvt-web/happycapy-telegram. Si quieres entender mejor por qué la arquitectura de agente de HappyCapy difiere de una configuración típica de chatbot antes de empezar, AI Agent vs Chatbot cubre la distinción en detalle. Y si estás pensando en administrar tu propia infraestructura de IA persistente en lugar de depender de Fly.io, vale la pena leer primero el análisis de Mac Mini as AI Server 2026.
Preguntas Frecuentes
¿El bot funciona 24/7 o solo cuando mi computadora está encendida? Funciona 24/7. El sandbox vive en la infraestructura de Fly.io, no en tu máquina local. Una vez que despliegas el Skill de Telegram, se mantiene activo sin que tu computadora esté encendida o siquiera conectada a internet.
¿Puede el bot acceder a mis archivos y herramientas de HappyCapy? Sí. El bot corre dentro de tu sandbox de HappyCapy, lo que significa que tiene acceso a todo lo que hay en ese entorno: archivos que has guardado, skills que has instalado, variables de entorno que has configurado y cualquier integración que hayas conectado. Es tu agente, accesible a través de una interfaz diferente.
¿Esto es gratis de usar? El Skill del puente de Telegram en sí es gratuito. Tus costos están determinados por tu plan de HappyCapy, el cual cubre el cómputo del sandbox y el uso del modelo de IA. No hay tarifas adicionales por la capa de integración de Telegram.
¿Cómo funciona el historial de conversación por usuario? Cada ID de usuario de Telegram obtiene su propio hilo de conversación almacenado en el sandbox. Cuando el usuario A envía un mensaje, el bot carga el historial del usuario A y añade el nuevo turno. Los mensajes del usuario B están completamente aislados. El historial es persistente entre sesiones: una conversación que tuviste hace una semana sigue siendo accesible en el contexto a menos que la borres explícitamente.
¿Puedo restringir quién puede usar el bot? Sí. El Skill admite una configuración de lista de usuarios permitidos (allowlist). Puedes especificar una lista de IDs o nombres de usuario de Telegram autorizados para interactuar con el bot. Los mensajes de usuarios que no están en la lista se ignoran silenciosamente o reciben un mensaje de rechazo personalizado, según elijas.
¿Qué pasa si Telegram limita la tasa (rate-limit) de mi bot? El Skill maneja la limitación de tasa con retroceso exponencial (exponential backoff). Si Telegram devuelve una respuesta 429, el puente se pausa, espera el período de reintento requerido y se reanuda automáticamente. No perderás mensajes. En la práctica, los límites de tasa solo se activan bajo carga simultánea intensa, lo cual es configurable en los ajustes del Skill.
¿Pueden varias personas usar el bot simultáneamente? Sí. El bucle de sondeo procesa los mensajes de forma asíncrona, y cada sesión de usuario es independiente. No hay una cola que bloquee a un usuario mientras se atiende a otro. Bajo carga muy alta, puedes escalar la instancia del sandbox en Fly.io para manejar más sesiones concurrentes; la documentación del Skill cubre esta configuración.
Reflexiones Finales
La integración con Telegram no es una función por el simple hecho de tenerla: elimina el último punto de fricción entre tú y un agente de IA totalmente capaz. Tu sandbox de HappyCapy ya ejecuta código, genera contenido multimedia y orquesta más de 300,000 Skills. El puente de Telegram significa que accedes a todo eso desde donde ya estés, sin cambio de contexto. Ya sea que eso resulte útil a las 2am cuando estás depurando remotamente o útil cada mañana cuando quieres un resumen estructurado antes de abrir tu laptop, es el mismo agente, ahora disponible en cada bolsillo.
