Microsoft の仕様変更について

Microsoft の仕様変変更により、これまで利用できた下記の Incoming Webhook が非推奨となりました。

Open

現在、この機能の新規利用はできなくなっており、2024/12/31 で機能自体が利用できなくなります。詳細は下記をご参照下さい。

Retirement of Office 365 connectors within Microsoft Teams - Microsoft 365 Developer Blog

このページでは、2024/12/31 以降も利用可能な方法をご紹介します。

Jira から Teams に通知する方法

Jira の通知をメールでなく Microsoft Teams へ送信する方法を、Webhook と自動化の 2 通りご紹介します。

両者の違いとしましては、課題作成、コメントなどのイベントを通知するなら Webhook の方が設定が簡単です。メッセージを工夫したり、メッセージを出力する条件を制御するなど柔軟性があるのが Jira Automatiton となります。

Webhook による通知

Microsoft Teams に Jira Cloud アプリをインストールする

１．通知を受け取りたいチャンネルで「チャンネルを管理」をクリックします。

Open

２．モデレート欄で「チャンネルのモデレーション」を ON にし、「コネクターにチャンネルメッセージの投稿を許可する」にチェックを入れます。

３．コネクタ欄で「編集」をクリックします。

４．”Jira Cloud” を見つけて「Configure」をクリックします。

５．案内に沿って名前を入力し「Create」ボタンを押します。

６．URL が表示されるので保存しておきます。

７．スクロールして内容を確認し、一番下の Done ボタンを押します。

８．下記の様な画面が表示されるので、画面右上のｘボタンで閉じます。

これで、Microsoft Teams の設定は終わりです。

Jira 側で Webhook を設定する

１．歯車マーク > “システム“ > “Webhook“ > “+Webhook の作成“ をクリックします。

２．以下の値を入力します。

３．通知をしたいプロジェクトや課題キーなどを JQL で指定し、通知をしたいイベントを選択してください。
例えば、優先度を JQL で指定することによって優先度の高い課題のみを通知させることが出来ます。

これで、Jira 側の設定は終わりです。

例えば課題の作成をすると、以下のような通知が Teams に届きます。

Jira automation による通知

Microsoft Teams でワークフローを作成する

１．通知を受け取りたいチャンネルで「ワークフロー」をクリックします。

２．ワークフローの一覧で「Webhook 要求を受信するとチャネルに投稿する」を選択します。

３．ワークフローの名前を入力して「次へ」ボタンを押します。

４．下記の画面で「ワークフローを追加する」ボタンを押します。

５．下記の画面が表示されますので、URLを記録して「完了」ボタンを押します。

これで、Microsoft Teams の設定は終わりです。

Jira 側で自動化を設定する

ここでは、課題が割り当てられたときに通知を送る方法を例としてご紹介します。

１．トリガー：フィールド値の変更時

以下の値を入力します。

２．アクション：Microsoft Teams にメッセージを送信

Webhook URL：Teams のステップ５で記録した URL
メッセージタイトル：任意のタイトル
メッセージ：任意のメッセージ。例えば、以下のようにスマート値を利用することが出来ます。
課題の要約をメッセージに含める：チェック

これで、Jira 側の設定は終わりです。

課題がアサインされると、以下のような通知が Teams に届きます。
「Jira で表示」は、該当課題にリンクしています。

参考資料

• Jira の更新通知を Microsoft Teams に通知したい

• Microsoft Teams を統合する

• AUTO-1374 Provide support for Microsoft Workflows in automation rules

• Update on sending Microsoft Teams messages with Atlassian Automation