Skip to main content

Bridges

Common information

Bridges are used to connect to other messanger services like Whatsapp, Telegram, etc. Any bridge bot you have invited into a channel reacts to the command "help". It returns a list of commands you can use to manage your connected account to the messanger service.

Bridge request

If you like to use a bridge that frei.chat does not offer please feel free to tell us in the Support channel.

Third party service: t2bot.io

If you don't want to use the frei.chat bridges you can invite the bots from t2bot.io. Frei.chat is NOT responsible for any issues, privacy policies or service uptime of these third party services.

Inviting a bot

To invite a bot you have to create an unencrypted room. The bots on frei.chat can only talk to you from an unencrypted room. To avoid leaking personal data, like usernames or password, you can remove the message by right clicking on the three dots and Remove.

List of bots on frei.chat

End-to-bridge encryption

No encryption supported by bridge

Double-puppeting
Some bridges support the commands "login-matrix" and "logout-matrix". These handle the double-puppeting feature which is used for example to automatically accept new chats from third party messangers like WhatsApp by the bridge. The feature is activated from the beginning so you don't have to manually run them. In case you did a logout-matrix you will have to run "login-matrix TOKEN" to activate double-puppeting again. You can receive a token via the Element UI in the preferences dialog > help. (read more)

Bridge name Bot name Prefix
e2be Description

Discord

@discordbot:frei.chat !discord


Establishing a connection to Discord is a bit tricky.
Click here for more information.

Google Chat

@googlechatbot:frei.chat
!gc


Login via: login-cookie
More information here.
Google Messages @gmessagesbot:frei.chat !gm

 

Login via: login
Instagram
@metainstagrambot:frei.chat !ig

 

Login via: !ig login
LinkedIn @linkedinbot:frei.chat !li

 

Login via:
login YOUR_LINKEDIN_EMAIL_ADDRESS
Messenger (Facebook)
@metamessengerbot:frei.chat !fb

 

Login via: !fb login
(Use messenger.com for login)
Signal @signalbot:frei.chat
!signal

 

Login via: !signal login
Skype @skypebridgebot:frei.chat !skype

 

Login via:
login USERNAME PASSWORD
Slack @slackbot:frei.chat

 

How to use
Telegram @telegrambot:frei.chat !tg

 

Login via: login
Whatsapp @whatsappbot:frei.chat !wa

 

Login via: login

Example help for WhatsApp bot

Command "help":

  • help - Prints this help
  • version - View the bridge version
  • login - Link the bridge to your WhatsApp account as a web client
  • logout - Unlink the bridge from your WhatsApp account
  • delete-session - Delete session information and disconnect from WhatsApp without sending a logout request
  • reconnect - Reconnect to WhatsApp
  • disconnect - Disconnect from WhatsApp (without logging out)
  • ping - Check your connection to WhatsApp.
  • set-relay - Relay messages in this room through your WhatsApp account.
  • unset-relay - Stop relaying messages in this room.
  • login-matrix - Replace your WhatsApp account's Matrix puppet with your real Matrix account.
  • ping-matrix - Check if your double puppet is working correctly.
  • logout-matrix - Switch your WhatsApp account's Matrix puppet back to the default one.
  • toggle <presence|receipts|all> - Toggle bridging of presence or read receipts
  • list <contacts|groups> [page] [items per page] - Get a list of all contacts and groups.
  • search - Search for contacts or groups.
  • sync <appstate/contacts/groups/space> [--create-portals] - Synchronize data from WhatsApp.
  • open <group JID> - Open a group chat portal.
  • pm - Open a private chat with the given phone number.
  • invite-link [--reset] - Get an invite link to the current group chat, optionally regenerating the link and revoking the old link.
  • resolve-link - Resolve a WhatsApp group invite or business message link.
  • join - Join a group chat with an invite link.
  • create - Create a group chat.
  • set-pl [user ID] - Change the power level in a portal room. Only for bridge admins.
  • delete-portal - Delete the current portal. If the portal is used by other people, this is limited to bridge admins.
  • delete-all-portals - Delete all portals.

Inviting a bot, example WhatsApp

  1. Create a new unencrypted room (don't publish it to the room directory!)
  2. Invite the WhatsApp bot (/invite @whatsappbot:frei.chat)
  3. RUn the command login to start the WhatsApp login process
  4. Scan the qr code that should be presented in the channel
  5. The connection should be established

If you face any problems you can find more information here.

Synchronize contacts, example WhatsApp

The connection to WhatsApp is managed by a bot. In order to achive a connection it has to store contact information like the display name and telephone number. frei.chat will make everything possible to secure youre data of unrestricted access.

Private chat with a contact, example WhatsApp

To start a private chat with a WhatsApp contact you have to go to the room you have created with the WhatsApp bot. Run the command pm TELEFONE_NUMBER and a new chat window will open. The WhatsApp contact will be invited automatically. Keep in mind that this chat is unencrypted, too, due to limitations of the WhatsApp bot!

Bridging rooms

You can also bridge a Matrix room to a WhatsApp room to have a conversation to more than one person at a time. See the "create" command.