AUTOMATIZACIóN

Claude en Telegram: Construye un agente IA que conoce tu negocio por dentro

junio 17, 2026 7 min de lectura

Bot de Telegram Claude IA para gestión de proyectos y automatización

Hay muchas formas de trabajar con IA. Puedes abrir un navegador, entrar a la interfaz, escribir un prompt, esperar la respuesta. Funciona. Pero hay otra manera de pensar en la automatización con IA en los negocios — una que se siente más como enviar un mensaje a una persona de confianza que conoce tu negocio por dentro, y menos como hablar con un buscador avanzado.

En este artículo quiero mostrarte cómo construir un bot de Telegram conectado a Claude — no un Claude genérico, sino Claude orientado a tu proyecto específico, con todo el contexto, archivos y configuraciones que preparaste de antemano.

Espera — ¿Qué es exactamente un ‘agente’?

La palabra «agente» suena técnica e intimidante. Pero la idea en sí es muy simple.

Un agente es simplemente un proyecto con una carpeta dedicada en tu computadora, y dentro de esa carpeta hay un archivo markdown — CLAUDE.md — que le explica a Claude qué es este proyecto, cuáles son las reglas de trabajo y cómo actuar.

Un ejemplo concreto: si tu CLAUDE.md le explica a Claude cómo crear y publicar posts en tu Instagram — incluyendo la estética, el tono, qué cuenta usar y a qué hora — entonces ese es tu agente de Instagram. No hay magia ahí. Hay una carpeta, hay un archivo de configuración, y hay Claude que sabe leerlo.

Quienes trabajan con arquitectura de Second Brain pueden ir un paso más allá: crear un agente separado para cada proyecto activo, más un agente principal conectado a la carpeta madre. Cada uno conoce solo su propio mundo, sin confusión. Esta es la automatización con IA que se adapta a cómo realmente trabajas.

¿Por qué necesitas un bot de Telegram?

Es cierto que puedes hablar con Claude directamente a través de su aplicación. ¿Entonces qué tiene de especial esto?

La diferencia es una sola: tus archivos.

El Claude regular no sabe nada sobre tus proyectos, tus clientes, las decisiones que tomaste. Para hacerle una pregunta basada en la realidad real de tu negocio — necesitas sentarte frente a la computadora, abrir las herramientas, proporcionar los archivos manualmente.

El bot resuelve esto. Está instalado en tu computadora y conectado directamente a los archivos del proyecto. Estás en la playa, en una reunión, en camino — envías un mensaje — y el bot trae una respuesta basada en tu información real.

Tú (Telegram) → Bot Python → Claude CLI → Archivos del proyecto

¿Por qué Telegram y no WhatsApp?

1. API abierta y gratuita — sin costo, sin aprobaciones. WhatsApp tiene una API empresarial que requiere aprobación de Meta.

2. Configuración en minutos — el bot está listo en 5 minutos desde que abriste @BotFather.

3. Mensajes de voz — hablas → Claude escucha. Whisper transcribe automáticamente. Muy útil cuando tienes las manos ocupadas.

¿Por qué un bot para todos los proyectos no es suficiente?

Con varios proyectos activos, Claude necesita entender en cada pregunta «¿de cuál proyecto se trata?» Esto crea ambigüedad y respuestas menos precisas. La solución: un bot dedicado para cada proyecto.

• Tienes un negocio — «¿Cuál es el estado de David?» ← el bot abre el archivo y trae la respuesta
• Canal de contenido — «¿Qué planifiqué para este mes y qué aún no hice?» ← el bot revisa la lista
• Pequeño negocio — «¿Qué pidió el cliente en la última reunión?» ← el bot extrae las notas

Las ventajas

Acceso desde cualquier lugar — el teléfono siempre en el bolsillo. Una idea en la playa — enviada en un segundo.

Entrada de voz — Whisper transcribe automáticamente. Hablas — Claude responde.

Contexto preciso — el bot sabe, no adivina. Abre el archivo y trae la información.

Memoria de conversación — los últimos 20 mensajes se guardan durante la ejecución.

Escritura directa al vault — «guarda esto», «agrégalo a las tareas» — Claude edita los archivos realmente. Esta es la diferencia entre una IA que ayuda por un momento y la automatización con IA que mejora los procesos a largo plazo.

Las desventajas — siendo directos

No es tiempo real — 10–30 segundos para una respuesta. Una herramienta de trabajo, no una conversación de chat.

La memoria no es permanente — pero hay una solución — ¿Detuviste el bot? La memoria de conversación se borra. Pero el bot puede escribir a los archivos para siempre. «Guarda esto» — escrito en tus archivos. La memoria permanente son los archivos.

La computadora necesita estar encendida — para disponibilidad 24/7 necesitas un servidor (VPS, Mac mini, etc.).

Cómo construirlo — paso a paso

Lo que necesitas antes de comenzar: Python 3 · Claude Code CLI · Cuenta de Telegram

Paso 1 — Crear el bot de Telegram

Abre @BotFather en Telegram y crea un nuevo bot:

/newbot
→ Nombre del bot: My Project Bot
→ Username: myproject_bot
→ Recibe el token: 1234567890:ABCdef...

Paso 2 — Instalar las herramientas

Python 3 — el lenguaje de programación en el que está escrito el bot. En Mac — generalmente ya está instalado. Comprueba: python3 --version

Claude Code CLI — la versión Terminal de Claude que puede leer y escribir archivos.

brew install python3
npm install -g @anthropic-ai/claude-code
pip3 install python-telegram-bot openai-whisper
brew install ffmpeg

Paso 3 — El código

💡 No necesitas copiar y pegar código manualmente. Simplemente explícale a Claude lo que necesitas — él escribirá el código. Solo dos líneas necesitan cambio: el token y la ruta del proyecto.

import asyncio, subprocess, tempfile
from collections import defaultdict
from telegram import Update
from telegram.ext import Application, MessageHandler, filters, ContextTypes
import whisper

TOKEN      = "YOUR-TOKEN-HERE"        # <- change this
VAULT_PATH = "/your/project/folder"   # <- and this

conversation_history = defaultdict(list)
whisper_model = whisper.load_model("small")

async def get_claude_response(user_id, message):
    history = conversation_history[user_id]
    history_text = ""
    if history:
        history_text = "Conversation history:\n"
        for msg in history:
            role = "User" if msg["role"] == "user" else "Claude"
            history_text += f"{role}: {msg['content']}\n"
        history_text += "\n---\n"
    full_prompt = f"{history_text}User: {message}"
    loop = asyncio.get_event_loop()
    result = await loop.run_in_executor(None, lambda: subprocess.run(
        ["/opt/homebrew/bin/claude", "-p", full_prompt,
         "--dangerously-skip-permissions",
         "--allowedTools", "Read,Write,Edit,Glob,Grep,Bash(*)"],
        capture_output=True, text=True, cwd=VAULT_PATH, timeout=120
    ))
    reply = result.stdout.strip() or "Could not get a response."
    conversation_history[user_id].append({"role": "user", "content": message})
    conversation_history[user_id].append({"role": "assistant", "content": reply})
    if len(conversation_history[user_id]) > 20:
        conversation_history[user_id] = conversation_history[user_id][-20:]
    return reply

async def handle_text(update, context):
    await update.message.reply_text("Thinking...")
    response = await get_claude_response(update.effective_user.id, update.message.text)
    await update.message.reply_text(response)

async def handle_voice(update, context):
    await update.message.reply_text("Transcribing...")
    voice_file = await update.message.voice.get_file()
    with tempfile.TemporaryDirectory() as tmp:
        ogg, wav = f"{tmp}/voice.ogg", f"{tmp}/voice.wav"
        await voice_file.download_to_drive(ogg)
        subprocess.run(["ffmpeg", "-i", ogg, wav, "-y"], capture_output=True)
        text = whisper_model.transcribe(wav)["text"].strip()
    if not text:
        await update.message.reply_text("Could not transcribe.")
        return
    response = await get_claude_response(update.effective_user.id, text)
    await update.message.reply_text(response)

def main():
    app = Application.builder().token(TOKEN).build()
    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_text))
    app.add_handler(MessageHandler(filters.VOICE, handle_voice))
    app.run_polling(drop_pending_updates=True)

if __name__ == "__main__":
    main()

Paso 4 — Ejecución

python3 bot.py

El bot está activo. Abre Telegram, encuentra el bot que creaste y envía el primer mensaje.

Paso 5 — ¿Proyecto adicional? Bot adicional

Para cada proyecto adicional — crea un nuevo bot en @BotFather, guarda un nuevo archivo y cambia solo dos líneas:

TOKEN      = "nuevo-token"
VAULT_PATH = "ruta-al-otro-proyecto"

Ejecuta cada bot en una ventana de Terminal separada. Ambos bots corren simultáneamente, cada uno conectado a su propio mundo.

Preguntas frecuentes

¿Cuesta dinero un bot de Telegram?

Por ahora — completamente gratis. La API de Telegram es abierta sin costo. Dada la creciente popularidad, podría haber cambios en el futuro, pero por ahora — no hay razón para no intentarlo.

¿Es complicado construirlo?

Para nada. Si puedes ejecutar un comando en Terminal y cambiar dos líneas en un archivo de texto — puedes construir este bot. Una hora como máximo la primera vez, y menos de 10 minutos para cada bot adicional.

¿Necesitas saber programar?

No. Aunque el código anterior te parezca extraño — simplemente explícale a Claude lo que necesitas y él lo escribirá por ti. El código es lo suficientemente simple como para que Claude lo prepare sin esfuerzo.

¿Puede el bot ayudar con la creación de contenido, no solo con la gestión de información?

Por supuesto. Si tu CLAUDE.md define el estilo, la audiencia y las plataformas — el bot puede escribir posts, editar textos y preparar borradores directamente en tus archivos. Casi todo lo que Claude sabe hacer en la interfaz regular — puede hacerlo también a través del bot, con el contexto real de tu proyecto.

Resumen

Lo que construimos: una arquitectura simple que conecta tu teléfono con Claude, quien conoce tus proyectos en profundidad.

No necesitas estar frente a una computadora para trabajar con tu información. Cada idea se guarda. Cada pregunta recibe una respuesta basada en tu contexto real. Cada proyecto obtiene el bot que lo entiende.

Esto no es solo otro chatbot — es el asistente que conoce tu negocio.

Síguenos en TikTok para más contenido sobre automatización e inteligencia artificial.