Logging in
- Open a private chat with the bridge bot. Usually
@facebookbot:your.server
- Send
login <email> <password>
- 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. If that doesn't help, hosting the bridge at home or making it proxy all traffic through a residential IP can help further reduce suspiciousness. The bridge can run separately from Synapse, e.g. on a Raspberry Pi. It can also use the http_proxy environment variable for all Facebook traffic.
Double puppeting
You can replace the Matrix puppet of your Messenger account with your Matrix account. When you do so, messages that you send from other Messenger clients will be sent from your Matrix account instead of the default puppet user.
Double puppeting can only be enabled after logging into your Messenger account. As with the Messenger account login, you must do this in a private chat with the bridge bot.
- Log in on the homeserver to get an access token, for example with the command
curl -XPOST -d '{"type":"m.login.password","identifier":{"type": "m.id.user", "user": "example"},"password":"wordpass","initial_device_display_name":"mautrix-facebook"}' https://example.com/_matrix/client/r0/login
- Send
login-matrix <access token> to the bridge bot.
- After logging in, the default Matrix puppet of your Messenger account should leave rooms and your account should join all rooms the puppet was in automatically.