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 には次のフィールドが含まれます。

表 83. 共有ウェブフックイベントフィールド

Field name

Format

app_id

project_id

release_candidate_artifact_id

release_id

sent_at

ナノ秒精度の UNIX タイムスタンプ

store_app_id

triggered_at

ナノ秒精度の UNIX タイムスタンプ

triggered_by

ユーザースラッグまたは次のいずれか Automation、 Apple App Store、 Google Play Store

trigger_event

webhook_config_id

webhook_connection_id

webhook_event_unique_id

WEBHOOK_ID@TRIGGER_TIMESTAMP_NANO

workspace_id


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

表 84. 特定の Webhook イベントフィールド

ウェブフック名

トリガーイベント

フィールド

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

app_version_added

  • description

  • preset_template_id

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

release_description_changed

  • description

自動アップロードが有効

auto-upload_enabled

自動アップロード無効

auto-upload_disabled

Slack 接続が変更されました

slack_connection_changed

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

microsoft_teams_connection_changed

自動化が追加されました

automation_added

  • event_name

  • pipeline_name

  • workflow_name

自動化が削除されました

automation_removed

  • event_name

  • pipeline_name

  • workflow_name

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

outgoing_webhook_added

  • all_events

    使用可能な値: true/false

  • events: 次の場合のみ表示されます all_events は偽です。

  • workspace_webhook_id

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

outgoing_webhook_updated

  • all_events 真/偽

  • events: 次の場合のみ表示されます all_events は偽です

  • workspace_webhook_id

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

outgoing_webhook_deleted

  • all_events

    使用可能な値: true/false

  • events 次の場合のみ表示されます。 all_events は偽です

  • workspace_webhook_id

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

stopped_managing_release

  • reason_for_stopping

    使用可能な値: abandoned/completed externally

リリース候補セット

release_candidate_source_changed

  • from_source

    使用可能な値: ci/api/empty string

  • to_source

    使用可能な値: ci/api

  • from_branch: 値が次の場合のみ from_source は ci

  • from_workflow: 値が次の場合のみ from_source は ci。

  • to_branch: 値が次の場合のみ to_source は ci。

  • to_workflow: 値が次の場合のみ to_source は ci。

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

release_candidate_auto_select_latest_build_disabled

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

release_candidate_auto_select_latest_build_enabled

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

release_candidate_build_selected

  • file_name

  • version

  • version_code

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

testflight_upload_started

  • file_name

  • version

  • version_code

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

testflight_upload_failed

  • file_name

  • version

  • version_code

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

testflight_upload_completed

  • file_name

  • version

  • version_code

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

testflight_processing_failed

  • file_name

  • version

  • version_code

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

testflight_processing_completed

  • file_name

  • version

  • version_code

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

testflight_what_to_test_added

  • language

  • what_to_test

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

testflight_what_to_test_changed

  • language

  • what_to_test

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

testflight_what_to_test_deleted

  • language

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

testflight_app_review_submitted

  • testflight_beta_build_id

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

testflight_app_review_approved

  • testflight_beta_build_id

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

testflight_app_review_rejected

  • testflight_beta_build_id

テストフライト配信開始

testflight_distribution_started

  • group_id

  • testflight_beta_build_id

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

testflight_distribution_start_failed

  • group_id

  • testflight_beta_build_id

テストフライト配信停止

testflight_distribution_stopped

  • group_id

  • testflight_beta_build_id

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

google_play_upload_started

  • file_name

  • version

  • version_code

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

google_play_upload_completed

  • file_name

  • version

  • version_code

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

google_play_upload_failed

  • file_name

  • version

  • version_code

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

google_play_testing_track_release_completed

  • file_name

  • track_name

  • version

  • version_code

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

google_play_testing_track_release_failed

  • file_name

  • track_name

  • version

  • version_code

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

approval_tasks_completed

  • approval_task_ids

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

approval_task_added

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

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

approval_task_changed

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

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

approval_task_completed

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

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

approval_task_deleted

  • approval_id

  • assigned_to

  • created_by

  • description

  • due_date

  • title

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

approval_task_reopened

  • 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 リリースノートのローカリゼーションが追加されました

google_play_release_notes_localization_added

  • language

  • release_notes

Google Play リリースノートのローカリゼーションが変更されました

google_play_release_notes_localization_changed

  • language

  • release_notes

Google Play リリースノートのローカリゼーションが削除されました

google_play_release_notes_localization_removed

  • language

  • release_notes

グーグルプレイリリース開始

google_play_release_started

  • release_method

  • staged_release

Google Play のロールアウト率が変更されました

google_play_rollout_percentage_changed

  • release_method

  • rollout_percentage_from

  • rollout_percentage_to

Google Play の自動ロールアウトが設定されました

google_play_automated_rollout_configured

  • rollout_start_time

Google Play の自動ロールアウトが一時停止されました

google_play_automated_rollout_paused

  • rollout_percentage

Google Play の自動ロールアウトが再開されました

google_play_automated_rollout_resumed

  • rollout_percentage

Google Play の自動ロールアウトがキャンセルされました

google_play_automated_rollout_cancelled

グーグルプレイリリース完了

google_play_release_completed


このセクションの内容: