メインコンテンツまでスキップ

Release Management の送信 Webhook

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

Standardプランのみ

outgoing WebhookをWorkspaceに追加できますが、Release Managementプロジェクトでの接続は、standardライセンスを持つプロジェクトでのみ可能です。

リリースへのアウトゴーイングWebhookの追加Click to copy link​

リリースへアウトゴーイングWebhookを追加する方法は2つあります。

  • 個々のリリースにWebhookを追加する。
  • リリースプリセットテンプレートにWebhookを追加する。そのテンプレートを使用するすべてのリリースで、設定されたWebhookが使用されます。
  1. 外部サービスがWebhookリクエストを受信して処理できる状態になっていることを確認してください。これには通常、次のことが含まれます。

    • BitriseからのHTTP POSTリクエストを受信するための、パブリックにアクセス可能なURLを作成する。
    • JSONペイロードを処理する: JSONのデータを解析し、関連情報を抽出する。
    • 受信したイベントに基づいて、サービスが実行するアクションを定義する。
  2. BitriseでアウトゴーイングWebhookを作成します。

  3. Release Managementを開きます。

  4. your appを選択します。

  5. 完了していないリリースを選択します。

    2025-10-29-releases.png

  6. Configurationに移動します。

  7. Outgoing webhooksカードを見つけて、Show detailsをクリックします。

    2025-10-29-outgoing-webhooks-rm.png

  8. Add webhookをクリックします。

  9. Webhook configurationメニューからWebhookを選択します。

    2025-10-29-rm-add-outgoing-webhook.png

  10. Webhookをトリガーするイベントを選択します。

    イベントの全一覧とそのペイロード情報については、Webhookイベントを参照してください。

リリースからのアウトゴーイングWebhookの削除Click to copy link​

個々のリリースまたはリリースプリセットテンプレートから、アウトゴーイングWebhookを削除できます。

  1. Release Managementを開きます。

  2. your appを選択します。

  3. 完了していないリリースを選択します。

    2025-10-29-releases.png

  4. Configurationに移動します。

  5. Outgoing webhooksカードを見つけて、Show detailsをクリックします。

  6. remove configurationアイコンをクリックします。

    2025-10-29-remove-webhooks-rm.png

WebhookイベントClick to copy link​

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

Field nameFormat
app_id
project_id
release_candidate_artifact_id
release_id
sent_atナノ秒精度のUNIXタイムスタンプ
store_app_id
triggered_atナノ秒精度のUNIXタイムスタンプ
triggered_byuser slug、または次のいずれか: Automation、Apple App Store、Google Play Store
trigger_event
webhook_config_id
webhook_event_unique_idWEBHOOK_ID@TRIGGER_TIMESTAMP_NANO
workspace_id

次のWebhookイベントを使用できます。フィールド列には、トリガーとなるイベントがWebhookペイロードに追加する追加フィールドが記載されています。

Webhook名トリガーイベントフィールド
アプリバージョンの追加app_version_added- description - preset_template_id
リリース説明の変更release_description_changed- description
自動アップロードの有効化auto-upload_enabled
自動アップロードの無効化auto-upload_disabled
Slack接続の変更slack_connection_changed
Microsoft Teams接続の変更microsoft_teams_connection_changed
自動化の追加automation_added- event_name - pipeline_name - workflow_name
自動化の削除automation_removed- event_name - pipeline_name - workflow_name
アウトゴーイングWebhookの追加outgoing_webhook_added- all_events 使用可能な値: true/false - events: all_eventsがfalseの場合にのみ表示されます。 - webhook_configuration_id
アウトゴーイングWebhookの更新outgoing_webhook_updated- all_events true/false - events: all_eventsがfalseの場合にのみ表示 - webhook_configuration_id
アウトゴーイングWebhookの削除outgoing_webhook_deleted- all_events 使用可能な値: true/false - events all_eventsがfalseの場合にのみ表示 - webhook_configuration_id
Stopped managing releasestopped_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アップロードの開始testflight_upload_started- file_name - version - version_code
TestFlightアップロードの失敗testflight_upload_failed- file_name - version - version_code
TestFlightアップロードの完了testflight_upload_completed- file_name - version - version_code
TestFlight processing failedtestflight_processing_failed- file_name - version - version_code
TestFlight処理の完了testflight_processing_completed- file_name - version - version_code
TestFlight what to testの追加testflight_what_to_test_added- language - what_to_test
TestFlight what to testの変更testflight_what_to_test_changed- language - what_to_test
TestFlight what to testの削除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配布の開始testflight_distribution_started- group_id - testflight_beta_build_id
TestFlight配布開始の失敗testflight_distribution_start_failed- group_id - testflight_beta_build_id
TestFlight配布の停止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 - skipped_with_zero_tasks (boolean)
承認タスクの追加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バージョンの作成app_store_version_created- version
App Storeバージョンの更新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レビューの送信app_store_review_submitted- file_name - version - version_code
App Storeレビューのキャンセルapp_store_review_cancelled- file_name - version - version_code
App Storeレビューの却下app_store_review_rejected- file_name - reason - version - version_code
App Storeレビューの承認app_store_review_approved- file_name - version - version_code
App Storeリリースのキャンセルapp_store_release_cancelled- file_name - version - version_code
段階的リリースの一時停止phased_release_paused- percentage_of_users
段階的リリースの再開phased_release_resumed- percentage_of_users
App Storeリリースの開始app_store_release_started
App Storeリリースの完了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リリースの開始google_play_release_started- release_method - staged_release
Google Play rollout percentageの変更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リリースの完了google_play_release_completed