PuentesDevelopers
Migrar un bot de Telegram a Puentes: qué cambia y qué no
Antes del mapeo, lo primero: si tu bot anda bien en Telegram y tus usuarios están ahí, no lo migres. Telegram tiene la mejor plataforma de bots que existe y nosotros no vamos a fingir lo contrario.
Esta nota es para el caso en que querés que tu bot sea un agente de IA con memoria del grupo y herramientas, o que tus usuarios no necesiten número de teléfono ni instalar nada.
El mapeo directo
| Telegram | Puentes |
|---|---|
@BotFather |
POST /api/bots |
| Token del bot | Token pb_… |
setWebhook |
Campo webhookUrl al crear el agente |
getUpdates con long-polling |
GET /api/me/updates?after=<seq>&timeout=25 |
sendMessage |
POST /api/groups/<chatId>/messages |
chat_id |
groupId |
update_id |
seq, global y creciente |
reply_to_message_id |
replyTo |
InlineKeyboardMarkup |
Tarjeta options con layout: "buttons" |
sendPoll |
Lista de tareas, o tarjeta options con varias opciones |
sendChatAction: typing |
POST /api/groups/:id/typing |
| Mini App | No existe; en su lugar, tarjetas nativas |
El esqueleto de un bot (recibir, decidir, responder) es el mismo. Lo que cambia son los nombres y dos conceptos.
Lo que no existe en Puentes
El modo privacidad. En Telegram, un bot en un grupo por defecto sólo ve los comandos dirigidos a él y las respuestas a sus mensajes. En Puentes un agente ve los mensajes de los chats donde está, como un participante más. Si tu lógica dependía de que el bot no viera todo, revisala.
Los comandos con barra. Existen por convención, pero la forma natural acá es la mención: @TuAgente hacé esto. Si tu bot vive de /comandos, van a seguir funcionando como texto, pero la gente no los va a usar.
Las Mini Apps. No hay un contenedor de web apps. La respuesta equivalente son las tarjetas nativas: botones, listas, formularios de hasta ocho campos y catálogo con canasta. Para la mayoría de los casos de una Mini App simple, alcanzan; para una interfaz compleja, no.
Los pagos. Telegram los tiene integrados. Nosotros no.
Lo que no existe en Telegram
Herramientas por MCP. Le pasás a tu agente la URL de tu servidor MCP y usa sus herramientas adentro del chat. No hay que escribir el pegamento entre el modelo y tus funciones. Buscamos "MCP" en toda la documentación de bots de Telegram y no aparece.
Que el modelo sea parte de la plataforma. En Telegram tu bot es un programa: si querés IA, la ponés vos. Acá un agente puede ser un modelo con la memoria del chat, sin que escribas nada de eso.
Avisar sin un segundo bot. Cada llamada a tu servidor MCP trae una dirección para publicar en ese chat. La guardás y hacés un POST cuando pasa algo.
Tablas compartidas con totales calculados por la plataforma.
Usuarios sin número de teléfono ni instalación. Entran por un link con un nombre. Para la primera prueba de un producto, eso baja mucho la fricción.
Los límites, comparados
Telegram: un mensaje por segundo por chat, 20 por minuto en un grupo, 30 por segundo en difusión.
Puentes: hay límites de uso para frenar spam, y están en la documentación. Si tu bot hace responder a Claude o GPT, esa cuota la paga el dueño del agente, o se usa su propia clave de modelo.
Cómo lo haría
No muevas usuarios. Creá un agente nuevo, apuntalo al mismo backend con un adaptador que traduzca los dos formatos (son pocas líneas: los dos son HTTP y JSON), y probalo en un chat de prueba.
Ahí vas a ver rápido si lo que te falta es lo que ofrecemos, o si tu bot ya estaba bien donde estaba.
La comparación completa de plataformas está acá, lo de MCP acá, y el detalle de cada endpoint en la documentación.