BacklogのSlack連携
BacklogのSlack連携を使うと次のことができます。
- Slack上でBacklogの課題を作成する
- Backlogの課題についての更新をSlack上でリアルタイムに受け取る
目次
目次
Slack連携の設定
管理者・プロジェクト管理者が、Slack連携を設定できます。
Slack連携を利用するには「プロジェクト設定」→「インテグレーション」→「Slack」とメニューから選択して進んでください。
Slack連携の一覧
「Slack連携の一覧」では登録済みの連携一覧を確認できます。 また、連携の追加や、編集、削除もこの画面から行えます。
Slack連携の追加
「Slack連携の一覧」から「Slackインテグレーションを追加する」をクリックすると追加画面が表示されます。
- 初回の連携時は「ワークスペースを追加」を押してSlack側の認証を行ってください
2回目以降は追加したワークスペースを選択するか新しいワークスペースを追加してください - 通知を指定するSlackのチャンネルを選択してください
- 通知するイベントを選択してください
- 「Slackインテグレーションを追加する」をクリックして完了です
- 「言語」は通知時に使われるメッセージの言語設定です。
- 「説明」は説明用のメモにお使いください。連携の動作には影響しません。
設定が完了したら課題を作成したり、課題にコメントしたりしてSlackに通知されることをご確認ください。
Slack連携の編集
「Slack連携の一覧」から変更したい設定の「編集」をクリックしてください。
変更したい内容を入力し「保存」をクリックすると編集が完了します。
ワークスペースとチャンネルは変更できません。変更したい場合は設定を削除して作り直してください。
Slack連携の削除
「Slack連携の一覧」から削除したい設定の「編集」をクリックしてください。
「削除」をクリックすると設定が削除されます。
Backlogアプリの操作
Slack連携は、Backlogアプリのコマンドを使って操作できます。
Backlogアプリで使用できるコマンドは次のとおりです。
コマンド | 設定 |
/backlog add | Backlogに課題を追加する |
/backlog link | Backlogに接続する |
/backlog settings | Backlogからあなた宛のお知らせ通知を設定する |
/backlog logout | ログイン中のBacklogアカウントをログアウトする |
/backlog help | ヘルプを表示する |
課題を追加
SlackからBacklogの課題を作成できます。
課題の追加の開始方法は3つあります。いずれを使っても課題追加の手順は同じです。
- 「/backlog add」というスラッシュコマンドをメッセージに入力する
- 「Add issue」というグローバルショートカットを使って開始する
- 「Add issue」というメッセージショートカットを使って開始する
- 「Backlogに課題を追加」のポップアップが起動するので、プルダウンリストからプロジェクトを選択する
- 課題情報を入力し、「課題を追加」ボタンをクリックする
- 課題が追加された場合、課題追加のメッセージがBacklogアプリから送信されます
課題を編集したい場合、「Backlogで課題を表示」ボタンをクリックしてBacklog上で課題を編集してください。
プロジェクトのプルダウンリストは操作するユーザーが参加しているプロジェクトのみ表示されます。
また、必須設定のカスタム属性を使用しているプロジェクトでは課題の追加ができないため、プルダウンリストにプロジェクトは表示されません。
Backlogから通知を受け取る
「/backlog link」というスラッシュコマンドをメッセージに入力して、Slack上でBacklogの各プロジェクトの通知を受け取るための設定ができます。通知を受け取るにはBacklogのプロジェクトと接続します。
- メッセージに「/backlog link」と入力して送信する
- プルダウンリストからプロジェクトを選択する
- プロジェクトの接続済み一覧が更新され、表示されます
接続を解除する場合はプロジェクトの右の「解除」ボタンをクリックします。
解除するとそのプロジェクトが表示されなくなります。
プルダウンリストには操作するユーザーが管理者(管理者もしくは対象のプロジェクトのプロジェクト管理者)で、かつ参加中のプロジェクトのみ表示されます。
そのため管理者になっていない、またはプロジェクトに参加していないプロジェクトはプルダウンリストには表示されません。
あなた宛のお知らせを受信する
Backlogのグローバルバーに届くお知らせをBacklogのSlackアプリのダイレクトメッセージで受信できます。
- メッセージに「/backlog settings」と入力し送信する
- 表示される以下のメッセージで「有効にする」ボタンをクリックする
- 受信を止めたい場合は、「無効にする」ボタンをクリックする(有効になっている場合表示されます。)
- 受信を止めたい場合は、「無効にする」ボタンをクリックする(有効になっている場合表示されます。)
Backlogで「あなた宛てのお知らせ」が届くたび、SlackのBacklogアプリからダイレクトメッセージとして通知が届きます。
認証
ログイン
認証の必要な操作をすると、認証していない場合にログインを促すメッセージが表示されます。
その場合は、Backlogへのログインを行ってください。
- 「ログイン」ボタンをクリックする
- Slackワークスペースにアクセスを許可する画面が開くことがありますので、その画面が表示された場合は「許可する」ボタンをクリックします
- Backlogのスペース情報を入力する画面が開きますので、必要な情報を入力し、「次へ」ボタンをクリックします
- SlackからBacklogにアクセスを許可する画面が開きますので、「許可する」ボタンをクリックします
- 認証の完了画面が表示されます
認証が完了したら「Slackを開く」ボタンをクリックするか、画面を閉じてください。
Slackの画面の左にあるAppの「Backlog Review」でログインに成功したことを確認してください。
ログアウト
メッセージに「/backlog logout」と入力して送信するとSlackからログアウトされます。
ヘルプ
メッセージに「/backlog help」と入力して送信するとスラッシュコマンドの一覧が表示されます。
・「課題を追加」「接続されたプロジェクトを管理」のボタンも用意されており、それぞれのボタンから機能にアクセスできます。
・「ヘルプセンター」のリンクから本コンテンツを確認できます。