Home
» Come fare
»
Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.
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.
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
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.
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.
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:
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.
Synapse richiede un percorso di registrazione separato e leggibile per ogni bridge, seguito dal riavvio dell'homeserver.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.
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.