Verbind Matrix met WhatsApp, Telegram en Discord via Separate Bridges.

Om WhatsApp, Telegram en Discord te verbinden, moet je drie aparte bridges opzetten, elk registreren als een applicatieservice en inloggen via de eigen workflow. Succes betekent dat elke bot een geauthenticeerde sessie meldt en dat testberichten in beide richtingen via portalrooms worden verzonden; het is niet voldoende dat een bot alleen online verschijnt.

Dit is bedoeld voor beheerders van een thuisserver die applicatieservices toestaat. U kunt geen zelfgehoste bridge toevoegen aan matrix.org, tenzij de beheerders er een aanbieden; gebruik een server die u beheert of een beschikbare gehoste bridge. De projectdocumentatie is gecontroleerd op 10 oktober 2026.

1. Bepaal waarmee u verbinding wilt maken en bereid de server voor.

Dit zijn drie afzonderlijke services, elk met een eigen configuratie, registratie, database en login. mautrix maakt voornamelijk gebruik van puppeting: berichten worden via uw gekoppelde externe account verzonden en verschijnen in Matrix onder de naam van dat account. Een relay-bot werkt anders; kies hiervoor alleen als u een gedeelde bot-identiteit wilt in plaats van uw persoonlijke account.

Je hebt een homeserver nodig die geschikt is voor applicatieservices, beheerdersrechten en netwerkverbinding met elke bridge. Docker is gedocumenteerd. Geef elke bridge een eigen datamap en kies een onderhouden versie-tag; mautrix merkt op dat deze latestmogelijk de meest recente commit volgt in plaats van een release.

Gebruik een aparte database per bridge; een PostgreSQL-server mag gedeeld worden, maar de database zelf mag niet gedeeld worden met een andere bridge of Synapse. SQLite is een optie voor kleinere instanties. Besluit vóór het inloggen over end-to-bridge-encryptie, omdat het later inschakelen ervan voor bestaande portalrooms lastig is.

Terminal directorylijst met aparte mappen voor mautrix-whatsapp, mautrix-telegram en mautrix-discord, elk met een eigen configuratie- en databasebestand.
Bewaar de configuratie en database van elke bridge in een eigen werkmap voordat u de containers start.

2. Configureer en registreer alle drie de applicatieservices.

  1. Genereer de initiële configuratie voor elke bridge. Volg de Docker-installatiepagina voor die bridge en start de container eenmaal met de bijbehorende data-directory. Bewerk de gegenereerde configuratie voordat u de bridge normaal start. Vul het domein en adres van de homeserver, het bridge-adres, de database-URI en de machtigingen in. Deze waarden zijn specifiek voor uw implementatie; plak geen voorbeeldgeheimen in een productieomgeving.
  2. Gebruik adressen die bereikbaar zijn vanuit de container. Wanneer Synapse en de bridges een Docker-netwerk delen, kan het homeserver-adres van de bridge de servicenaam van Synapse gebruiken, bijvoorbeeld http://synapse:8008. Het applicatieservice-adres moet terugverwijzen naar de servicenaam en luisterpoort van die bridge. Als het localhostadres binnen een bridge-container naar diezelfde container verwijst, niet naar Synapse of een andere bridge, dan wordt de communicatie meestal verbroken. Als de homeserver zich buiten Docker bevindt, publiceer of routeer dan de vereiste bridgepoort.
  3. Genereer en installeer één registratiebestand per bridge. Voer voor elke bridge de setup-opdracht uit om het bijbehorende registratie-YAML-bestand te genereren en plaats vervolgens alle drie de bestanden op een locatie waar Synapse ze kan lezen. homeserver.yamlVoeg in het bestand de paden naar de bestanden toe onder app_service_config_filesbijvoorbeeld:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

Plaats de registratiebestanden in de Synapse-container als Synapse in Docker draait. Herstart Synapse na het bewerken van de lijst. Een typefout in het YAML-bestand, een verkeerd pad, een onleesbare mount of een onjuist bridge-adres kan registratie voorkomen of ervoor zorgen dat Synapse niet opstart. Als u later registratiegerelateerde bridge-instellingen wijzigt, genereer dan het betreffende registratiebestand opnieuw en herstart Synapse.

Code-editor die het Synapse homeserver.yaml-bestand toont met drie afzonderlijke paden voor applicatieservice-registratie voor WhatsApp, Telegram en Discord.
Synapse heeft voor elke bridge een apart, leesbaar registratiepad nodig, gevolgd door een herstart van de homeserver.
In het containerstatuspaneel worden Synapse en drie mautrix bridge-containers weergegeven als actief op een gedeeld Matrix-netwerk.
Controleer of Synapse en alle drie de bridge-containers draaien op een netwerk waar hun servicenamen correct worden opgelost.

3. Voeg de servicespecifieke inloggegevens toe en meld u aan.

WhatsApp

Start mautrix-whatsapp en open een Matrix-direct bericht met de bijbehorende bridge-bot, meestal @whatsappbot:your.server. Stuur login qr, en scan vervolgens de QR-code in het scherm 'Gekoppelde apparaten' van WhatsApp op je telefoon. Wacht tot de bot de authenticatie bevestigt; volgens de bridge-documentatie kan het ongeveer een minuut duren voordat portalrooms verschijnen. WhatsApp is gekoppeld als een apparaat, dus dit is geen zelfstandig cloudaccount. De bridge-documentatie vermeldt dat gekoppelde apparaten de verbinding verbreken als de telefoon langer dan twee weken offline blijft. Als je de telefoon niet actief kunt houden, overweeg dan of deze bridge aan je betrouwbaarheidseisen voldoet voordat je erop vertrouwt voor belangrijke chats.

Telegram

Voordat je inlogt op Telegram, maak je een API-applicatie aan op my.telegram.org/apps en voeg je de API-waarden api_idtoe api_hashaan de configuratie van mautrix-telegram. Deze API-waarden zorgen ervoor dat de bridge verbinding kan maken met de Telegram API; ze authenticeren op zichzelf geen Telegram-account. Stuur vervolgens een bericht @telegrambot:your.serveren gebruik login qrde code, die je kunt scannen in de mobiele Telegram-app onder Instellingen, Apparaten en Koppel desktopapparaat. De code kan worden verzonden naar een bestaande Telegram-sessie in plaats van via sms, en de bridge kan je vragen om je wachtwoord voor tweestapsverificatie. Controleer de backfill-instellingen van de bridge voordat je inlogt als het importeren van oudere berichten belangrijk voor je is; het kan te laat zijn om de verwachtingen aan te passen nadat portalrooms zijn aangemaakt.

Meningsverschil

Gebruik voor een server een speciale Discord-bot en niet de automatisering van je persoonlijke account: Discord verbiedt zelfgemaakte bots en kan accounts beëindigen. Maak een applicatie en bot aan in de ontwikkelaarsportal, schakel alleen de geprivilegieerde intents in die de bridge vereist en die je app kan verkrijgen, en nodig de bot vervolgens uit met de OAuth2-botscope en minimale kanaalrechten. Toegang tot intents wordt beheerd door beleid; zonder de benodigde berichtinhoud of toegang tot leden werken sommige functies mogelijk niet. In Matrix kun je een DM sturen @discordbot:your.serveren de instructies voor het inloggen met de bottoken van mautrix-discord volgen. Een bot biedt niet dezelfde toegang tot persoonlijke DM's als een bridge met een gebruikersaccount.

Een configuratie-editor voor bridges die een Synapse-serviceadres, een mautrix-whatsapp-serviceadres en een unieke bridge-databasenaam weergeeft.
Controleer de hostnaam van de service, de bridge-listener en de unieke databasegegevens in de configuratie van elke bridge afzonderlijk.

4. Test de levering en pas vervolgens alleen aan wat het resultaat laat zien.

Stuur een DM naar elke bridge-bot en bevestig de authenticatiestatus. Verstuur in één portal-room per service een testbericht vanuit Matrix en beantwoord dit vanuit de externe app. Controleer of beide berichten in de juiste room aankomen. Controleer voor groepen of Discord-kanalen eerst of het bridge-account aanwezig is en lees-/postrechten heeft. Een succesvolle login alleen is geen bewijs van levering.

Als een bot niets doet, controleer dan de logbestanden op ontbrekende waarden, databasefouten of verbindingsproblemen met de homeserver. Als inloggen werkt maar kamers niet verschijnen, controleer dan de portal- en backfill-instellingen. Controleer bij ontbrekende berichten in Discord-kanalen het botlidmaatschap, de machtigingen en de intent-toegang. Als Synapse niet start, controleer dan de YAML-inspringing en of de registratiebestanden leesbaar zijn.

De ondersteuning voor functies varieert per bridge-versie en accounttype; oproepen, reacties, versleutelde chats, media en het importeren van de geschiedenis kunnen verschillen of niet worden ondersteund. Controleer de actuele functielijst van elke bridge voordat u deze als enige toegangspunt gebruikt. Beperk de toegang tot registratiebestanden en inloggegevens, maak een veilige back-up van bridgegegevens en trek een gekoppelde sessie of token in als deze is blootgesteld.

Raadpleeg de actuele instructies voor mautrix Docker , de registratiehandleiding , de configuratiereferentie en de authenticatiepagina's van WhatsApp , Telegram en Discord voor versiespecifieke commando's. Bekijk het beleid van Discord met betrekking tot zelf-bots .

Laat een reactie achter

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Stel vast of Synapse de limiet voor geopende bestanden per proces heeft bereikt, stel een systemd drop-in in voor de juiste service of worker en controleer de actuele limiet.

Geeft het element de melding "Ontsleutelen mislukt"? Herstel de ontbrekende kamersleutel.

Geeft het element de melding "Ontsleutelen mislukt"? Herstel de ontbrekende kamersleutel.

Ontdek of de fout beperkt is tot één browser of één gebeurtenis, en gebruik vervolgens de herstelsleutel van Element of een vertrouwd apparaat om te voorkomen dat uw resterende versleutelde geschiedenis verloren gaat.

Verwijder oude Synapse-berichten en -media zonder gegevensverlies.

Gebruik de API's van Synapse voor het verwijderen van geschiedenis en media, of de bewaarinstellingen, om verouderde gegevens veilig te verwijderen. Controleer vervolgens of de verwijdering is voltooid en of er schijfruimte is vrijgekomen.

Bouw een Matrix Echo Bot in Python met Simple-Matrix-Bot-Lib.

Bouw een Matrix Echo Bot in Python met Simple-Matrix-Bot-Lib.

Installeer de huidige bibliotheek, koppel een speciaal Matrix-account en voer een kleine !echo-bot uit met veiligere omgang met inloggegevens en een duidelijke test.

Verbind Matrix met WhatsApp, Telegram en Discord via Separate Bridges.

Verbind Matrix met WhatsApp, Telegram en Discord via Separate Bridges.

Zet drie mautrix bridges op met aparte registraties, logins en tests, en voorkom verrassingen op het gebied van Docker-netwerken, accountbeleid en synchronisatie.

Maak schijfruimte vrij op Synapse Media zonder gedeelde bestanden te beschadigen.

Ontdek wat de Synapse-opslag vult, stel veilige bewaartermijnen voor media in en wis de cache op afstand zonder bestanden direct van de schijf te verwijderen.

Deactiveer inactieve Matrix-gebruikers zonder de kamergeschiedenis te verwijderen.

Deactiveer inactieve Matrix-gebruikers zonder de kamergeschiedenis te verwijderen.

Bekijk de apparaatactiviteit, deactiveer bevestigde inactieve Synapse-accounts via de Admin API en ontdek wat de optionele wisvlag precies verwijdert.

Verminder de geheugenbelasting van PostgreSQL in Matrix Synapse.

Bepaal of het geheugengebruik van PostgreSQL afkomstig is van query's, gedeelde buffers, verbindingen of onderhoud, en voer vervolgens gerichte, Synapse-veilige wijzigingen door.

Waarom deelname aan Matrix Synapse Rooms traag verloopt en wat je kunt controleren

Waarom deelname aan Matrix Synapse Rooms traag verloopt en wat je kunt controleren

Traceer trage Matrix-ruimteverbindingen met een externe thuisserver, federatievertraging, lokale databasebelasting of een uitgaande verzendwachtrij voordat u Synapse-instellingen wijzigt.

Sluit Matrix-aanmeldingen af ​​of vereis uitnodigingstokens op Synapse.

Stop met het aanmaken van open accounts op een zelfgehoste Synapse-server, of beperk aanmeldingen tot uitnodigingen met registratietokens voor beperkt gebruik.