Cómo conectar HappyCapy a Telegram: ejecuta un agente de IA completo en cualquier chat
Tu agente HappyCapy —con todas sus herramientas, habilidades 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 desencadena una sesión completa de Claude Code con acceso a Bash, operaciones con archivos, búsqueda web, generación de imágenes y más de 300.000 Skills. Pídele que rastree una web, que escriba un script de Python y lo ejecute, o que genere un vídeo. 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 desencadenar 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: acceso root, Python 3.11, Node.js v24, 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 vídeo 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 tiempo. El bot de Telegram de HappyCapy puede escribir código para extraer datos meteorológicos de tres APIs, compararlos, trazar un gráfico, guardarlo como PNG y enviártelo como imagen, todo en un solo mensaje, sin que salgas de Telegram.
| Función | Bot de Telegram genérico | Bot de Telegram de HappyCapy |
|---|---|---|
| Responde preguntas | Sí | Sí |
| Ejecuta comandos 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 vídeo | No | Sí |
| Rastreo web (web scraping) | No | Sí |
| Acceso a más de 300.000 Skills | No | Sí |
| Funciona 24/7 sin tu ordenador | No | Sí (Fly.io siempre activo) |
| Historial de conversación por usuario | Limitado | Completo y persistente |
Qué puedes hacer realmente
La lista de capacidades no es teórica. Esto es lo que hacen los usuarios hoy:
- Pedirle al bot que rastree una 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 las más de 300.000 Skills de HappyCapy en mitad 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 varias 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 ejecutar un script cada mañana y enviarte el resultado
- Monitorizar 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 otro modo, requerirían cambiar entre cinco herramientas distintas
Ventajas
- Siempre activo, sin necesidad de portátil. El sandbox se ejecuta en la infraestructura de Fly.io. Puedes escribirle al bot desde tu móvil a las 2 de la madrugada 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 lo activa todo.
- El contexto persiste. El historial de conversación se almacena 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 Unix. Sin las restricciones que impondría un chatbot para consumidores.
- Más de 300.000 Skills disponibles al instante. Cualquier flujo de trabajo empaquetado como Skill de HappyCapy está a una frase de distancia.
- Compartible. Da el nombre de usuario del bot a un compañero o cliente. Varios usuarios pueden interactuar simultáneamente, cada uno con su historial de conversación aislado.
- Nivel gratuito disponible. El propio puente de Telegram no añade coste adicional sobre tu plan de HappyCapy actual.
Casos de uso reales
El desarrollador autónomo que se dejó el portátil en la oficina. Has subido un commit, has detectado un fallo en los logs de despliegue y ya estás saliendo por la puerta. Desde tu móvil le escribes al bot: «Saca los últimos logs de despliegue del servidor y dime de qué se queja la línea 847». Treinta segundos después tienes la respuesta. Le respondes: «Escribe un parche y abre un PR». Hecho. Sin abrir el portátil.
El pequeño empresario que revisa métricas a diario. En lugar de entrar cada mañana en cinco paneles distintos, el bot ejecuta un resumen programado. Cada 8:00: extrae los datos de ingresos de Stripe, el número de visitantes de una API de analítica y los niveles de inventario de Shopify. Formatea el resumen y lo envía como mensaje de Telegram antes de terminar el primer café. Configurarlo llevó una sola conversación con el bot.
El investigador que necesita extraer datos rápidamente. Estás leyendo un artículo y quieres contrastar un conjunto de datos con otras tres fuentes. Cambiar al navegador, ir a cada fuente, descargar los CSV y hacer una comparación lleva 20 minutos. Escribirle al bot con las URL y una descripción de lo que necesitas lleva dos. El bot rastrea, analiza, compara y devuelve una tabla.
El padre o madre que configuró un ayudante para los deberes. Los niños ya tienen una cuenta de Telegram. Se añadió el bot de HappyCapy a un grupo familiar. Puede explicar problemas de matemáticas paso a paso, generar diagramas, escribir preguntas de práctica y corregir respuestas, sin anuncios, sin creación de cuentas y sin el bucle de distracción de un chatbot para consumidores. El padre o madre conserva el token de administrador; los niños obtienen una herramienta centrada.
Cómo configurarlo
La configuración lleva menos de cinco minutos si tienes una cuenta de HappyCapy. El proceso empieza con BotFather de Telegram: escríbele a @BotFather, ejecuta /newbot, elige un nombre y recibe un token de bot, una cadena con este aspecto: 7384920156:AAF.... Ese token es todo lo que HappyCapy necesita para saber adónde dirigir las conversaciones.
Dentro de HappyCapy, la skill de Telegram se encarga del resto. Ejecuta la skill, pega tu token de bot cuando se te pida, y el puente queda activo. La 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 almacena por ID de usuario de Telegram, de modo que cada persona que le escriba a tu bot obtiene su propia sesión persistente.
La skill completa, con scripts de configuración, documentación de variables de entorno y opciones de configuración para la limitación de tasa y las 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 la de un chatbot típico antes de empezar, AI Agent vs Chatbot trata esta distinción en detalle. Y si estás pensando en ejecutar tu propia infraestructura de IA persistente en lugar de depender de Fly.io, merece la pena leer antes el análisis Mac Mini as AI Server 2026.
Preguntas frecuentes
¿El bot funciona 24/7 o solo cuando mi ordenador está encendido? Funciona 24/7. El sandbox vive en la infraestructura de Fly.io, no en tu máquina local. Una vez que despliegas la skill de Telegram, se mantiene activa sin que tu ordenador esté encendido ni siquiera conectado a internet.
¿Puede el bot acceder a mis archivos y herramientas de HappyCapy? Sí. El bot se ejecuta 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 e integraciones que has conectado. Es tu agente, accesible a través de una interfaz distinta.
¿Es gratis usarlo? La propia skill del puente de Telegram es gratuita. Tus costes vienen determinados por tu plan de HappyCapy, que cubre el cómputo del sandbox y el uso del modelo de IA. No hay tarifas adicionales por la capa de integración con 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 estando disponible en el contexto a menos que la borres explícitamente.
¿Puedo restringir quién puede usar el bot? Sí. La skill admite una configuración de lista de permitidos (allowlist). Puedes especificar una lista de IDs o nombres de usuario de Telegram autorizados a 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, tú decides.
¿Qué ocurre si Telegram limita la tasa de mi bot? La skill gestiona la limitación de tasa con retroceso exponencial (exponential backoff). Si Telegram devuelve una respuesta 429, el puente se pausa, espera el periodo 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 una carga simultánea elevada, algo configurable en los ajustes de la skill.
¿Pueden varias personas usar el bot al mismo tiempo? Sí. El bucle de sondeo procesa los mensajes de forma asíncrona, y cada sesión de usuario es independiente. No hay ninguna cola que bloquee a un usuario mientras se atiende a otro. Bajo cargas muy altas, puedes escalar la instancia del sandbox en Fly.io para gestionar más sesiones concurrentes; la documentación de la skill cubre esta configuración.
Reflexión final
La integración con Telegram no es una función por sí misma: elimina el último punto de fricción entre tú y un agente de IA plenamente 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 útil a las 2 de la madrugada cuando estás depurando en remoto, o útil cada mañana cuando quieres un resumen estructurado antes de abrir el portátil, es el mismo agente, ahora disponible en cada bolsillo.
