# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018-2025, Slavi Pantaleev, Aine Etke, MDAD community members
# This file is distributed under the same license as the matrix-docker-ansible-deploy package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: matrix-docker-ansible-deploy \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-01-27 09:54+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:1
msgid "Setting up Appservice Slack bridging (optional)"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:3
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:89
msgid "**Notes**:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:4
msgid "Bridging to [Slack](https://slack.com) can also happen via the [mx-puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and [mautrix-slack](configuring-playbook-bridge-mautrix-slack.md) bridges supported by the playbook."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:5
msgid "Currently (as of November, 2024) **this component is not available for new installation unless you have already created a classic Slack application** (which the bridge makes use of in order to enable bridging between Slack and Matrix), because the creation of classic Slack applications has been discontinued since June 4 2024. The author of the bridge claims [here](https://github.com/matrix-org/matrix-appservice-slack/issues/789#issuecomment-2172947787) that he plans to support the modern Slack application and until then \"the best (and only) option for new installations is to use the webhook bridging\"."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:7
msgid "The playbook can install and configure [matrix-appservice-slack](https://github.com/matrix-org/matrix-appservice-slack) for you."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:9
msgid "See the project's [documentation](https://github.com/matrix-org/matrix-appservice-slack/blob/master/README.md) to learn what it does and why it might be useful to you."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:11
msgid "Prerequisites"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:13
msgid "Create a Classic Slack App"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:15
msgid "First, you need to create a Classic Slack App [here](https://api.slack.com/apps?new_classic_app=1)."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:17
msgid "Name the app \"matrixbot\" (or anything else you'll remember). Select the team/workspace this app will belong to. Click on bot users and add a new bot user. We will use this account to bridge the the rooms."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:19
msgid "Then, click on Event Subscriptions and enable them and use the request url: `https://matrix.example.com/appservice-slack`."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:21
msgid "Add the following events as `Bot User Events` and save:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:23
msgid "team_domain_change"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:24
msgid "message.channels"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:25
msgid "message.groups (if you want to bridge private channels)"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:26
msgid "reaction_added"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:27
msgid "reaction_removed"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:29
msgid "Next, click on \"OAuth & Permissions\" and add the following scopes:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:31
msgid "chat:write:bot"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:32
msgid "users:read"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:33
msgid "reactions:write"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:34
msgid "files:write:user (if you want to bridge files)"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:36
msgid "**Note**: In order to make Slack files visible to Matrix users, this bridge will make Slack files visible to anyone with the url (including files in private channels). This is different than the current behavior in Slack, which only allows authenticated access to media posted in private channels. See MSC701 for details."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:38
msgid "Click on \"Install App\" and \"Install App to Workspace\". Note the access tokens shown. You will need the Bot User OAuth Access Token and if you want to bridge files, the OAuth Access Token whenever you link a room."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:40
msgid "Create an administration control room on Matrix"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:42
msgid "Create a new Matrix room to act as the administration control room."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:44
msgid "Note its internal room ID. This can be done in Element Web by sending a message, opening the options for that message and choosing \"view source\". The room ID will be displayed near the top."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:46
msgid "Adjusting the playbook configuration"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:48
msgid "To enable the bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:64
msgid "Extending the configuration"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:66
msgid "There are some additional things you may wish to configure about the bridge."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:68
msgid "Take a look at:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:70
msgid "`roles/custom/matrix-bridge-appservice-slack/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:71
msgid "`roles/custom/matrix-bridge-appservice-slack/templates/config.yaml.j2` for the bridge's default configuration. You can override settings (even those that don't have dedicated playbook variables) using the `matrix_appservice_slack_configuration_extension_yaml` variable"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:73
msgid "For example, to change the bot's username from `slackbot`, add the following configuration to your `vars.yml` file. Replace `examplebot` with your own."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:80
msgid "Installing"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:82
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:91
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:93
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:95
msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:97
msgid "Usage"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:99
msgid "To use the bridge, you need to send `/invite @slackbot:example.com` to invite the bridge bot user into the admin room."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:101
msgid "If Team Sync is not enabled, for each channel you would like to bridge, perform the following steps:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:103
msgid "Create a Matrix room in the usual manner for your client. Take a note of its Matrix room ID — it will look something like `!qporfwt:example.com`."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:104
msgid "Invite the bot user to both the Slack and Matrix channels you would like to bridge using `/invite @matrixbot` for Slack and `/invite @slackbot:example.com` for Matrix."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:105
msgid "Determine the \"channel ID\" that Slack uses to identify the channel. You can see it when you open a given Slack channel in a browser. The URL reads like this: `https://app.slack.com/client/XXX/<the channel ID>/details/`."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:106
msgid "Issue a link command in the administration control room with these collected values as arguments:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:108
msgid "with file bridging:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:114
msgid "without file bridging:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:120
msgid "These arguments can be shortened to single-letter forms:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:126
msgid "Unlinking"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:128
msgid "Channels can be unlinked again by sending this:"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:134
msgid "Unlinking doesn't only disconnect the bridge, but also makes the slackbot leave the bridged Matrix room. So in case you want to re-link later, don't forget to re-invite the slackbot into this room again."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:136
msgid "Troubleshooting"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:138
msgid "As with all other services, you can find the logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by logging in to the server with SSH and running `journalctl -fu matrix-appservice-slack`."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:140
msgid "Linking: \"Room is now pending-name\""
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:142
msgid "This typically means that you haven't used the correct Slack channel ID. Unlink the room and recheck 'Determine the \"channel ID\"' from above."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:144
msgid "Messages work from Matrix to Slack, but not the other way around"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:146
msgid "Check the logs, and if you find the message like below, unlink your room, reinvite the bot and re-link it again."
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:148
msgid "`WARN SlackEventHandler Ignoring message from unrecognised Slack channel ID : %s (%s) <the channel ID> <some other ID>`"
msgstr ""

#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:150
msgid "This may particularly hit you, if you tried to unsuccessfully link your room multiple times without unlinking it after each failed attempt."
msgstr ""
