Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Per connettere WhatsApp, Telegram e Discord, è necessario eseguire tre bridge separati, registrare ciascuno come servizio applicativo ed effettuare l'accesso tramite il relativo flusso. Il successo si verifica quando ogni bot segnala una sessione autenticata e i messaggi di prova viaggiano in entrambe le direzioni attraverso le stanze del portale; la semplice presenza di un bot online non è sufficiente.

Questo è per un amministratore di un homeserver che consente i servizi applicativi. Non è possibile aggiungere un bridge self-hosted a matrix.org a meno che i suoi amministratori non ne offrano uno; utilizzare un server sotto il proprio controllo o un bridge ospitato disponibile. La documentazione del progetto è stata verificata il 10 ottobre 2026.

1. Decidi cosa vuoi connettere e prepara il server

Si tratta di tre servizi distinti, ognuno con la propria configurazione, registrazione, database e accesso. Mautrix utilizza principalmente il sistema di marionette: i messaggi transitano attraverso il tuo account remoto collegato e appaiono in Matrix con il nome di tale account. Un relay bot funziona diversamente; sceglilo solo se desideri un'identità bot condivisa anziché il tuo account personale.

Per ogni bridge è necessario un homeserver compatibile con i servizi applicativi, i permessi di amministratore e la connettività di rete. Docker è documentato. Assegnate a ciascun bridge una propria directory dati e scegliete un tag di versione gestito; Mautrix specifica che questo latestpotrebbe tracciare l'ultimo commit anziché una release.

Utilizzare un database separato per ogni bridge; è possibile condividere un server PostgreSQL, ma il database stesso non deve essere condiviso con un altro bridge o con Synapse. SQLite è un'opzione per istanze di piccole dimensioni. Decidere di abilitare la crittografia end-to-bridge prima di effettuare l'accesso, poiché attivarla in seguito per le stanze del portale esistenti è complesso.

Elenco delle directory del terminale con cartelle separate mautrix-whatsapp, mautrix-telegram e mautrix-discord, ognuna delle quali mostra il proprio file di configurazione e di database.
Prima di avviare i container, mantieni la configurazione e il database di ciascun bridge in una directory di lavoro separata.

2. Configurare e registrare tutti e tre i servizi applicativi

  1. Genera la configurazione iniziale per ciascun bridge. Segui la pagina di configurazione Docker per quel bridge ed esegui il relativo container una volta con la sua directory dati montata. Modifica la configurazione generata prima di avviarlo normalmente. Inserisci il dominio e l'indirizzo del server principale, l'indirizzo del bridge, l'URI del database e le autorizzazioni. Questi valori sono specifici per la tua implementazione; non incollare segreti di esempio nell'ambiente di produzione.
  2. Utilizzare indirizzi raggiungibili dal container. Quando Synapse e i bridge condividono una rete Docker, l'indirizzo homeserver del bridge può utilizzare il nome del servizio di Synapse, ad esempio http://synapse:8008. L'indirizzo application-service deve puntare al nome del servizio e alla porta di ascolto di quel bridge. localhostall'interno di un container bridge punta allo stesso container, non a Synapse o a un altro bridge, quindi di solito interrompe la comunicazione. Se l'homeserver è esterno a Docker, pubblicare o instradare invece la porta bridge richiesta.
  3. Genera e installa un file di registrazione per ogni bridge. Esegui il comando di configurazione di ciascun bridge per generare il relativo file YAML di registrazione, quindi posiziona tutti e tre i file in una directory accessibile a Synapse. In homeserver.yaml, aggiungi i loro percorsi sotto app_service_config_files, ad esempio:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

Se Synapse è in esecuzione in Docker, monta i file di registrazione all'interno del container. Riavvia Synapse dopo aver modificato l'elenco. Un errore di battitura nel file YAML, un percorso errato, un mount illeggibile o un indirizzo bridge non corrispondente possono impedire la registrazione o bloccare l'avvio di Synapse. Se in seguito modifichi le impostazioni bridge relative alla registrazione, rigenera il file di registrazione pertinente e riavvia nuovamente Synapse.

Editor di codice che mostra il file homeserver.yaml di Synapse con tre percorsi di registrazione separati per i servizi applicativi di WhatsApp, Telegram e Discord.
Synapse richiede un percorso di registrazione separato e leggibile per ogni bridge, seguito dal riavvio dell'homeserver.
Il pannello di stato dei container mostra Synapse e tre container bridge Mautrix in esecuzione su una rete Matrix condivisa.
Verifica che Synapse e tutti e tre i container bridge siano in esecuzione su una rete in cui i loro nomi di servizio siano risolvibili.

3. Aggiungi le credenziali specifiche del servizio ed effettua l'accesso.

WhatsApp

Avvia mautrix-whatsapp e apri un messaggio diretto Matrix con il suo bot bridge, in genere @whatsappbot:your.server. Invia login qr, quindi scansiona il codice QR dalla schermata Dispositivi collegati di WhatsApp sul tuo telefono. Attendi che il bot confermi l'autenticazione; la documentazione del bridge afferma che potrebbero essere necessari circa 1 minuto prima che le stanze del portale vengano visualizzate. WhatsApp è collegato come un dispositivo, quindi non si tratta di un account cloud autonomo. La documentazione del bridge afferma che i dispositivi collegati si disconnettono se il telefono rimane offline per più di due settimane. Se non puoi mantenere il telefono attivo, valuta se questo bridge soddisfa le tue esigenze di affidabilità prima di farvi affidamento per chat importanti.

Telegram

Prima di accedere a Telegram, crea un'applicazione API su my.telegram.org/apps e inserisci i relativi api_idvalori api_hashnella configurazione di mautrix-telegram. Questi valori API consentono al bridge di connettersi all'API di Telegram; non autenticano un account Telegram di per sé. Quindi invia un messaggio @telegrambot:your.servere usa login qril codice, scansionandolo dall'app mobile di Telegram in Impostazioni, Dispositivi e Collega dispositivo desktop. Il codice potrebbe essere inviato a una sessione Telegram esistente anziché tramite SMS e il bridge potrebbe richiedere la password per la verifica in due passaggi. Controlla le impostazioni di backfill del bridge prima di accedere se l'importazione dei messaggi precedenti è importante; cambiare le aspettative dopo la creazione delle stanze del portale potrebbe essere troppo tardi.

Discord

Per un server, usa un bot Discord dedicato, non automatizzare il tuo account personale: Discord vieta i bot personali e potrebbe chiudere gli account. Crea un'applicazione e un bot nel Portale per sviluppatori, abilita solo gli intent privilegiati richiesti dal bridge e che la tua app può ottenere, quindi invitalo con l'ambito bot OAuth2 e le autorizzazioni minime del canale. L'accesso agli intent è controllato dalle policy; senza il contenuto dei messaggi o l'accesso ai membri necessari, alcune funzioni potrebbero non funzionare. In Matrix, invia un messaggio privato @discordbot:your.servere segui le istruzioni di accesso al token del bot di mautrix-discord. Un bot non fornisce lo stesso accesso ai messaggi privati ​​personali di un bridge per account utente.

Un editor di configurazione del bridge che mostra l'indirizzo del servizio Synapse, l'indirizzo del servizio mautrix-whatsapp e il nome di un database bridge distinto.
Esamina il nome host del servizio, il listener del bridge e i dettagli univoci del database nella configurazione di ciascun bridge.

4. Esegui una prova di consegna, quindi modifica solo ciò che emerge dal risultato.

Contatta ciascun bot del bridge tramite messaggio privato e conferma lo stato di autenticazione. In una stanza del portale per ogni servizio, invia un messaggio di prova da Matrix e rispondi dall'app remota. Verifica che entrambi i messaggi arrivino nella stanza corretta. Per i gruppi o i canali Discord, verifica prima che l'account del bridge sia presente e disponga dei permessi di lettura/pubblicazione. Un accesso riuscito da solo non è sufficiente a dimostrare la consegna.

Se un bot non risponde, controlla i suoi log per verificare la presenza di valori mancanti, errori del database o problemi di connettività con l'homeserver. Se l'accesso funziona ma le stanze non vengono visualizzate, controlla le impostazioni del portale e del backfill. Per i messaggi mancanti nei canali Discord, controlla l'appartenenza al bot, le autorizzazioni e l'accesso agli intent. Se Synapse non si avvia, verifica l'indentazione del file YAML e la leggibilità dei mount del file di registrazione.

Il supporto delle funzionalità varia a seconda della versione del bridge e del tipo di account; chiamate, reazioni, chat crittografate, contenuti multimediali e importazione della cronologia potrebbero essere diversi o non supportati. Prima di utilizzare ciascun bridge come unico punto di accesso, verifica l'elenco aggiornato delle funzionalità. Limita l'accesso ai file di registrazione e alle credenziali, esegui il backup dei dati del bridge in modo sicuro e revoca una sessione o un token collegato se esposto.

Consulta le istruzioni Docker di mautrix , la guida alla registrazione , il riferimento alla configurazione e le pagine di autenticazione di WhatsApp , Telegram e Discord per i comandi specifici della versione. Esamina le norme di Discord relative ai bot .

Lascia un commento

Elimina i vecchi messaggi e file multimediali di Synapse senza perdere dati.

Utilizza le API di Synapse per la cancellazione della cronologia e dei supporti di memorizzazione o le impostazioni di conservazione per rimuovere in modo sicuro i dati obsoleti, quindi verifica il completamento dell'operazione e il recupero dello spazio su disco.

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Installa la libreria corrente, collega un account Matrix dedicato ed esegui un piccolo bot !echo con una gestione più sicura delle credenziali e un test chiaro.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Configura tre bridge Mautrix con registrazioni, accessi e test separati, ed evita sorprese legate alla rete Docker, alle policy degli account e alla sincronizzazione.

Recupera spazio su disco in Synapse Media senza compromettere i file condivisi.

Scopri cosa occupa spazio di archiviazione in Synapse, imposta la conservazione sicura dei file multimediali e svuota la cache remota senza eliminare i file direttamente dal disco.

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Esamina l'attività del dispositivo, disattiva gli account Synapse inattivi confermati tramite l'API di amministrazione e scopri cosa rimuove effettivamente il flag di cancellazione opzionale.

Ridurre la pressione sulla memoria di PostgreSQL in Matrix Synapse

Scopri se l'utilizzo della memoria PostgreSQL deriva da query, buffer condivisi, connessioni o operazioni di manutenzione, quindi apporta modifiche mirate e compatibili con Synapse.

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Traccia le connessioni lente alle stanze Matrix verso un homeserver remoto, il backoff della federazione, il caricamento del database locale o una coda di invio in uscita prima di modificare le impostazioni di Synapse.

Chiudere le iscrizioni a Matrix o richiedere token di invito su Synapse

Impedisci la creazione di account aperti su un server Synapse self-hosted oppure mantieni le registrazioni accessibili solo su invito con token di registrazione a utilizzo limitato.

Avviso di identità della sessione Element: verifica le tue credenziali di accesso in modo sicuro

Clear Element offre un sistema di avviso per sessioni non verificate utilizzando un dispositivo attendibile o una chiave di ripristino, con controlli che proteggono la cronologia delle chat crittografate.

Evita i timeout di blocco dei file di ownCloud con il backend giusto

Distingui i conflitti di blocco del database dai blocchi WebDAV scaduti, quindi scegli e configura la soluzione ownCloud 10 più adatta.