Inicio
» Cómo
»
Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.
Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.
Para conectar WhatsApp, Telegram y Discord, ejecute tres puentes independientes, registre cada uno como un servicio de aplicación e inicie sesión a través de su propio flujo. El éxito se logra cuando cada bot informa una sesión autenticada y los mensajes de prueba viajan en ambas direcciones a través de las salas del portal; no basta con que el bot simplemente aparezca en línea.
Esto es para el administrador de un servidor doméstico que permite servicios de aplicaciones. No se puede agregar un puente autohospedado a matrix.org a menos que sus administradores ofrezcan uno; utilice un servidor que controle o un puente alojado disponible. La documentación del proyecto se revisó el 10 de octubre de 2026.
1. Decide qué vas a conectar y prepara el servidor.
Se trata de tres servicios independientes, cada uno con su propia configuración, registro, base de datos e inicio de sesión. mautrix utiliza principalmente el método de marionetas: los mensajes viajan a través de tu cuenta remota vinculada y aparecen en Matrix como si fueran de esa cuenta. Un bot de retransmisión es diferente; elígelo solo si deseas una identidad de bot compartida en lugar de tu cuenta personal.
Necesitas un servidor principal con capacidad para servicios de aplicaciones, acceso de administrador y conectividad de red para cada puente. Docker está documentado. Asigna a cada puente su propio directorio de datos y elige una etiqueta de versión mantenida; mautrix indica que esto latestpodría rastrear la última confirmación en lugar de una versión.
Utilice una base de datos independiente para cada puente; se puede compartir un servidor PostgreSQL, pero la base de datos en sí no debe compartirse con otro puente ni con Synapse. SQLite es una opción para instancias pequeñas. Decida sobre el cifrado de extremo a extremo antes de iniciar sesión, ya que habilitarlo posteriormente para las salas de portal existentes es complicado.
Antes de iniciar los contenedores, mantenga la configuración y la base de datos de cada puente en su propio directorio de trabajo.
2. Configure y registre los tres servicios de la aplicación.
Genera la configuración inicial de cada puente. Sigue las instrucciones de la página de configuración de Docker para ese puente y ejecuta su contenedor una vez con su propio directorio de datos montado. Edita la configuración generada antes de iniciarla normalmente. Completa el dominio y la dirección del servidor principal, la dirección del puente, la URI de la base de datos y los permisos. Estos valores son específicos de tu implementación; no copies y pegues secretos de ejemplo en producción.
Utilice direcciones accesibles desde contenedores. Cuando Synapse y los puentes comparten una red Docker, la dirección del servidor principal del puente puede usar el nombre del servicio de Synapse, como http://synapse:8008. La dirección del servicio de la aplicación debe apuntar al nombre del servicio y al puerto de escucha de ese puente. localhostdentro de un contenedor de puente apunta a ese mismo contenedor, no a Synapse ni a otro puente, por lo que generalmente interrumpe la comunicación. Si el servidor principal está fuera de Docker, publique o enrute el puerto del puente requerido.
Genera e instala un archivo de registro por puente. Ejecuta el comando de configuración de cada puente para generar su archivo YAML de registro y, a continuación, coloca los tres archivos donde Synapse pueda leerlos. En homeserver.yaml, añade sus rutas en app_service_config_files, por ejemplo:
Si Synapse se ejecuta en Docker, móntelo dentro del contenedor. Reinicie Synapse después de editar la lista. Un error tipográfico en YAML, una ruta incorrecta, un montaje ilegible o una dirección de puente que no coincida pueden impedir el registro o el inicio de Synapse. Si posteriormente modifica la configuración del puente relacionada con el registro, regenere el archivo de registro correspondiente y reinicie Synapse.
Synapse necesita una ruta de registro legible independiente para cada puente, seguida de un reinicio del servidor principal.Comprueba que Synapse y los tres contenedores puente se estén ejecutando en una red donde se puedan resolver sus nombres de servicio.
3. Añada las credenciales específicas del servicio e inicie sesión.
WhatsApp
Inicia mautrix-whatsapp y abre un mensaje directo de Matrix con su bot puente, normalmente @whatsappbot:your.server. Envía login qr, luego escanea el código QR desde la pantalla Dispositivos vinculados de WhatsApp en tu teléfono. Espera a que el bot confirme la autenticación; la documentación del puente indica que las salas del portal pueden tardar aproximadamente un minuto en aparecer. WhatsApp está vinculado como un dispositivo, por lo que no se trata de una cuenta en la nube independiente. La documentación del puente indica que los dispositivos vinculados se desconectan si el teléfono permanece sin conexión durante más de dos semanas. Si no puedes mantener el teléfono activo, considera si este puente cumple con tus requisitos de confiabilidad antes de usarlo para chats importantes.
Telegram
Antes de iniciar sesión en Telegram, crea una aplicación API en my.telegram.org/apps y coloca sus api_idvalores api_hashen la configuración de mautrix-telegram. Estos valores de API permiten que el puente se conecte a la API de Telegram; no autentican una cuenta de Telegram por sí solos. Luego, envía un mensaje @telegrambot:your.servery usa login qr, escaneándolo desde la aplicación móvil de Telegram en Configuración, Dispositivos y Vincular dispositivo de escritorio. La opción de código puede entregarse a una sesión de Telegram existente en lugar de por SMS, y el puente puede solicitar tu contraseña de verificación en dos pasos. Revisa la configuración de relleno de mensajes del puente antes de iniciar sesión si es importante importar mensajes antiguos; cambiar las expectativas después de que se creen las salas del portal puede ser demasiado tarde.
Discord
Para un servidor, usa un bot de Discord dedicado, no la automatización de tu cuenta personal: Discord prohíbe los self-bots y puede cancelar cuentas. Crea una aplicación y un bot en el Portal para desarrolladores, habilita solo las intenciones privilegiadas que el puente requiere y que tu aplicación puede obtener, luego invítalo con el ámbito de bot de OAuth2 y los permisos mínimos de canal. El acceso a las intenciones está controlado por políticas; sin el contenido del mensaje o el acceso a los miembros necesarios, algunas funciones podrían no funcionar. En Matrix, envía un DM @discordbot:your.servery sigue las instrucciones de inicio de sesión del token del bot de mautrix-discord. Un bot no proporciona el mismo acceso a DM personal que un puente de cuenta de usuario.
Revise el nombre de host del servicio, el oyente del puente y los detalles únicos de la base de datos en la configuración de cada puente.
4. Prueba la entrega y luego ajusta solo lo que muestre el resultado.
Envía un mensaje directo a cada bot de puente y confirma su autenticación. En una sala de portal por servicio, envía un mensaje de prueba desde Matrix y responde desde la aplicación remota. Verifica que ambos mensajes lleguen a la sala correcta. Para grupos o canales de Discord, primero confirma que la cuenta de puente esté presente y tenga permisos de lectura y publicación. Un inicio de sesión exitoso por sí solo no garantiza la entrega.
Si un bot no responde, revisa sus registros para detectar valores faltantes, errores en la base de datos o problemas de conectividad con el servidor. Si el inicio de sesión funciona pero las salas no aparecen, verifica la configuración del portal y de la función de relleno. Si faltan mensajes en el canal de Discord, verifica la membresía del bot, los permisos y el acceso a las intenciones. Si Synapse no se inicia, verifica la indentación de YAML y que los puntos de montaje del archivo de registro sean legibles.
Las funciones compatibles varían según la versión del puente y el tipo de cuenta; las llamadas, las reacciones, los chats cifrados, los archivos multimedia y la importación del historial pueden diferir o no ser compatibles. Consulta la lista de funciones actual de cada puente antes de usarlo como único punto de acceso. Restringe el acceso a los archivos de registro y las credenciales, realiza copias de seguridad de los datos del puente de forma segura y revoca una sesión o token vinculado si se ve comprometido.