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.

Listado del directorio de la terminal con carpetas separadas mautrix-whatsapp, mautrix-telegram y mautrix-discord, cada una mostrando su propio archivo de configuración y base de datos.
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.

  1. 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.
  2. 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.
  3. 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:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

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.

Editor de código que muestra el archivo Synapse homeserver.yaml con tres rutas de registro de servicios de aplicación separadas para WhatsApp, Telegram y Discord.
Synapse necesita una ruta de registro legible independiente para cada puente, seguida de un reinicio del servidor principal.
El panel de estado del contenedor muestra que Synapse y tres contenedores de puente mautrix se están ejecutando en una red Matrix compartida.
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.

Un editor de configuración de puente que muestra una dirección de servicio Synapse, una dirección de servicio mautrix-whatsapp y un nombre de base de datos de puente distinto.
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.

Utilice las instrucciones de Docker de mautrix , la guía de registro , la referencia de configuración y las páginas de autenticación de WhatsApp , Telegram y Discord para obtener comandos específicos de la versión. Revise la política de bots de Discord .

Dejar un comentario

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Diagnostique si Synapse alcanzó su límite de archivos abiertos por proceso, configure un archivo de configuración de systemd para el servicio o trabajador adecuado y verifique el límite en tiempo real.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

Averigua si el error se limita a un navegador o a un evento específico y, a continuación, utiliza la clave de recuperación de Element o un dispositivo de confianza sin poner en riesgo el historial cifrado restante.

Limpia los mensajes y archivos multimedia antiguos de Synapse sin perder datos.

Utilice las API de historial y eliminación de medios de Synapse o la configuración de retención para eliminar datos obsoletos de forma segura y, a continuación, verifique que el proceso se haya completado y que se haya recuperado el espacio en disco.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Instala la biblioteca actual, conecta una cuenta Matrix dedicada y ejecuta un pequeño bot !echo con un manejo de credenciales más seguro y una prueba clara.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Configure tres puentes mautrix con registros, inicios de sesión y pruebas independientes, y evite sorpresas con la red, la política de cuentas y la sincronización de Docker.

Recupera espacio en disco de Synapse Media sin dañar los archivos compartidos.

Descubre qué está llenando el almacenamiento de Synapse, configura la retención segura de medios y purga la caché remota sin eliminar archivos directamente del disco.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Revise la actividad del dispositivo, desactive las cuentas de Synapse inactivas confirmadas a través de la API de administración y descubra qué elimina realmente la opción de borrado.

Reduzca la presión de memoria de PostgreSQL en Matrix Synapse.

Determine si la memoria de PostgreSQL proviene del trabajo de consultas, búferes compartidos, conexiones o mantenimiento, y luego realice los cambios necesarios de forma segura para Synapse.

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

Antes de cambiar la configuración de Synapse, analice si hay problemas con las conexiones lentas de salas Matrix a un servidor remoto, el retroceso de la federación, la carga de la base de datos local o una cola de envío saliente.

Cerrar registros de Matrix o requerir tokens de invitación en Synapse

Impida la creación de cuentas abiertas en un servidor Synapse autogestionado o mantenga los registros solo por invitación con tokens de registro de uso limitado.