max-in-tg
Puente bidireccional no oficial entre MAX Messenger y Telegram que convierte sesiones web de MAX en temas de Telegram Topics usando Puppeteer. Automatiza envío/recibido de mensajes, archivos y gestión de chats desde Telegram sin abrir la app nativa. Requiere servidor Linux con Docker y Chromium pers
Ficha actualizada 27 sept 2026, 8:03 · upstream 27 sept 2026, 7:58 · release sin release detectada
Qué es max-in-tg
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
El proyecto actúa como un puente bidireccional no oficial entre MAX Messenger y Telegram, utilizando una sesión web persistente de MAX controlada por Puppeteer en un servidor local. Cada chat de MAX se mapea a un tema (topic) dentro de una grupo privada de Telegram, permitiendo la gestión centralizada de conversaciones sin necesidad de abrir la aplicación nativa del cliente MAX.
La arquitectura se basa en Node.js 22 y Chromium para automatizar la interfaz web de MAX, evitando su detección mediante un plugin stealth. Utiliza una base de datos SQLite local para mantener el estado de entrega de mensajes y deduplicar contenido. La configuración es totalmente gestionable desde Telegram a través de comandos como /pair para vincular el bot o /merge para consolidar chats duplicados.
Es importante destacar que esta herramienta interactúa directamente con la interfaz web de MAX, no con una API pública oficial. Esto implica que cualquier cambio en el frontend de MAX puede romper la automatización. Además, el proyecto requiere un servidor Linux (preferiblemente Debian 12/13) con Docker siempre encendido, ya que depende de Chromium corriendo en segundo plano.
- Unificar múltiples chats de MAX Messenger en una sola interfaz de Telegram Topics para gestión centralizada desde un móvil o tablet.
- Automatizar la respuesta a mensajes de MAX Messenger mediante un bot de Telegram configurado por el usuario sin intervención manual.
- Enviar archivos grandes o documentos (PDF, ZIP) entre MAX y Telegram gestionando los límites de tamaño mediante notificaciones específicas.
- Gestionar sesiones web de MAX Messenger en segundo plano en un servidor VPS para acceso remoto sin instalar la app nativa.
- Crear una interfaz de chat tipo 'webhook' donde los temas de Telegram actúan como ventanas de sesión de MAX persistentes.
- Configuración completa vía comandos en Telegram (/pair, /merge) sin necesidad de acceder al servidor manualmente.
- Soporte nativo para Telegram Topics, asignando un tema por chat de MAX automáticamente.
- Base de datos SQLite local para persistencia del estado de entrega y deduplicación de mensajes.
- Plugin stealth en Puppeteer para evitar que la web de MAX detecte la automatización (Puppeteer + Stealth plugin).
- Gestión automática de sesiones: reinicia el navegador si la sesión expira o se cierra inesperadamente.
- Pipeline de medios robusto: convierte stickers animados a formato nativo de Telegram y gestiona archivos grandes con notificaciones.
- Riesgo de bloqueo del usuario en MAX Messenger por violación de ToS al automatizar la web.
- Dependencia crítica de Chromium y Node.js 22; cambios en el frontend de MAX pueden romper la automatización.
- Requiere servidor Linux con Docker siempre encendido (no funciona en dispositivos que se apagan).
- Respuestas a medios en Telegram no siempre son perfectas (mejor esfuerzo para encontrar el original).
- Archivos mayores a 50MB en MAX no se descargan en Telegram debido a límites de bots.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue recomendado en VPS Linux con Docker Compose v2. Requiere node:22-bookworm-slim. Mínimo 2GB RAM y 10GB disco. Instalar vía sh scripts/install.sh y ejecutar /pair para vincular el bot. No usar en producción sin supervisión de logs JSON.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.