Google Chat bridge

The Google Chat bridge installed by us is powered by mautrix-googlechat.

• Full documentation
• Source code
• Support

Usage¶

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

Invite the bot to a management room¶

First, please start a chat with @googlechatbot:your-server.com to create a management room. You can do so by inviting the bot to a room like below.

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 conduct authentication, please follow the steps below.

1. Log into the Google Chat in private/incognito browser window
2. Press F12 to open developer tools
3. Select the Application (Chrome, Safari, Edge) or Storage (Firefox) tab
4. In the sidebar, expand Cookies and select https://chat.google.com
5. In the cookie list, find the COMPASS, SSID, SID, OSID and HSID rows
6. Form a JSON object with the extracted cookies as below:

   {
     "compass": "dynamite-ui=...",
     "ssid": "...",
     "sid": "...",
     "osid": "...",
     "hsid": "..."
   }
   

7. Close the browser window to prevent the cookies from being invalidated
8. Send login-cookie to the bridge bot on the client
9. Send the JSON object

After logging in, the bridge will create portal rooms for recent chats. Portal rooms for other chats will be created as you receive messages.

Useful commands¶

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