Skip to content

Commit

Permalink
Rewamp Slack-bridge and it's instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
olmari authored Aug 13, 2024
1 parent 9b49758 commit 2c0614d
Showing 1 changed file with 8 additions and 28 deletions.
36 changes: 8 additions & 28 deletions src/matrix/slack.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,17 @@
# Matrix<->Slack bridge

## Mautrix-slack:
Mautrix-slack (puppeting bridge, channel bridging is not available), Mautrix-slack is recommended for new setups, Appservice-slack is deprecated.

Up to date info about Mautrix-slack itself: <https://docs.mau.fi/bridges/go/slack/index.html>

## What?

An Matrix<->Slack bridge for individial using Slack through Matrix.
## What:
An puppeting Matrix<->Slack bridge for receiving and sending Slack messages with Matrix-client, has relaybot possibility.

## Set up
- General setup finds from: <https://docs.mau.fi/bridges/go/slack/authentication.html>
- Ask details Matrix-channel: `#general:hacklab.fi` if unsure.

## Appservice-slack (deprecated)

Up to date info about matrix-appservice-slack itself: <https://github.com/matrix-org/matrix-appservice-slack>

## What?

An Matrix<->Slack bridge for bridging Slack-room to Matrix-room; puppets Slack-users to Matrix and for Slacks side an relaybot mimicks Matrix-user as Slack user. Also medias (mostly pictures tested) will work too. This is deprecated.
- Start a chat with the bridge bot `@slackbot:hacklab.fi`. The bot should say "This room has been registered as your bridge management/status room." if you started the chat correctly.
- Write `help` to see all commands and options available to you.
- Write `login` to the room.
- Follow on-screen instuctions
- If something doesn't work, up to date details finds from: <https://docs.mau.fi/bridges/go/slack/authentication.html>

### Double puppeting (recommended)

You can replace the Matrix puppet of your Slack account with your Matrix account. When you do so, messages that you send from other Slack clients will be sent from your Matrix account instead of the default puppet user.

How to get virgin Access-token: Use <https://gitlab.com/vurpo/matrix-login/> for currently most effortless method.

As with the Slack account login, you must do this in a private chat with the bridge bot.

- Log in with `login-matrix <access token>`
- After logging in, the default Matrix puppet of your Slack account should leave rooms and your account should join all rooms the puppet was in automatically.

## Note

Info taken and adapted to our use from [Mautrix-slack wiki](https://docs.mau.fi/bridges/python/slack/authentication.html), so in case of info gets outdated, try refer there.
For hacklab.fi homeserver users this bridge does double-puppeting automatically.

0 comments on commit 2c0614d

Please sign in to comment.