Google Messages bridge

The Google Messages bridge installed by us is powered by mautrix-gmessages.

• Full documentation
• Source code
• Support

Usage¶

This page shows you how to set up the Google Messages bridge using Cinny client app (available as an add-on component), so that you can receive and send messages between Google Messages and Matrix rooms.

Invite the bot to a management room¶

First, please start a chat with @gmessagesbot:your-server.com to create a management room.

Make sure to replace your-server.com with your actual “base domain”. Setting your-server.com or example.com does not work on your server!

When the bot joins to the created room, it sends confirmation messages to the room as below. If they are visible, bot successfully joined the management room. It works as expected.

Authentication¶

To bridge Google Messages over Matrix, you need to authenticate the bridge’s bot for Google Messages.

To conduct authentication, please follow the steps below.

1. Send login to the bridge bot
2. Open a private window of your web browser
3. Enable the browser devtool
4. Log in to the configuration manager with your Google account
5. Copy the /web/config request as cURL on the browser devtool’s “network” tab
6. Send the curl command (or JSON object) to the bot
7. Open the “Google Messages” application on your phone
8. Tap on the emoji which the bridge bot sent

After logging in, the bridge will create portal rooms for recent chats.

💡 Because all messages are proxied through the phone app, your phone has to be connected to the internet for the bridge to work.

Useful commands¶

If you send a message help to the room, available commands are output as a message like below:

Here is a couple of useful commands:

• create-group [group type]: Create a new group chat for the current Matrix room
• search <query>: Search for users on the remote network
• start-chat [login ID] <identifier>: Start a direct chat with the given user