Bridges authorization

On this page you can find how-to instructions for bridges

Discord

Start a chat with @_discordpuppet_bot:yourserver.com. When it joins, type help in the chat to see instructions.

Source

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.

  1. Click on New Application
  2. Customize your bot how you like
  3. Go to Create Application and scroll down to the next page. Find Create a Bot User and click on it.
  4. Click Yes, do it!
  5. Find the bot’s token in the App Bot User section.
  6. Click Click to Reveal
  7. 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 don’t work, use this method.

Then send the bot a message with the contents link user your.token-here.

Facebook

Start a chat with @facebookbot:yourserver.com. When it joins, type help in the chat to see instructions

Source

  1. Send login your@email.here to the bridge bot
  2. Send your password in next message
  3. If you have 2FA enabled, the bot will ask you to send the 2FA token.
  4. 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

Source

  1. Send login to the bridge bot
  2. Follow the link sent by bot, click Start and follow the instructions
  3. 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.

Source

  1. Go to dev.group.me, sign in and select Access Token from the top menu
  2. Send link your.token-here to the bridge bot. Note the puppet ID that it returns
  3. You can now get invites to all your groups and DMs with bridgeeverything your.puppetID or use the bridgegroup command to bridge individual groups

Hangouts (deprecated)

WARNING: that bridge was deprecated. Please, use Google Chat bridge instead.

Start a chat with @hangoutsbot:yourserver.com. When it joins, you will get instructions automatically

Source

  1. Send login to the bridge bot
  2. Open the link sent by the bot, click Start and follow the instructions.
  3. Recent chats should now get portals automatically. Other chats will get portals as you receive messages.

IRC

Start a chat with @heisenbridge:yourserver.com. When it joins, type help in the chat to see instructions

Source

  1. Send addnetwork network.name, eg: addnetwork libera.chat
  2. Send addserver network.name irc-server.address port --tls, eg: addserver libera.chat irc.libera.chat 6697 --tls
  3. Send open network.name, eg: open libera.chat. Bridge bot will create control room for that IRC network and invite you
  4. In new room, read the bot instructions in the first room message and configure it as you wish, after that send connect
  5. Send join #room-name to bridge an IRC room

Instagram

Start a chat with @instagrambot:yourserver.com. When it joins, type help in the chat to see instructions

Source

  1. Send login your@email.here your.password-here to the bridge bot
  2. 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.
  3. Recent chats should now get portals automatically. Other chats will get portals as you receive messages.

LinkedIn

Start a chat with @linkedinbot:yourserver.com. When it joins, type help in the chat to see instructions

Source

  1. Send login your@email.here to the bridge bot
  2. Send your password in next message
  3. If you have 2FA enabled, the bot will ask you to send the 2FA token.
  4. 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

Source

Option 1: secondary device

If you still want to have signal app installed

  1. Go to Linked Devices in Signal app and add a new device
  2. Send link to the bridgebot
  3. Scan the QR code the bridge bot sends you

Option 2: primary device

If you don’t want to have separate signal app installed

  1. Open the Signal Captcha Generator (Google reCaptcha) and solve the captcha
  2. You will be redirected to a URL that your browser won’t understand, starting with signalcaptcha://. Everything after signalcaptcha:// 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 the signalcaptcha:// URL will show up as part of a warning message.
  3. 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
  4. Once you get the SMS verification code, send it to the bridge.
  5. To be able to participate in v2 groups, set a profile name with set-profile-name Your Name.

Skype

Start a chat with @_skypepuppet_bot:yourserver.com. When it joins, type help in the chat to see instructions.

Source

  1. Send link your.username-here your.password-here
  2. Send list to see available rooms
  3. Click on any room in the list will trigger an invite to that room from the bridge bot

Slack

Start a chat with @_slackpuppet_bot:yourserver.com. When it joins, type help in the chat to see instructions.

Source

Option 1: OAuth2

  1. Setup a Slack app. You do not need to setup any of the additional features or functionality that Slack prompts you to enable when you create a new Slack app.
  2. Go to the OAuth & Permissions tab in the sidebar
  3. Add your redirect URL
  4. Fill in the oauth block in your bridge config file. Be sure to forward the oauth.redirectUri to the bridge
  5. Send link to the bridge bot
  6. Click the link it gives and allow access
  7. Copy the token given and send the bot that token with: link your.token-here

Option 2: xoxc token (against ToS)

Warning: Linking your xoxc account’s token is against Slack Terms of Service.

  1. Open slack workspace in browser
  2. Open browser dev tools (chrome devtools) and go to the network tab
  3. Filter requests by type WS/WebSocket
  4. Find xoxc token as parameter of one of the URLs
  5. Go to devtools storage tab to get list of cookies
  6. Find d cookie and copy it contents
  7. 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.

  1. Send link your.username-here your.password-here to the bridge bot
  2. 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

Source

  1. Send login to the bridge bot
  2. Click on the link bot sent to you and fill your phone number (without spaces, dots, etc) and click on Request Code
  3. Enter your code and click Sign in.
  4. If you have 2FA enabled, enter your password and click on Sign in again.
  5. Recent chats should now get portals automatically. Other chats will get portals as you receive messages.

WhatsApp

Start a chat with @whatsappbot:yourserver.com. When it joins, type help in the chat to see instructions

Source

  1. Send login to the bridge bot
  2. Open WhatsApp on your phone
  3. Tap Menu or Settings and select WhatsApp Web
  4. Point your phone at the image sent by the bot to capture the code
  5. 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.