# Slack## Features

What the Slack bridge can do

| Direction          | Feature                                                       |
|--------------------|---------------------------------------------------------------|
| Matrix -> Slack | Text, formatted messages, user pings                          |
| Matrix -> Slack | Media and file attachments                                    |
| Matrix -> Slack | Edits, threads, replies (as Slack threads)                    |
| Matrix -> Slack | Reactions, typing status, message redaction                   |
| Matrix -> Slack | Mark room as read                                             |
| Slack -> Matrix | Text, formatted messages, user pings                          |
| Slack -> Matrix | Media and file attachments                                    |
| Slack -> Matrix | Edits, threads (as Matrix native threads with fallback reply) |
| Slack -> Matrix | Custom Slack emoji                                            |
| Slack -> Matrix | Reactions, typing status, message deletion                    |
| Slack -> Matrix | Reading pre-login message history                             |
| Slack -> Matrix | Channels (including Slack Connect), group DMs, 1:1 DMs        |
| Slack -> Matrix | Initial metadata: name, topic, description, members           |
| Slack -> Matrix | Topic and description changes                                 |
| Slack -> Matrix | Mark conversation as read                                     |
| Misc               | Automatic portal creation on login and when receiving message |
| Misc               | Creating DM by inviting user to Matrix room                   |
| Misc               | Double puppeting for messages sent from Slack client          |
| Misc               | Shared channel portals between different Matrix users         |
| Misc               | Slack app relay bot mode                                      |

## Usage

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

### Invite the bot to a management room

First, please start a chat with `@slackbot: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!

![Invitation dialog to create a management room](https://etke.cc/help/bridges/mautrix-slack/images/1.webp)

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.

![Confirmation message on the room](https://etke.cc/help/bridges/mautrix-slack/images/2.webp)

### Authentication

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

There is a couple of ways for conducting authentication, and the simplest one is to log in with an authentication token extracted from the Slack app. Please follow the steps below to do so.

💡 Logging in with a password has been deprecated.

1. Login to the Slack web app in a browser, and acquire the authentication token and `d` cookie in the app. The token starts with the `xoxc-` prefix, and can be found with the browser devtools. Look for localStorage inside the `localConfig_v2` object:
   
   *JSON.parse(localStorage.localConfig\_v2).teams.YOUR\_TEAM\_ID\_HERE.token*
2. Send `login token <token> <cookie>` to the bot.

After successfully logging in to the account, the bot will bridge recent chats automatically (depending on the *conversation\_count* setting).

### Useful commands

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

![The output returned after sending help](https://etke.cc/help/bridges/mautrix-slack/images/3.webp)

Here is a couple of useful commands:

- `search <query>`: Search for users on the remote network
- `start-chat [login ID] <identifier>`: Start a direct chat with the given user


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