...
| 情報 |
|---|
Microsoft の仕様変更についてMicrosoft の仕様変変更により、これまで利用できた下記の Incoming Webhook が非推奨となりました。  現在、この機能の新規利用はできなくなっており、2024/12/31 で機能自体が利用できなくなります。詳細は下記をご参照下さい。 このページでは、2024/12/31 以降も利用可能な方法をご紹介します。 |
| 目次 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Jira から Teams に通知する方法
Jira の通知をメールでなく Microsoft Teams へ送信する方法を、Webhook と自動化の 2 通りご紹介します。
両者の違いとしましては、課題作成、コメントなどのイベントを通知するなら Webhook の方が設定が簡単です。メッセージを工夫したり、メッセージを出力する条件を制御するなど柔軟性があるのが Jira Automatiton となります。
Webhook による通知
Microsoft Teams
...
（以下のご案内は Microsoft Teams のクラシックの画面です。新しい画面の場合は若干操作が異なるようです。参照：https://learn.microsoft.com/ja-jp/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=newteams%2Cdotnet ）
１．通知を受け取りたいチャンネルで「チャンネルを管理」をクリックします。
...
に Jira Cloud アプリをインストールする
１．通知を受け取りたいチャンネルで「チャンネルを管理」をクリックします。
...
２．モデレート欄で「チャンネルのモデレーション」を ON にし、「コネクターにチャンネルメッセージの投稿を許可する」にチェックを入れます。
...
３．コネクタ欄で「編集」をクリックします。
...
４．”Jira Cloud” を見つけて「構成」をクリックします。
...
５．案内に沿って名前を入力し「作成」ボタンをクリック、表示される Webhook URLをコピーして「完了」をクリックします。
...
を見つけて「Configure」をクリックします。
...
５．案内に沿って名前を入力し「Create」ボタンを押します。
...
６．URL が表示されるので保存しておきます。
...
７．スクロールして内容を確認し、一番下の Done ボタンを押します。
...
８．下記の様な画面が表示されるので、画面右上のｘボタンで閉じます。
...
これで、Microsoft Teams の設定は終わりです。
Jira 側で Webhook
...
を設定する
１．歯車マーク > “システム“ > “Webhook“ > “+Webhook の作成“ をクリックします。
...
名前：任意の名前 |
|---|
...
３．通知をしたいプロジェクトや課題キーなどを JQL で指定し、通知をしたいイベントを選択してください。
例えば、優先度を JQL で指定することによって優先度の高い課題のみを通知させることが出来ます。
...
例えば課題の作成をすると、以下のような通知が Teams に届きます。
...
Jira automation による通知
Microsoft Teams
...
でワークフローを作成する
１．通知を受け取りたいチャンネルで「チャンネルを管理」をクリックします。１．通知を受け取りたいチャンネルで「ワークフロー」をクリックします。
...
２．モデレート欄で「チャンネルのモデレーション」を ON にし、「コネクターにチャンネルメッセージの投稿を許可する」にチェックを入れます。
...
３．コネクタ欄で「編集」をクリックします。
...
４．”Incoming Webhook” を見つけて「構成」をクリックします。
...
５．適当な名前を入力し、任意でイメージをアップロードしてURL をコピーし、「完了」をクリックします。
...
２．ワークフローの一覧で「Webhook 要求を受信するとチャネルに投稿する」を選択します。
...
３．ワークフローの名前を入力して「次へ」ボタンを押します。
...
４．下記の画面で「ワークフローを追加する」ボタンを押します。
...
５．下記の画面が表示されますので、URLを記録して「完了」ボタンを押します。
...
これで、Microsoft Teams の設定は終わりです。
Jira
...
側で自動化を設定する
ここでは、課題が割り当てられたときに通知を送る方法を例としてご紹介します。
...
２．アクション：Microsoft Teams にメッセージを送信
Webhook URL：Teams のステップ４でコピーした のステップ５で記録した URL
メッセージタイトル：任意のタイトル
メッセージ：任意のメッセージ。例えば、以下のようにスマート値を利用することが出来ます。
課題の要約をメッセージに含める：チェック
| コード ブロック |
|---|
{{issue.key}} が{{issue.assignee.displayname}} に割り当てられました。 |
...
課題がアサインされると、以下のような通知が Teams に届きます。
「Jira で表示」は、該当課題にリンクしています。
...
参考資料
AUTO-1374 Provide support for Microsoft Workflows in automation rules
https://learncommunity.microsoftatlassian.com/t5/jaAutomation-jp/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=newteams%2Cdotnetarticles/Update-on-sending-Microsoft-Teams-messages-with-Atlassian/ba-p/2780258