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 |
@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 |
@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
- Create a new unencrypted room (don't publish it to the room directory!)
- Invite the WhatsApp bot (
/invite @whatsappbot:frei.chat
) - RUn the command
login
to start the WhatsApp login process - Scan the qr code that should be presented in the channel
- 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.