Jira Service Management サポート

webhook は、あるアプリケーションが別のアプリケーションに自動化された情報を送信するための方法です。webhook を使用すると、特定のイベントの発生時に重要な情報を伝えることができます。たとえば、優先順位が高い課題が作成されたときにチームリードに SMS を送信できます。

webhook は 2 つの内容で構成されています。

ペイロード – メッセージ自体
URL – メッセージの宛先。この URL は Jira の許可リストに登録されている必要があります。

既定では、HTTP POST リクエストを使用して JSON 形式でペイロードを送信します。

このページの内容

Webhook を Jira Service Management 自動化ルールに追加する

Jira Service Management の webhook は、自動化ルールの THEN アクションです。ルールを設定する際に、WHEN や IF を指定して webhook によってアクションを定義できます。

始める前に

宛先 URL が Jira の許可リストに登録されている必要があります。

Webhook を Jira Service Management 自動化ルールに追加するには、次の手順に従います。

[プロジェクト設定] > [自動化] に進みます。
カスタムルールを作成したり、既存のルールを編集したりします。
必要に応じて WHEN および IF 設定を設定します。
THEN アクションを追加し、ドロップダウンから [webhook] を選択します。
webhook 設定を設定し、ルールに名前をつけて、[保存] を押します。

以下の例は、重大なインシデントが発生したときに Slack にメッセージを投稿する自動化ルールです。

カスタムペイロードを使用した自動化ルールの例。

Jira Service Management の Webhook を設定する方法の詳細については、開発者向けチュートリアルをご参照ください。

ペイロードの本文のオプション

ペイロードのリクエストの本文について、以下の 2 つのオプションのいずれかを選択できます。

空のペイロードの送信 - 情報を必要としないアプリと通信する場合にこのオプションを使用できます。
Jira 課題をペイロードとして送信 - Jira 課題、ユーザー、およびコメントが送信されます。
カスタムペイロードの送信 - 含める変数を選択してペイロードをカスタマイズできます。ペイロードは JSON 形式で指定する必要があります。ペイロードを URL エンコードする場合は [フォームとしてエンコード] チェックボックスを選択します。

Jira Service Management サポート

製品

Jira Software