# Instagram## Features

What the Instagram bridge can do

| Direction              | Feature                                                                  |
|------------------------|--------------------------------------------------------------------------|
| Matrix -> Instagram | Text, formatting, mentions, replies                                      |
| Matrix -> Instagram | Media: voice messages, videos, images                                    |
| Matrix -> Instagram | Message redactions, reactions, edits                                     |
| Matrix -> Instagram | Typing notifications and read receipts                                   |
| Matrix -> Instagram | Room name and avatar changes                                             |
| Instagram -> Matrix | Text, formatting, mentions, replies                                      |
| Instagram -> Matrix | Media: images, videos, GIFs, stickers, voice messages                    |
| Instagram -> Matrix | Story, reel, and clip shares                                             |
| Instagram -> Matrix | Message unsend, reactions, edits                                         |
| Instagram -> Matrix | Message history                                                          |
| Instagram -> Matrix | Typing notifications and read receipts                                   |
| Instagram -> Matrix | Membership: add, remove, leave                                           |
| Instagram -> Matrix | Chat metadata: title and avatar                                          |
| Instagram -> Matrix | User metadata: name and avatar                                           |
| Misc                   | Multi-user support                                                       |
| Misc                   | Shared group chat portals                                                |
| Misc                   | End-to-end encryption (Matrix and Messenger)                             |
| Misc                   | Automatic portal creation at startup, when added to chat, on new message |
| Misc                   | Private chat creation by inviting Matrix puppet of Instagram user        |
| Misc                   | Double puppeting for messages sent from other Instagram clients          |

## Usage

Start a chat with `@instagrambot:your-server.com`. When it joins, type `help` in the chat to see instructions.

01. **Send a `login` message to the bridge bot**. The bot will reply with a link to its official [Authentication](https://docs.mau.fi/bridges/go/meta/authentication.html) instructions. **Ignore this** message. Our instructions below are similar, but simpler.
02. **Open a private window in your browser** ([Firefox](https://www.mozilla.org/en-US/firefox/new/) or any [Chromium](https://www.chromium.org/chromium-projects/)-based browser like [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/en-us/edge), [Brave](https://brave.com/), etc.). It’s important to use a private window, because we’d like your new Instagram login session to be separate from your regular session.
03. **Log into [Instagram](https://www.instagram.com/)** as you would usually do.
04. **Open your browser’s Developer Tools**. You can do this by **right-clicking anywhere** on the Instagram page and then clicking on the **Inspect** button. You may also open Developer Tools using a keyboard shortcut: `Ctrl + Shift + K` for Firefox and `Ctrl + Shift + J` for Chromium-based browsers.
05. Click on the **Network** tab in the Developer Tools window. **See a screenshot** of some of the steps below [for Firefox](https://etke.cc/img/bridges/mautrix-meta/firefox-devtools.webp) or [for Chrome](https://etke.cc/img/bridges/mautrix-meta/chrome-devtools.webp).
06. In the **Filter** textbox, enter this text: `graphql`
07. Ensure that the **All** button or the **XHR** button next to the *Filter* textbox **is activated**.
08. **Reload the page** using the reload button in the browser’s toolbar or with the `F5` keyboard shortcut
09. You will **see one or more `graphql/` entries** in the list below the **Filter** textbox
10. **Right-click** on any of the `graphql/` entries, go to the **Copy** submenu and then click the **Copy as cURL** button (for Mac and Linux) or **Copy as cURL (POSIX)** button (for Windows). This copies the `graphql/` request in a [curl](https://curl.se/)-compatible format.
11. **Paste this copied information into your existing chat with the bridge bot** and send the message. The `mautrix-meta` bridge will extract some login [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies) from there. The bot will automatically delete your message to prevent this sensitive information from leaking.
12. **Close the private window WITHOUT logging out**. It’s important that you just close the window without actually logging out of Instagram. Logging out of Instagram will invalidate the login session and the bridge will stop working.


---
* [llms.txt](https://etke.cc/llms.txt): full site index in markdown