-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Rewamp Slack-bridge and it's instructions
- Loading branch information
Showing
1 changed file
with
8 additions
and
28 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |