Telegram Threads
Enrutamiento persistente y aislado entre temas de Telegram y sesiones, con deduplicación y reconexión.
- Actualizado:
- Palabras:
- 476
- Descargas semanales:
- 0
- Descargas totales:
- 1
Enlaces relacionados
Telegram Threads
Relaciona de forma persistente cada tema de Telegram con su sesión de runtime. El título, el directorio de trabajo y la última conversación utilizada no identifican el destino.
Registro e identidad
Guarda bot, chat, message_thread_id, host del runtime y session_id. Los nombres
visibles son editables; los identificadores de tema solo tienen sentido dentro
de su chat.
Valida from.id, chat.id y tipo de chat según el modelo de acceso. En grupos,
aplica una política explícita de miembros y roles. Autorizar una persona no concede
acceso a todos los chats donde participa.
Crea o vincula temas mediante una acción autorizada. Persiste la asociación tras la respuesta de Telegram y deduplica registros. Si falla la escritura local después de crear el tema remoto, reconcilia el tema huérfano antes de repetir la creación.
Comprueba el soporte y la configuración de temas privados en la API vigente. Si el tema no está disponible, informa del fallo y conserva el destino original. Un tema desconocido requiere rechazo o registro explícito.
Entrega y aislamiento
- Deduplica entradas por bot y
update_id. Conserva ID estable, origen, destino, contenido, estado e intentos en una cola con tamaño y pendientes acotados. Usa SQL parametrizado. - Confirma la entrega cuando el runtime acepte la operación. Reintenta los fallos transitorios y rechaza de forma definitiva las peticiones inválidas.
- Registra una salida como enviada tras confirmar el envío. Su clave incluye runtime/host, sesión e ítem para evitar colisiones de IDs locales.
- Un corte entre aceptación remota y escritura local permite duplicados. Usa claves de idempotencia cuando estén disponibles; en otro caso, documenta entrega al menos una vez y reconcilia IDs antes de repetir acciones con efectos.
- Aplica reintentos y espera progresiva por sesión, manteniendo su orden. Un fallo o conflicto de escritor debe quedar aislado de las demás conversaciones.
Respuestas, aprobaciones, adjuntos e interrupciones conservan el mismo ámbito. Rechaza aprobaciones de otra sesión, aunque procedan del mismo usuario, y mantén los archivos asociados a su conversación.
Reconexión
Distingue tema registrado, runtime conectado, sesión suscrita y turno activo. Reanuda la sesión existente tras reiniciar el daemon; un conflicto de escritor requiere resolver el control de esa sesión sin cambiar su modelo o permisos.
Recupera ítems completos pendientes, con paginación cuando corresponda. Publica respuestas finales, excluyendo razonamiento interno, salidas de herramientas e historial ya entregado. Persiste el estado atómicamente con permisos privados.
Comprobación
Prueba dos temas y dos hosts con IDs locales repetidos, temas desconocidos, reinicio entre envío y confirmación, registros duplicados, aprobaciones cruzadas y una sesión ocupada mientras otra funciona. Usa datos de prueba y conserva las conversaciones existentes.
Referencia: https://core.telegram.org/bots/api#createforumtopic
Versiones (1)
| Versión | Descargas (semana) | Descargas (total) | Publicación |
|---|---|---|---|
0.1.0latest Primera versión publicada. | 0 | 1 | 14 de octubre de 2026 |