新しい課題が追加されたら(トリガー)

このピースでできること

  • Backlog の指定したプロジェクトに新しい課題が追加されたときに、フローを自動で起動します。
  • 課題の起票を検知して、通知や他システムへの登録を自動化できます。
  • 課題の「更新」や「コメント」も検知したい場合は、「課題が追加または更新されたら」を使ってください。
💡
Webhook はフローを有効にすると Backlog 側に自動で登録され、フローを無効にすると自動で削除されます。Backlog の管理画面で手動設定する必要はありません。

Backlog の接続方法

workrun と Backlog を接続するには、Backlog の ホスト名API キー が必要です。

ステップ 1:ホスト名を確認する

  1. Backlog にログインし、ブラウザのアドレスバーを確認します。
  1. の間の部分がホスト名です。
      • 例: アドレスが の場合、ホスト名は です
      • Backlog のドメインには の2種類があります。自社のスペースのURLに合わせてください

ステップ 2:API キーを発行する

  1. Backlog の画面右上のプロフィールアイコンから 「個人設定」 を開きます。
  1. 左メニューの 「API」 を開きます。
  1. 登録メモに任意の名前を入力し、「登録」 をクリックして API キーを発行します。
  1. 発行された API キーをコピーしておきます。
⚠️
API キーは発行したユーザーの権限で動作します。連携したいプロジェクトにアクセスできるユーザーで発行してください。

ステップ 3:workrun に接続を追加する

  1. workrun で Backlog のアクション/トリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「ホスト名」 フィールドに、ステップ 1 で確認したホスト名を入力します( は不要です)。
  1. 「APIキー」 フィールドに、ステップ 2 でコピーした API キーを貼り付けます。
  1. 「保存」 をクリックして接続を完了します。
💡
Backlog のトリガー(「新しい課題が追加されたら」「課題が追加または更新されたら」)を使う場合、Webhook はフローを有効にすると Backlog 側に自動で登録されます。Backlog の管理画面で手動設定する必要はありません。

ピースの設定項目

1. プロジェクト(必須)

  • 監視するプロジェクトを、一覧から選びます。
  • 接続を選ぶと自動で一覧が読み込まれます。接続を設定していない場合は「認証情報を入力してください」と表示されます。
  • 複数のプロジェクトを監視したい場合は、プロジェクトごとにフローを作成してください。
[設定例]