Bridges authorization
On this page, you can find how-to instructions for bridges
Discord
Start a chat with @discordbot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login
to the bridge bot - Open the Discord app on your phone
- Point your phone at the image sent by the bot to capture the code, official docs
- After scanning the code, you’ll need to approve the login on the mobile app
- Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
You may uninstall the Discord app from your mobile phone after that.
Useful commands:
guild status
to see the list of guildsguilds bridge GUILD_ID --entire
bridge a guild
Discord (old)
If the bridge was added to your server before August 2022
Start a chat with @_discordpuppet_bot:yourserver.com
. When it joins, type help
in the chat to see instructions.
Option 1: discord bot
This is the recommended method and allows Discord users to PM you through a bot.
First, visit your Discord Application Portal.
- Click on
New Application
- Customize your bot how you like
- Go to
Create Application
and scroll down to the next page. FindCreate a Bot User
and click on it. - Click
Yes, do it!
- Find the bot’s token in the
App Bot User
section. - Click
Click to Reveal
- Finally, send the appservice bot a message with the contents
link bot your.token-here
Option 2: user token (against Discord ToS)
Warning: Linking your user account’s token is against Discord Terms of Service.
First, retrieve your Discord User Token. If this doesn’t work, use this method.
Then send the bot a message with the contents link user your.token-here
.
Start a chat with @facebookbot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login your@email.here
to the bridge bot - Send your password in the next message
- If you have 2FA enabled, the bot will ask you to send the 2FA token.
- Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Note that in some cases, Facebook might decide your account has suspicious activity and block you until you do some tasks like adding a phone number or resetting your password. In most cases, enabling two-factor authentication solves this.
Google Chat
Start a chat with @googlechatbot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login
to the bridge bot - Follow the link sent by the bot, click
Start
, and follow the instructions - Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Note that automatic login may not work.
If it does not, reload the page and select the Manual login
checkbox before starting.
Manual login involves logging into your Google account normally and then manually getting
the OAuth token from browser cookies with developer tools.
GroupMe
Start a chat with @_groupmepuppet_bot:yourserver.com
. When it joins, type help
in the chat to see instructions.
- Go to dev.group.me, sign in and select
Access Token
from the top menu - Send
link your.token-here
to the bridge bot. Note the puppet ID that it returns - You can now get invites to all your groups and DMs with
bridgeeverything your.puppetID
or use thebridgegroup
command to bridge individual groups
IRC
Start a chat with @heisenbridge:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
addnetwork network.name
, eg:addnetwork libera.chat
- Send
addserver network.name irc-server.address port --tls
, eg:addserver libera.chat irc.libera.chat 6697 --tls
- Send
open network.name
, eg:open libera.chat
. Bridge bot will create a control room for that IRC network and invite you - In the new room, read the bot instructions in the first room message and configure it as you wish, after that send
connect
- Send
join #room-name
to bridge an IRC room
Start a chat with @instagrambot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login your@email.here your.password-here
to the bridge bot - If you have 2FA enabled, the bot will ask you to send the 2FA token. If you don’t have 2FA enabled, Instagram will likely ask you to confirm the login, in which case the bot will ask you to send the confirmation code.
- Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Kakaotalk
Start a chat with @kakaotalkbot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login --save your@email.OR.phone-number
to the bridge bot
Start a chat with @linkedinbot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login your@email.here
to the bridge bot - Send your password in the next message
- If you have 2FA enabled, the bot will ask you to send the 2FA token.
- Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Note: If you don’t have 2FA enabled and are logging in from a strange IP for the first time, LinkedIn will send an email with a one-time code. You can use this code to authorize the bridge session. Usually, once the IP is authorized, you will not be asked again.
Signal
Start a chat with @signalbot:yourserver.com
. When it joins, type help
in the chat to see instructions
Option 1: secondary device
If you still want to have the signal app installed
- Go to
Linked Devices
in Signal app and add a new device - Send
link
to the bridge bot - Scan the QR code the bridge bot sends you
Option 2: primary device
If you don’t want to have a separate signal app installed
- Open the Signal Captcha Generator (Google reCaptcha) and solve the captcha
- You will be redirected to a URL that your browser won’t understand, starting with
signalcaptcha://
. Everything aftersignalcaptcha://
is the captcha token, copy it. In Firefox, you may need to open the Developer Console (Menu -> Web Developer -> Console or ctrl-shift-k), where thesignalcaptcha://
URL will show up as part of a warning message. - Send
register --captcha your.captcha-token +phonenumber
, eg:register --captcha 03AOLTBLR84zMWX9mh1gHaFZJwLYflPh0Bsi3_oYwsxJ9bTt_dV9mcmOMmhHZ19E_4waszAMc7EmPM7IfGSJc4471E45JLXgr2YjRlp36k7_AU5t8ww1IOrZid8hl9fqMs9FNIWx9IUj-TpmTdGnYTKpHhLKsQ5EjO53DeJcccp3Ay66PsvHWHXdda9rEAD-DDt6WbU7m-Mki_sVBIo3kJiV094fLOALTz7tTccAyGHH-rna9lIqceaxgeuvJhxteT_xdf2OU3df1TIQsUGbComAEYNCoreElcpBIv70BmsfCQiN_uUA76ILbnFJS5Ox_kFjqSscjR9V0VUbKE3SKknCc84NT3bPCYo9zSCUZDZ5VksbcaGxfziUMBnXG3MGUH__zu9hRoyZcf1ZWO-1_T2WnCQSvafKjle3DB08KBk5immiXwcIjkEDqshoJWXHUpHC7PcI0d0Q9hAXffuWvB4K5bfqNlgJIa_IigN_f06362sWyzHBkqcpcvAmJbf8rggKuW3OIQ5fvOIvUZ5NKBgZSj8g46mAoJj3fsLVCRn9vz7zKFZZRLMg8 +12024561414
- Once you get the SMS verification code, send it to the bridge.
- To be able to participate in v2 groups, set a profile name with
set-profile-name Your Name
.
Skype
Start a chat with @skypebridgebot:yourserver.com
. When it joins, type help
in the chat to see instructions.
Slack
Start a chat with @_slackpuppet_bot:yourserver.com
. When it joins, type help
in the chat to see instructions.
Option 1: OAuth2
- Set up a Slack app. You do not need to set up any of the additional features or functionality that Slack prompts you to enable when you create a new Slack app.
- Go to the
OAuth & Permissions
tab in the sidebar - Add your redirect URL
- Fill in the
oauth
block in your bridge config file. Be sure to forward theoauth.redirectUri
to the bridge - Send
link
to the bridge bot - Click the link it gives and allow access
- Copy the token given and send it to the bot:
link your.token-here
Option 2: xoxc token (against ToS)
Warning: Linking your xoxc account’s token is against Slack Terms of Service.
- Open a slack workspace in a browser
- Open browser dev tools (chrome dev tools) and go to the Network tab
- Filter requests by type WS/WebSocket
- Find
xoxc
token as a parameter of one of the URLs - Go to the dev tools Storage tab to get a list of cookies
- Find
d
cookie and copy its contents - Send
link your.xoxc-token your.d-cookie
to the bridge bot
Steam
Start a chat with @_steampuppet_bot:yourserver.com
. When it joins, type help
in the chat to see instructions.
- Send
link your.username-here your.password-here
to the bridge bot - If a steam guard (mobile or email) code is required, you will be asked for the code.
Telegram
Start a chat with @telegrambot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login
to the bridge bot - Click on the link bot sent to you and fill your phone number (without spaces, dots, etc), and click on
Request Code
- Enter your code and click
Sign in
. - If you have 2FA enabled, enter your password and click on
Sign in
again. - Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Start a chat with @twitterbot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login-cookie
to the bridge bot - The bot will send you these instructions to extract required cookies. Follow the steps to log into the bridge
- Log into the Twitter in private/incognito browser window
- Press
F12
to open developer tools - Select the
Application
(Chrome, Safari, Edge) orStorage
(Firefox) tab - In the sidebar, expand
Cookies
and selecthttps://twitter.com
- In the cookie list, find the
auth_token
row and double click on the value then copy the value and send it to the chat - In the cookie list, find the
ct0
row and double click on the value then copy the value and send it to the chat - Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Start a chat with @whatsappbot:yourserver.com
. When it joins, type help
in the chat to see instructions
- Send
login
to the bridge bot - Open WhatsApp on your phone
- Tap
Menu
orSettings
and selectWhatsApp Web
- Point your phone at the image sent by the bot to capture the code
- Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Please note that the bridge uses the web API, so your phone must be connected to the internet for the bridge to work. The WhatsApp app doesn’t need to be running all the time, but it needs to be allowed to wake up when receiving messages. The web API is used instead of the main client API to avoid getting banned.