Slack

Bordio for Slack переносит работу туда, где и так идёт разговор: личные уведомления в личку, развёрнутые превью ссылок Bordio и задачи, которые можно создать и изменить прямо из сообщения.

Что вы получаете

Уведомления — личное сообщение, когда на вас назначили задачу, перенесли встречу, оставили комментарий и так далее. Что именно приходит — выбираете вы.
Превью ссылок — вставленная ссылка Bordio разворачивается в карточку со статусом, исполнителями и датами.
Действия над задачей — завершить задачу, сменить статус или исполнителя прямо на карточке.
Создание задач — /bordio add или превращение любого сообщения Slack в задачу.
Синхронизация тредов — ответы в треде под превью становятся комментариями к задаче, и наоборот.

Настройка в три шага

Настройка идёт на трёх уровнях, и каждый открывает свою часть интеграции.

1. Установить приложение (один раз, администратором)

Тот, у кого есть право управлять организацией, ставит Bordio в ваш Slack.

В Bordio откройте Настройки организации → Интеграции.
На карточке Slack нажмите Add to Slack.
Slack спросит, в какое рабочее пространство ставить, и покажет запрашиваемые права. Подтвердите — вас вернёт в Bordio, а на карточке появится подключённое рабочее пространство Slack.

Одно рабочее пространство Slack принадлежит ровно одной организации Bordio. Если выбранное вами уже подключено в другом месте, сначала отключите его там. Обратное разрешено: у одной организации Bordio может быть несколько подключённых рабочих пространств Slack.

2. Подключить свой аккаунт (каждый за себя)

Установка приложения не говорит Bordio, кто из пользователей Slack — это вы. Пока вы не подключили свой аккаунт, личные сообщения вам не приходят, а действия из Slack не работают.

В Slack выполните:

/bordio connect

Нажмите кнопку в ответе, войдите в Bordio как обычно — единый вход и двухфакторная аутентификация работают штатно — и подтвердите подключение. Bordio ответит в Slack, а вкладка браузера вернёт вас в приложение.

Можно начать и с превью: вставьте ссылку Bordio в канал, и если вы ещё не подключены, бот пришлёт в личку кнопку подключения.

3. Добавить Bordio в каналы, где вы работаете

Первых двух шагов уже достаточно для большей части интеграции: задачи создаются из любого места Slack, а ссылки Bordio разворачиваются в карточки в любом разговоре. Но две вещи требуют, чтобы приложение состояло в канале, — публикация в приватный канал и чтение ответов в треде.

В канале выполните:

/invite @Bordio

Либо откройте вкладку Integrations у канала и добавьте приложение там. Bordio коротко подтвердит это сообщением — с этого момента в канале работает всё.

Что получится в зависимости от того, где вы находитесь:

Где вы находитесь	Задача создаётся	Превью ссылок	Карточка от `/bordio add`	Ответы в треде → комментарии
Публичный канал, приложение не добавлено	Да	Да	Да	Нет
Приватный канал, приложение не добавлено	Да	Да	Нет — Bordio объяснит, почему	Нет
Любой канал, приложение добавлено	Да	Да	Да	Да
Личная или групповая переписка	Да	Да	Нет, и это не исправить	Нет

Из этой таблицы стоит запомнить четыре вещи.

Превью ссылок не требуют приложения в канале. Bordio регистрирует свои адреса в Slack, и Slack разворачивает ссылки на них по всему рабочему пространству. Это единственная часть, которая работает вообще без настройки на уровне канала.

А вот ответы в треде — требуют. Сообщения Slack передаёт приложению только из тех разговоров, где оно состоит. Поэтому в канале без Bordio карточка может лежать прямо перед глазами, а ответы под ней не доходят никуда. Никакого предупреждения при этом не будет — ответ просто останется сообщением Slack.

Приватный канал скрыт от приложений целиком. Пока Bordio не пригласили, он не может туда написать: задача от /bordio add всё равно создаётся, и Bordio сообщает — прямо в этом канале, видимо только вам, — что карточке некуда было попасть.

Личные и групповые переписки остаются недоступны. Slack не даёт добавить приложение в чужой разговор, поэтому карточки от /bordio add там не появятся, а ответы не синхронизируются. Ссылки при этом разворачиваются, и сама задача создаётся как обычно.

Какие права запрашивает Bordio

Право	Зачем
Отправлять сообщения, в том числе в публичные каналы	Личные уведомления и ответы на ваши команды
Открывать личные сообщения	Доставка этих уведомлений вам
Читать и писать превью ссылок	Разворачивание ссылок Bordio в карточки
Слэш-команды	`/bordio add`, `connect`, `disconnect`, `status`
Читать сообщения в публичных и приватных каналах	Перенос ответов в треде под превью в комментарии к задаче
Читать основные данные профиля	Показать, какой аккаунт Slack подключён, и назвать по имени упомянутых в треде

Доступ к вашей личной переписке и групповым личным чатам Bordio не запрашивает — треды там не синхронизируются.

Bordio действует только на ответы в тредах под собственными карточками. Всё остальное в канале игнорируется: не сохраняется и до задач не доходит. А в канал, куда приложение не добавили, Slack о сообщениях вообще не сообщает.

Слэш-команды

Команда	Что делает
`/bordio connect`	Подключить аккаунт Slack к аккаунту Bordio
`/bordio status`	Показать, подключён ли аккаунт и к кому
`/bordio disconnect`	Отключить аккаунт и прекратить личные сообщения
`/bordio add <текст>`	Открыть форму создания задачи с подставленным заголовком

Как отключить

Свой аккаунт. Выполните /bordio disconnect в Slack либо откройте Настройки профиля → Интеграции → Подключённые аккаунты в Bordio и отзовите подключение Slack. Результат одинаковый: личные сообщения прекращаются, действия из Slack перестают работать до повторного подключения. В задачах и комментариях ничего не удаляется.

Всю интеграцию. В разделе Настройки организации → Интеграции отключите рабочее пространство Slack. Превью, уведомления и команды прекращаются для всех в этом Slack. Интеграцию можно подключить снова позже.

Удаление приложения Bordio на стороне Slack приводит к тому же: Bordio это замечает, помечает интеграцию как потерявшую доступ и предлагает переподключить.

Дальше

Уведомления — что до вас доходит
Задачи в Slack — превью, действия, создание задач, треды
Что делать, если не работает