Changes between Initial Version and Version 1 of en/NLPMatrixDiscord

Timestamp:

Jun 27, 2025, 6:11:20 PM (6 days ago)

Author:

Ales Horak

Comment:

--

en/NLPMatrixDiscord

@@ +1 @@
+= Redirect Discord messages to NLP Matrix
+
+Redirecting selected rooms or servers from Discord to a NLP Matrix space is easy.
+You only need to have a user account on both the Discord and NLP Matrix servers and you are ready to go.
+
+
+[[PageOutline(2,The Discord -> Matrix setup consists of the following steps:,inline)]]
+
+== Find the Discord tokens and IDs
+
+Connect to the Discord app at https://discord.com/channels/@me
+and find out the user token and the room and Discord server (guild) IDs.
+
+=== Discord user token
+
+Since the Matrix discordbot must operate on Discord on your behalf, you need to provide it with the corresponding `Authorization` token. The steps to find the token are as follows.
+
+1. Press `<F12>` to open the ''Browser developer tools''. Go to the 
+   ''Network'' tab and filter the URL list for `api`. Reload the web page.
+1. Choose one of the URLs in the list with type `xml` or `xhr`. Display the ''Request headers''.
+1. Find `Authorization` in the header list - its value, is the **user token**. It should be something like `HEWkw2HE329cdsIOAAKSLFoosd.cspdfpoutwBJDW304DAQWEu0sdyvbsasDV02dfsggd3Ie`.
+
+=== Discord server/guild and room IDs
+
+Navigate to the selected Discord room within your https://discord.com/channels/@me app. Look at the URL of the room.
+It should look like
+{{{
+https://discord.com/channels/3254238502750491529/1650295748356024125
+}}}
+The two numbers, `3254238502750491529` and `1650295748356024125` are the
+**server ID** (also called guild ID) and **channel ID**.
+
+== Create a NLP Matrix discordbot room
+
+Login to NLP Matrix and create a new room named e.g. `Discord bridge bot`.
+Invite user `@discordbot:nlp.fi.muni.cz` to the room. You should see the message
+{{{
+Hello, I'm a Discord bridge bot.
+This room has been registered as your bridge management/status room.
+Use help for help or login to log in.
+}}}
+In this room, you will be commanding your Discord bridging bot. You may start with the `help` command.
+
+== Choose which Discord items should be mirrored
+
+First, you need to log the `discordbot` to Discord on your behalf. Recall the 
+''user token'' that you have found in the previous section and in the NLP Matrix
+`Discord bridge bot` room enter the command:
+{{{
+login-token user HEWkw2HE329cdsIOAAKSLFoosd.cspdfpoutwBJDW304DAQWEu0sdyvbsasDV02dfsggd3Ie
+}}}
+where the `HEWk...Ie` is your `Authorization` user token.
+
+The discord bot should reply with
+{{{
+Connecting to Discord as user ID 4029354238562374375
+Successfully logged in as @your.discord.user.name
+}}}
+
+When logged in, you may connect as many Discord servers as you wish.
+You don't even need to look for the server/guild ID at Discord.
+Just ask discordbot to
+{{{
+guilds status
+}}}
+and it will answer with your list of Discord servers such as
+{{{
+
+}}}
+The easiest way is just to find the  and instruct the
+discordbot to
+{{{
+List of guilds:
+
+    FI MUNI (252345435334213123) - never bridge messages
+    DigiLing (5562352412313131231) - never bridge messages
+    ...
+}}}
+Now instruct discordbot to establish the bridge
+{{{
+guilds bridge 252345435334213123 --entire
+}}}
+shoud lead to
+{{{
+Successfully bridged guild
+}}}
+and discordbot creating a number of new invites for you to NLP Matrix space named `Discord` and to new NLP Matrix room for each Discord room in the bridged Discord server.
+
+[[br]]
+
+That's it! Now you can manage Discord and Matrix room in one place!