Привязать аккаунт Slack

В этом руководстве описано, как привязать свою идентичность в чате к пользователю Control Center и как отвязать её.

Каждый участник делает это по одному разу для каждого провайдера чата. Это отдельно от подключения приложения: подключение делает бота доступным для всего рабочего пространства, а привязка делает вас узнаваемым внутри него.

Почему привязка нужна

Мост отказывается действовать от имени аккаунта чата, который не удаётся сопоставить с участником рабочего пространства. Это сделано намеренно: без привязки каждое сообщение из Slack пришлось бы приписывать тому, кто установил приложение, и журнал аудита, ограничения частоты по субъектам и авторы тикетов указывали бы не того человека.

Непривязанный участник, который упомянет бота, получает ответ в том же треде Slack с объяснением, как привязать аккаунт. Ничего не запускается.

Привязка по коду

Откройте Настройки → Рабочее пространство → Профиль и идентичность и прокрутите до карточки Привязанные аккаунты чата
В блоке Slack нажмите Привязать мой аккаунт Slack
Скопируйте показанную команду, например:

/cc link K7M2QP

В Slack отправьте эту команду боту — проще всего в личных сообщениях
Бот подтверждает, к какому пользователю Control Center вы теперь привязаны, и диалог, который вы оставили открытым, в тот же момент обновляется и сообщает об этом — закрывать его и проверять не нужно

Код:

Одноразовый: истекает через 15 минут после создания
Всегда создаётся для вас, а не для коллеги
Заменяет уже имеющийся у вас код, поэтому повторное нажатие кнопки делает предыдущий недействительным
Хранится только в памяти, поэтому перезапуск сервера делает выданные коды недействительными — нажмите кнопку ещё раз

Код, который неизвестен, просрочен или создан для другого рабочего пространства, завершается неудачей одинаково неразличимо: «that code is not valid (or has expired)».

Автоматическая привязка по email

Если в вашем профиле Slack указан подтверждённый email, который совпадает с пользователем Control Center, уже являющимся участником этого рабочего пространства, мост привяжет вас при первом же обращении к нему. Код не нужен.

Важны обе половины: совпадение email доказывает идентичность, но доступ даёт только членство, поэтому посторонний, чей email случайно существует на сервере, ни к чему не привязывается. В списке указано, как была создана каждая привязка («сопоставлено по email» или «привязано по коду»).

Автоматической привязке нужна область users:read.email. Без неё Slack не раскроет адрес, и единственным путём останется привязка по коду.

Кто привязан

Список относится к администрированию рабочего пространства, поэтому он находится в другой половине интерфейса: Настройки → Рабочее пространство → Основные → Чат-мосты → Привязанные аккаунты. В нём перечислены все привязанные участники рабочего пространства с указанием аккаунта Slack, которому соответствует каждый из них, и способа создания привязки.

Ваше собственное состояние — на странице профиля: строка Привязать мой аккаунт Slack после привязки показывает «Привязан к your-slack-id», а пока привязки нет — предлагает её создать.

Список — это живая подписка, потому что изменение происходит на другой стороне: код вводите вы в Slack, и никакой запрос из приложения не может принести ответ обратно.

Отвязка

Нажмите Отвязать в строке списка рабочего пространства.

Любой может отвязать себя
Отвязать другого участника может только администратор
Отвязка также отзывает любой выданный код привязки этого участника

После отвязки этот аккаунт Slack больше не может управлять агентами, пока не привяжется снова. Существующие пространства, транскрипты и тикеты сохраняют прежнюю атрибуцию — отвязка не отменяет прошлую работу.

Устранение неполадок

Бот говорит, что я не участник этого рабочего пространства

Ваш аккаунт Slack привязан к пользователю Control Center, но у этого пользователя нет членства в данном рабочем пространстве. Попросите администратора пригласить вас; см. Совместная работа — идентичность, членство и присутствие.

Бот говорит, что моя роль доступна только для чтения

Роли viewer и guest не могут запускать работу. Администратор должен повысить вашу роль до member или выше.

Slash-команда не распознаётся

Проверьте, что эта slash-команда существует в Slack и что вы отправляете ту команду, которую показал диалог настроек, — администратор мог её переименовать, и тогда диалог показывает текущее имя.