Webhook

Webhook は、スケジュールされたエクスポートが完了したときに外部システムへ通知します。Exportelier Automation アプリが提供し、サイト管理者が Webhook 配信を有効にするまで無効のままです。

利用できる Webhook の種類

• Slack 着信 Webhook — エクスポートの概要を通常のチャネルメッセージとして投稿します。
• Microsoft Teams ワークフロー Webhook — お客様が作成した Teams ワークフローを介して Adaptive Card 1.2 を投稿します。

種類、マスクされた参照、ステータスを表示する Webhook エンドポイント設定。

Webhook はリンクを送りますが、Slack や Teams にファイルをアップロードしません

Webhook が生成された PDF、DOCX、Markdown ファイルをプロバイダーのメッセージに添付することはありません。既定では、1 件の課題を対象とするスケジュール済みエクスポートに Jira 課題へのリンクが含まれます。同じ実行で Jira 添付ファイルターゲットも成功すると、その生成済み添付ファイルへのリンクも含まれます。どちらのリンクも Jira 内にあり、受信者には対応する Jira アクセス権が必要です。

メッセージの内容

どちらのチャネルにも同じ概要行が送信されます。

Exportelier export "Weekly sprint report": sprint-report-2026-09-01.pdf (14 issues)

• Slack は概要に続き、利用可能な場合はクリック可能な Jira 課題を開く と ドキュメントを開く のリンクを受け取ります。
• Teams は見出しが Exportelier export: <スケジュール名>、本文が同じ概要行の Adaptive Card 1.2 と、利用可能な場合は対応する OpenUrl アクションを受け取ります。

複数課題のエクスポートでは Jira 課題リンクは省略されます。Jira 添付ファイルターゲットが先に成功しない限り、ドキュメントリンクも省略されます。エンドポイントの テスト メッセージではドキュメントのエクスポートも添付も行われないため、どちらのリンクも含まれません。

セットアップ

どちらのチャネルも手順は同じ 3 段階です。配信を一度有効にし、エンドポイントを登録し、スケジュールで選択します。

1. Webhook 配信を有効にする

Exportelier Automation で 設定 → 外部配信 を開き、Webhook 配信を有効化 をオンにします。確認ダイアログが表示されます。これは、データが Atlassian の外に出ることをサイト管理者が明示的に承認する箇所です。

このトグルがオフの間は、すべてのスケジュールで配信ターゲット Webhook がグレー表示のままとなり、何も送信されません。

2a. Slack 着信 Webhook を登録する

Slack は着信 Webhook の URL を Slack アプリ経由で発行します。

1. api.slack.com/apps を開き、Create New App → From scratch を選択します。名前（例: Exportelier）を付け、対象のワークスペースを選択します。
2. アプリのサイドバーで Incoming Webhooks を開き、Activate Incoming Webhooks をオンにします。
3. Add New Webhook to Workspace をクリックし、通知を受け取るチャネルを選択して Allow で確定します。
4. 生成された Webhook URL をコピーします。形式は https://hooks.slack.com/services/T…/B…/… です。パスワードと同様に扱ってください。これを持っている人は誰でもそのチャネルに投稿できます。
5. Exportelier Automation で 設定 → Webhook エンドポイント を開き、チャネル を Slack 着信 Webhook にし、URL を エンドポイント に貼り付けて エンドポイントを追加 をクリックします。

Exportelier はホストが hooks.slack.com の HTTPS URL のみを受け付けます。メッセージは作成した Slack アプリの名前とアイコンで表示されます。いずれも Slack の Basic Information → Display Information で変更できます。

Workflow Builder のトリガー URL は使えません

Slack Workflow Builder も hooks.slack.com の URL を発行しますが、形式は https://hooks.slack.com/triggers/… で、text フィールドではなくそのワークフローの名前付き変数を想定しています。Exportelier のホスト検査はこうした URL も受け付けますが、チャネルには読めるメッセージが表示されません。上記のとおり Slack アプリの着信 Webhook（/services/…）を使用してください。

2b. Microsoft Teams ワークフロー Webhook を登録する

Microsoft は 2026 年 5 月に Office 365 コネクタ Webhook を廃止しました。そのため Exportelier が新規に受け付ける Teams エンドポイントは Microsoft Teams Workflows 由来のものだけです。

1. 対象の Teams チャネルで その他のオプション (…) → Workflows を開きます。
2. Send webhook alerts to a channel を選択します。これが Anyone テンプレートです。ワークフローを一から作成する場合は、トリガー When a Teams webhook request is received を選び、認証タイプを Anyone に設定します。
3. ワークフローの所有者となる Microsoft アカウントで認証し、チームとチャネルを選択してワークフローを追加します。Microsoft によれば、これらの Teams Webhook テンプレートにプレミアムライセンスは不要です。
4. 生成された URL をコピーします。パスワードと同様に扱ってください。この署名付き URL を持つ人は誰でもワークフローを起動できます。
5. Exportelier Automation で 設定 → Webhook エンドポイント を開き、チャネル を Microsoft Teams ワークフロー Webhook にし、URL を エンドポイント に貼り付けて エンドポイントを追加 をクリックします。

サポートされる URL は environment.api.powerplatform.com または logic.azure.com のサブドメイン上の HTTPS です。Exportelier は OAuth ヘッダーを送信しません。秘密の Anyone URL がリクエストを認可します。

メッセージは Microsoft の既定の Workflows ボット ID で表示されます。これらの Webhook 投稿では、Microsoft はカスタムのボット名やアイコンをサポートしていません。

廃止された Office 365 コネクタ

保存済みの *.webhook.office.com エンドポイントは、スケジュールが黙って変更されないように 対応が必要 として表示されたままになります。新しいワークフローエンドポイントを作成してテストし、影響を受けるすべてのスケジュールを更新してから、レガシーエンドポイントを削除してください。レガシーエンドポイントは新規スケジュールでは選択できず、リクエスト送信前にローカルで失敗します。

2c. エンドポイントを検証する

登録済みの各エンドポイントには テスト ボタンがあります。次の固定メッセージを送信します。

Exportelier test message: this webhook endpoint is configured correctly. No export was generated.

送信はスケジュール実行と同じ Egress ゲート、同じ保存済みシークレット、同じペイロードビルダーを通ります。そのためテストの成功は URL の形式だけでなく配信経路そのものを裏付けます。成功すると行に 配信済み が表示され、失敗した場合は理由がテーブルの上に表示されます。理由は下のトラブルシューティング一覧と同じものです。

Webhook 配信がオフの間、このボタンは無効です。何も送信されないためです。

3. スケジュールでエンドポイントを選択する

スケジュール を開き、通知したいスケジュールを編集して配信ターゲット Webhook を追加します。チャネル を選び、次に 保存済みエンドポイント を選択します。エンドポイントはマスクされた参照で一覧表示されます。URL そのものは保存後にブラウザーへ返されないためです。

2 つのリンクオプションは既定で有効で、個別に無効化できます。1 つのスケジュールで複数のターゲットを組み合わせられます。同じ実行でドキュメントを Jira 課題に添付しつつ、Webhook 通知を投稿できます。ドキュメントリンクを要求する Webhook より先に添付ターゲットが完了し、表示順には依存しません。

トラブルシューティング

すぐに届かない。 Exportelier Automation は 5 分ごとに実行予定のスケジュールを確認するため、配信は設定時刻から最大 5 分遅れることがあります。実行を待たずにエンドポイントを確認するには、設定 → Webhook エンドポイント にある テスト ボタンを使用してください。スケジュール実行と同じメッセージが返されます。

直近の実行結果を確認してください。 スケジュール 一覧には 前回の実行 列があり、成功、一部成功、実行に失敗 のステータスと失敗理由が表示されます。ドキュメントは生成できたが Webhook を投稿できなかった実行は 一部成功 として報告されます。

メッセージ	意味
Webhook 配信は管理者によって無効化されています。	設定 → 外部配信 の Webhook 配信を有効化 がオフです。
Webhook エンドポイントが設定されていません。	スケジュールがまだ参照している間に、保存済みエンドポイントが Exportelier で失効されました。再登録し、スケジュールで選び直してください。
保存されたシークレットがこの Webhook チャネルと一致しません。	対応するエンドポイントを選ばずに、スケジュールのチャネルをもう一方のプロバイダーへ切り替えました。
Webhook エンドポイントがリクエストを拒否しました。	プロバイダーがエラーを返しました。通常は Slack で失効した Webhook、または無効化・削除された Teams ワークフローです。プロバイダー側で新しいエンドポイントを作成してください。
Slack の Webhook には hooks.slack.com の https URL を使用する必要があります。	保存時に URL が拒否されました。Slack アプリの Incoming Webhooks ページからコピーし直してください。
この Microsoft Teams コネクタはサポートされなくなりました。	廃止された *.webhook.office.com コネクタです。上記のとおりワークフローエンドポイントに置き換えてください。

チャネルには何も届かないのに実行は成功と表示される。 Slack も Teams も、メッセージが描画される前に 200 を返します。Webhook が想定どおりのチャネルに紐づいているかを確認してください。Slack では Incoming Webhooks、Teams では Workflows で確認できます。

信頼性とセキュリティ

• Webhook 配信は既定でオフであり、管理者による明示的な確認が必要です。
• エンドポイント URL は暗号化された Forge シークレットとして保存され、保存後にブラウザーへ返されることはなく、マスクされた参照としてのみ表示されます。チケット、スクリーンショット、ログに記載してはいけません。
• リンクオプションを有効にすると、Jira サイトのアドレスと、1 件の課題を対象とするエクスポートでは課題キーが外部プロバイダーへ送信されます。生成される URL に認証情報や署名付きクエリパラメーターは含まれず、引き続き Jira の認証と権限が必要です。
• リクエストは 10 秒でタイムアウトし、ネットワーク障害、HTTP 429、5xx の場合のみ 1 回だけ再試行されます。4xx 応答は最終的なもので、再試行されません。
• HTTP 200 や 202 を含むプロバイダーからの成功応答により、ターゲットは配信済みとしてマークされます。

送信トラフィックの分離についてはセキュリティアーキテクチャを、プログラムからの起動については API ページを参照してください。