MatrixをWhatsApp、Telegram、Discordに個別のブリッジで接続する

WhatsApp、Telegram、Discordを接続するには、それぞれ独立したブリッジを3つ実行し、各ブリッジをアプリケーションサービスとして登録し、それぞれのフローでサインインする必要があります。成功とは、各ボットが認証済みセッションを報告し、テストメッセージがポータルルームを介して双方向に送信されることを意味します。ボットがオンラインになるだけでは不十分です。

これは、アプリケーションサービスを許可するホームサーバーの管理者向けです。matrix.org の管理者が提供していない限り、自己ホスト型のブリッジを matrix.org に追加することはできません。ご自身で管理するサーバー、または利用可能なホスト型ブリッジをご利用ください。プロジェクトドキュメントは 2026 年 10 月 10 日に確認済みです。

1. 接続する機器を決定し、サーバーを準備する

これらは3つの独立したサービスであり、それぞれ独自の構成、登録、データベース、ログイン方法を備えています。mautrixは主にパペット方式を採用しており、メッセージはリンクされたリモートアカウントを経由して送信され、そのアカウントとしてMatrixに表示されます。リレーボットはこれとは異なり、個人のアカウントではなく共有ボットIDを使用したい場合にのみ選択してください。

アプリケーションサービスに対応したホームサーバー、管理者権限、および各ブリッジへのネットワーク接続が必要です。Dockerに関するドキュメントは既に公開されています。各ブリッジに専用のデータディレクトリを設定し、メンテナンス対象のバージョンタグを選択してください。mautrixは、latestリリースではなく最新のコミットを追跡する可能性があると指摘しています。

ブリッジごとに個別のデータベースを使用してください。PostgreSQLサーバーは共有できますが、データベース自体は他のブリッジやSynapseと共有しないでください。小規模なインスタンスの場合はSQLiteも選択肢となります。既存のポータルルームで後からエンドツーブリッジ暗号化を有効にするのは困難なため、ログイン前に暗号化の有効/無効を決定してください。

ターミナルにディレクトリ一覧が表示され、mautrix-whatsapp、mautrix-telegram、mautrix-discordの各フォルダが個別に表示され、それぞれに独自の構成ファイルとデータベースファイルが表示されます。
コンテナを起動する前に、各ブリッジの設定ファイルとデータベースをそれぞれ専用の作業ディレクトリに保存してください。

2. 3つのアプリケーションサービスすべてを構成および登録する

  1. 各ブリッジの初期設定を生成します。該当するブリッジのDockerセットアップページの手順に従って、データディレクトリをマウントした状態でコンテナを一度実行します。生成された設定を通常起動する前に編集します。ホームサーバーのドメインとアドレス、ブリッジのアドレス、データベースURI、および権限を入力します。これらの値はデプロイメント固有のものであるため、サンプルシークレットを本番環境に貼り付けないでください。
  2. コンテナからアクセス可能なアドレスを使用してください。Synapseとブリッジが Docker ネットワークを共有している場合、ブリッジのホームサーバー アドレスhttp://synapse:8008には Synapse のサービス名 (例: ) を使用できます。アプリケーション サービス アドレスは、そのブリッジのサービス名とリスニング ポートを指す必要があります。localhostブリッジ コンテナ内の は、Synapse や他のブリッジではなく、その同じコンテナを指すため、通常は通信が途絶えます。ホームサーバーが Docker の外部にある場合は、代わりに必要なブリッジ ポートを公開またはルーティングしてください。
  3. ブリッジごとに登録ファイルを1つ生成してインストールします。各ブリッジのセットアップコマンドを実行して登録YAMLを生成し、3つのファイルすべてをSynapseが読み取れる場所に配置します。 ではhomeserver.yaml、 の下にパスを追加しますapp_service_config_files。例:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

SynapseがDockerで実行されている場合は、登録ファイルをSynapseコンテナ内にマウントしてください。リストを編集した後は、Synapseを再起動してください。YAMLの入力ミス、パスの誤り、マウントポイントの読み取り不能、またはブリッジアドレスの不一致は、登録を妨げたり、Synapseの起動を停止させたりする可能性があります。登録関連のブリッジ設定を後で変更する場合は、該当する登録ファイルを再生成し、Synapseを再度再起動してください。

コードエディタに、WhatsApp、Telegram、Discordの3つのアプリケーションサービス登録パスがそれぞれ個別に記述されたSynapse homeserver.yamlファイルが表示されています。
Synapseは、ブリッジごとに個別の読み取り可能な登録パスを必要とし、その後ホームサーバーを再起動する必要があります。
コンテナステータスパネルに、共有Matrixネットワーク上でSynapseと3つのMatrixブリッジコンテナが実行されていることが表示されている。
Synapseと3つのブリッジコンテナすべてが、サービス名が解決されるネットワーク上で実行されていることを確認してください。

3. サービス固有の認証情報を追加してサインインします

WhatsApp

mautrix-whatsapp を起動し、ブリッジボットを使用して Matrix ダイレクトメッセージを開きます (通常は@whatsappbot:your.server)。 を送信しlogin qr、次に、スマートフォンの WhatsApp のリンク済みデバイス画面から QR コードをスキャンします。ボットが認証を確認するまで待ちます。ブリッジのドキュメントによると、ポータル ルームが表示されるまでに約 1 分かかる場合があります。 WhatsApp はデバイスとしてリンクされているため、これはスタンドアロンのクラウド アカウントではありません。ブリッジのドキュメントによると、電話が 2 週間以上オフラインのままになると、リンクされたデバイスは切断されます。電話をアクティブに保つことができない場合は、重要なチャットにこのブリッジを使用する前に、このブリッジが信頼性のニーズを満たしているかどうかを検討してください。

テレグラム

Telegramにログインする前に、 my.telegram.org/appsでAPIアプリケーションを作成し、そのAPIとAPIをmautrix-telegramの設定に追加してくださいapi_id。api_hashこれらのAPI値により、ブリッジはTelegramのAPIに接続できますが、それ自体ではTelegramアカウントを認証しません。次に、メッセージを送信@telegrambot:your.serverしてlogin qr、Telegramのモバイルアプリの[設定]、[デバイス]、[デスクトップデバイスのリンク]からスキャンして使用します。コードオプションは、SMSではなく既存のTelegramセッションに配信される場合があり、ブリッジは2段階認証パスワードの入力を求める場合があります。古いメッセージのインポートが重要な場合は、ログイン前にブリッジのバックフィル設定を確認してください。ポータルルームが作成された後で期待値を変更すると、手遅れになる可能性があります。

Discord

サーバーには、個人のアカウントの自動化ではなく、専用の Discord ボットを使用してください。Discord は自己ボットを禁止しており、アカウントを停止する場合があります。開発者ポータルでアプリケーションとボットを作成し、ブリッジが必要とする特権インテントとアプリが取得できるインテントのみを有効にしてから、OAuth2 ボット スコープと最小限のチャネル権限で招待します。インテントへのアクセスはポリシーによって制御されます。必要なメッセージ コンテンツまたはメンバー アクセスがない場合、一部の機能が動作しない可能性があります。Matrix では、DM を送信@discordbot:your.serverし、mautrix-discord のボット トークン ログイン手順に従ってください。ボットは、ユーザー アカウント ブリッジと同じ個人 DM アクセスを提供しません。

Synapseサービスアドレス、mautrix-whatsappサービスアドレス、および固有のブリッジデータベース名を表示するブリッジ構成エディタ。
各ブリッジの設定で、サービスホスト名、ブリッジリスナー、および固有のデータベースの詳細を確認してください。

4. テスト配信を行い、結果に基づいて調整する。

各ブリッジボットにDMを送信し、認証済みであることを確認してください。サービスごとに1つのポータルルームで、Matrixからテストメッセージを送信し、リモートアプリから返信してください。両方のメッセージが正しいルームに届いていることを確認してください。グループまたはDiscordチャンネルの場合は、まずブリッジアカウントが存在し、読み取り/投稿権限を持っていることを確認してください。ログインが成功しただけでは、配信が証明されません。

ボットが応答しない場合は、ログに値の欠落、データベースエラー、またはホームサーバーへの接続状況を確認してください。ログインはできるがルームが表示されない場合は、ポータルとバックフィル設定を確認してください。Discordチャンネルのメッセージが欠落している場合は、ボットのメンバーシップ、権限、およびインテントアクセスを確認してください。Synapseの起動に失敗した場合は、YAMLのインデントと読み取り可能な登録ファイルのマウントを確認してください。

機能のサポート状況はブリッジのバージョンとアカウントの種類によって異なります。通話、リアクション、暗号化されたチャット、メディア、履歴のインポートなどは、異なる場合やサポートされていない場合があります。唯一のアクセスポイントとして使用する前に、各ブリッジの最新の機能リストを確認してください。登録ファイルと認証情報へのアクセスを制限し、ブリッジデータを安全にバックアップし、リンクされたセッションまたはトークンが漏洩した場合は取り消してください。

バージョン固有のコマンドについては、最新のmautrix Dockerの手順、登録ガイド、設定リファレンス、およびWhatsApp、Telegram、Discordの認証ページを参照してください。Discordのセルフボットポリシーを確認してください。

コメントを残す

SynapseのSystemdファイル制限を推測なしで引き上げる

SynapseのSystemdファイル制限を推測なしで引き上げる

Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。

要素に「復号化に失敗しました」と表示されますか?紛失したルームキーを復元してください。

要素に「復号化に失敗しました」と表示されますか?紛失したルームキーを復元してください。

エラーが特定のブラウザまたは特定のイベントに限定されているかどうかを確認し、残りの暗号化された履歴を危険にさらすことなく、Elementのリカバリキーまたは信頼できるデバイスを使用してください。

データを失うことなく、古いSynapseメッセージとメディアをクリーンアップする

Synapseの履歴およびメディア消去APIまたは保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。

Simple-Matrix-Bot-Libを使用してPythonでMatrix Echo Botを構築する

Simple-Matrix-Bot-Libを使用してPythonでMatrix Echo Botを構築する

最新のライブラリをインストールし、専用のMatrixアカウントに接続して、より安全な認証情報処理と明確なテストを備えた小型の!echoボットを実行します。

MatrixをWhatsApp、Telegram、Discordに個別のブリッジで接続する

MatrixをWhatsApp、Telegram、Discordに個別のブリッジで接続する

登録、ログイン、テストをそれぞれ別々に行う3つのmautrixブリッジを設定することで、Dockerのネットワーク、アカウントポリシー、同期に関する予期せぬ問題を回避できます。

共有ファイルを破損させることなくSynapse Mediaのディスク容量を解放する

Synapseストレージを占有しているファイルを特定し、安全なメディア保持期間を設定し、ディスクから直接ファイルを削除することなくリモートキャッシュを消去します。

ルーム履歴を削除せずに、非アクティブなマトリックスユーザーを無効化する

ルーム履歴を削除せずに、非アクティブなマトリックスユーザーを無効化する

デバイスのアクティビティを確認し、Admin API を介して確認済みの非アクティブな Synapse アカウントを無効化し、オプションの消去フラグが実際に何を削除するのかを学びます。

Matrix SynapseにおけるPostgreSQLのメモリ負荷を軽減する

PostgreSQLのメモリがクエリ処理、共有バッファ、接続、メンテナンスのいずれに起因しているかを特定し、Synapseに安全な変更を的確に行います。

マトリックスシナプスルームの結合が遅い理由と、確認すべき点

マトリックスシナプスルームの結合が遅い理由と、確認すべき点

Synapseの設定を変更する前に、Matrixルームへの参加が遅い原因を、リモートホームサーバー、フェデレーションのバックオフ、ローカルデータベースの負荷、または送信キューのいずれかに特定してください。

SynapseでMatrixサインアップを閉鎖するか、招待トークンを必須にする

自己ホスト型のSynapseサーバーでの新規アカウント作成を停止するか、登録を招待制にし、使用回数に制限のある登録トークンを使用するようにしてください。