Skip to main content

リリース管理における送信ウェブフック

送信Webhookは、特定のイベントが発生したときにBitriseから指定されたURLに自動送信されるメッセージです。リリース管理では、これらのウェブフックを使ってBitriseを外部のサービスやツールと統合し、開発パイプライン全体でシームレスなコミュニケーションと自動化を実現できます

スタンダードプランのみ

発信Webhookをワークスペースに追加できますが、それらを接続するには リリース管理 プロジェクトは、以下の条件を満たすプロジェクトでのみ可能です 標準ライセンス

リリースへの送信Webhookの追加

リリースに送信 Webhook を追加するには、次の 2 つの方法があります。

  • Webhook を個々のリリースに追加します。

  • Webhook をリリースプリセットテンプレートに追加します。そのテンプレートを使用するすべてのリリースは、設定された Webhook を使用します

個人リリース

リリースプリセット

  1. 外部サービスがWebhookリクエストを受信して処理する準備ができていることを確認してください。これには通常、以下が含まれます

    • BitriseからのHTTP POSTリクエストを受信するためのパブリックアクセス可能なURLを作成します。

    • JSON ペイロードの処理:JSON データを解析し、関連情報を抽出します。

    • 受信したイベントに基づいてサービスが実行すべきアクションを定義します。

  2. 送信用ウェブフックの作成 ビットライズで。

  3. オープンリリース管理。

  4. アプリを選択します。

  5. まだ終了していないリリースを選択してください。

    2025-10-29-releases.png
  6. に移動 [構成]

  7. 見つけて 送信用ウェブフック カードとクリック 詳細を表示

    2025-10-29-outgoing-webhooks-rm.png
  8. クリック ウェブフックを追加

  9. からウェブフックを選択してください ウェブフック設定 メニュー。

    2025-10-29-rm-add-outgoing-webhook.png
  10. Webhook をトリガーするイベントを選択します。

    イベントとそのペイロード情報の全リストをご覧ください。 ウェブフックイベントトリガー.

  1. 外部サービスがWebhookリクエストを受信して処理する準備ができていることを確認してください。これには通常、以下が含まれます

    • BitriseからのHTTP POSTリクエストを受信するためのパブリックアクセス可能なURLを作成します。

    • JSON ペイロードの処理:JSON データを解析し、関連情報を抽出します。

    • 受信したイベントに基づいてサービスが実行すべきアクションを定義します。

  2. 送信用ウェブフックの作成 ビットライズで。

  3. オープンリリース管理。

  4. アプリを選択します。

  5. に移動 リリースプリセット

    2025-10-29-release-presets.png
  6. 新しいテンプレートを作成する または、既存のテンプレートを変更します。

  7. テンプレートページで、 送信 Web フック カードとクリック 詳細を表示

  8. クリック ウェブフックを追加

  9. からウェブフックを選択してください ウェブフック設定 メニュー。

    2025-10-29-rm-add-outgoing-webhook.png
  10. Webhook をトリガーするイベントを選択します。

    イベントとそのペイロード情報の全リストをご覧ください。 ウェブフックイベントトリガー.

リリースからの送信Webhookの削除

送信Webhookは、個々のリリースまたはリリースプリセットテンプレートから削除できます。

個人リリース

リリースプリセット

  1. オープンリリース管理。

  2. アプリを選択します。

  3. まだ終了していないリリースを選択してください。

    2025-10-29-releases.png
  4. に移動 [構成]

  5. 見つけて 送信用ウェブフック カードとクリック 詳細を表示

  6. 「構成を削除」アイコンをクリックします。

    2025-10-29-remove-webhooks-rm.png
  1. オープンリリース管理。

  2. アプリを選択します。

  3. [選択] リリースプリセット 左側。

    2025-10-29-release-presets.png
  4. 必要なリリースプリセットのテンプレートを見つけてクリックしてください 3_dots.png 次に、を選択します。 変更

  5. 見つけて 送信用ウェブフック カードとクリック 詳細を表示

  6. 「構成を削除」アイコンをクリックします。

ウェブフックイベントトリガー

複数のリリース自動化イベントがWebhookをトリガーする可能性があります。すべての Webhook には次のフィールドが含まれます。

  • app_id

  • project_id

  • release_candidate_artifact_id

  • release_id

  • sent_at | フォーマット:ナノ秒精度の UNIX タイムスタンプ

  • store_app_id

  • triggered_at | フォーマット:ナノ秒精度の UNIX タイムスタンプ

  • triggered_by | フォーマット:ユーザースラッグか、「オートメーション」、「Apple App Store」、「Google Play ストア」のいずれか

  • trigger_event

  • webhook_config_id

  • webhook_connection_id

  • webhook_event_unique_id | フォーマット: WEBHOOK_ID@TRIGGER_TIMESTAMP_NANO

  • workspace_id

次の Webhook イベントを使用できます。は フィールズ 列には、トリガーイベントが Webhook ペイロードに追加する追加フィールドが含まれます。

表1 ウェブフックとそのフィールド

ウェブフック名

フィールド

アプリバージョンが追加されました

  • description

  • preset_template_id

リリースの説明が変更されました

  • description

自動アップロードが有効

自動アップロード無効

Slack 接続が変更されました

マイクロソフトチーム接続が変更されました

自動化が追加されました

  • event_name

  • pipeline_name

  • workflow_name

自動化が削除されました

  • event_name

  • pipeline_name

  • workflow_name

送信用ウェブフックが追加されました

  • all_events (true/false)

  • events (only listed if 'all_events' are false)

  • workspace_webhook_id

送信ウェブフックが更新されました

  • all_events (true/false)

  • events (only listed if 'all_events' are false)

  • workspace_webhook_id

送信ウェブフックが削除されました

  • all_events (true/false)

  • events (only listed if 'all_events' are false)

  • workspace_webhook_id

リリースの管理を停止しました

  • reason_for_stopping (abandoned/completed externally)

リリース候補セット

  • source (ci/api)

  • to_source (ci/api)

  • branch

  • workflow

  • to_branch |to_source に 'ci' がある場合のみ

  • to_workflow | to_source に 'ci' がある場合のみ

リリース候補の自動選択最新ビルドが無効

リリース候補の自動選択最新ビルドが有効になりました

リリース候補ビルドが選択されました

  • file_name

  • version

  • version_code

テストフライトのアップロードが開始されました

  • file_name

  • version

  • version_code

テストフライトのアップロードに失敗しました

  • file_name

  • version

  • version_code

テストフライトのアップロードが完了しました

  • file_name

  • version

  • version_code

テストフライト処理が失敗しました

  • file_name

  • version

  • version_code

テストフライト処理が完了しました

  • file_name

  • version

  • version_code

TestFlight テスト対象が追加されました

  • language

  • what_to_test

TestFlight テスト対象が変更されました

  • language

  • what_to_test

TestFlight テスト対象を削除しました

  • language

TestFlight アプリのレビューが送信されました

  • testflight_beta_build_id

TestFlightアプリのレビューが承認されました

  • testflight_beta_build_id

TestFlight アプリのレビューが却下されました

  • testflight_beta_build_id

テストフライト配信開始

  • group_id

  • testflight_beta_build_id

テストフライト配信開始失敗

  • group_id

  • testflight_beta_build_id

テストフライト配信停止

  • group_id

  • testflight_beta_build_id

Google Play のアップロードが開始されました

  • file_name

  • version

  • version_code

Google Play のアップロードが完了しました

  • file_name

  • version

  • version_code

Google Play のアップロードが失敗しました

  • file_name

  • version

  • version_code

Google Play テストトラックのリリースが完了しました

  • file_name

  • track_name

  • version

  • version_code

Google Play テストトラックのリリースが失敗しました

  • file_name

  • track_name

  • version

  • version_code

承認タスクが完了しました

  • approval_task_ids

承認タスクが追加されました

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

承認タスクが変更されました

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

承認タスクが完了しました

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

承認タスクが削除されました

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

承認タスクが再開されました

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

App store version created

  • version

App store version updated

  • version

Metadata localization added

  • language

  • added_values

Metadata localization changed

  • language

  • changed_values

Metadata localization removed

  • language

Release settings changed

  • earliest_release_date

  • phased_release

  • release_type

  • version_string

Phased release enabled

Phased release disabled

App store review submitted

  • file_name

  • version

  • version_code

App store review cancelled

  • file_name

  • version

  • version_code

App store review rejected

  • file_name

  • reason

  • version

  • version_code

App store review approved

  • file_name

  • version

  • version_code

Phased release paused

  • percentage_of_users

Phased release resumed

  • percentage_of_users

App store release started

App store release completed

Google Play release notes localization added

  • language

  • release_notes

Google Play release notes localization changed

  • language

  • release_notes

Google Play release notes localization removed

  • language

  • release_notes

Google Play release started

  • release_method

  • staged_release

Google Play rollout percentage changed

  • release_method

  • rollout_percentage_from

  • rollout_percentage_to

Google Play automated rollout configured

  • rollout_start_time

Google Play automated rollout paused

  • rollout_percentage

Google Play automated rollout resumed

  • rollout_percentage

Google Play automated rollout cancelled

Google Play release completed