共用方式為

App Center Webhook

這很重要

Visual Studio App Center 於 2025 年 3 月 31 日淘汰，但分析和診斷功能除外，這些功能將持續支援到 2026 年 6 月 30 日。 瞭解更多資訊。

概觀

Webhook 是在發生指定事件時通知第三方應用程式的簡單方式。 Webhook 的主要目標是將重要資訊從 App Center 傳達給使用者，而不是讓使用者來到入口網站，或執行 API 呼叫，以在發生特定事件時收到通知。

App Center 的 Webhook 可讓使用者針對下列事件，將自動通知傳送至已連線的應用程式：

  • 當機：建立當機群組時
  • 分發：當新版本釋出至分發群組時

    備註

    針對 [散發]，當新版本發行至通訊群組時，將會觸發 Webhook。 如果您在建立新版本的檢閱步驟中選擇不通知測試人員，則 Webhook 不會觸發。 診斷期間，系統會觸發 Webhook 以處理具有指定符號的新錯誤群組。 如果找不到新錯誤群組的符號，Webhook 將不會啟動。

App Center 會將 HTTP POST 承載傳送至 Webhook 的指定 URL。 Webhook 會在您指定應用程式的 [ 設定 ] 頁面底下，於應用程式層級設定。 用戶必須在應用程式中擁有管理員或開發人員許可權，才能建立及設定 Webhook。 我們目前只支援 Slack 和 Microsoft Teams 的 Webhook。 若要張貼至其他平台，您可以撰寫 Azure 函數，以調整我們的 使其符合平台需求。

入門指南

  1. 流覽至 App Center，然後選取您想要進行 Webhook 整合的特定應用程式。

  2. 在您的應用程式中，選取最左邊面板中的 [ 設定]

  3. 在標題為 Webhooks 的列面板中，移至右側角落，然後單擊 鉛筆圖示，以顯示 Webhooks 面板。

    如何編輯 Webhook 的設定

  4. 在右上角，按兩下藍色的 [ 新增 Webhook ] 按鈕，然後輸入：

  5. 完成! 您的 Webhook 現在已建立並啟用。 您可以重複 步驟 4 來建立多個 Webhook。

  6. 切換至 Webhook 的最右邊以進行測試、停用或刪除選項。

    • test 會將測試警示傳送至已連線的應用程式。
    • disable 會讓 Webhook 保持非使用中狀態，但存在於您的儀錶板中。
    • 刪除 會從儀表板中移除 Webhook。

發生這些事件時，App Center 通知會張貼到整合式應用程式中。

範例 Webhook 承載

以下是 JSON Webhook 承載的範例：

  1. 崩潰
{
  "id":"3698593379u",
  "name":"android.app.Activity.performResume (Activity.java:5084)",
  "reason":"android.app.SuperNotCalledException",
  "url":"https://appcenter.ms/orgs/{org-id}/apps/{app-name}/crashes/errors/3698273379u",
  "app_display_name":"{app-name}",
  "app_platform":"Java",
  "app_version":"2.0.1(42)",
  "stack_trace":[],
  "affected_users":0,
  "crash_count":0,
  "sent_at":"2019-05-16T23:47:31.4881512Z",
  "app_id":"00001111-aaaa-2222-bbbb-3333cccc4444"
}
  1. 分發
{
  "app_name":"{app-name}",
  "app_display_name":"{app-display-name}",
  "release_id":"123",
  "platform":"Android",
  "uploaded_at":"2018-07-17T20:46:14Z",
  "fingerprint":"0abed1269e4ae3bf524e4cc7165f4f34",
  "release_notes":"",
  "version":"74",
  "short_version":"1.7.0",
  "min_os":"4.0.3",
  "mandatory_update":true,
  "size":2634279,
  "provisioning_profile_name":null,
  "provisioning_profile_type":null,
  "bundle_identifier":"com.microsoft.appcenter.test",
  "install_link":"https://install.appcenter.ms/orgs/{org-name}/apps/{app-name}/releases/123?source=email",
  "icon_link":"https://appcenter-filemanagement-distrib4ede6f06e.azureedge.net/f7794e4c-42f1-4e7c-8013-07ed2e1b733d/ic_launcher.png?sv=2020-02-18&sr=c&sig=gs4JfcWjpKeYH%2F%2Fg0jEtSKKbeRkug9q%2FldslmzzeOg0%3D&se=2020-02-26T08%3A57%3A58Z&sp=r",
  "distribution_group_id":"1a5a0605-4b9c-4de2-9a35-t569456df0cc",
  "installable":true,
  "sent_at":"2019-05-16T23:20:08.7799314Z",
  "app_id":"11112222-bbbb-3333-cccc-4444dddd5555"
}

您也可以使用 RequestBin 來檢查承載。 若要這樣做，請流覽至 RequestBin，按兩下 [ 建立 RequestBin]，然後在 [Bin URL ] 底下複製產生的 URL，並將 URL 貼上為 App Center 中的 Webhook。

自訂 Webhook 支援

若要張貼至其他平臺，您可以撰寫 Azure 函式 ，以轉譯我們 POST 符合平臺需求的方式。 若要這樣做，請建立 Azure 函式，將 URL 貼到步驟 4 中的 [Webhook URL] 字段底下，而 App Center 會將 Webhook 承載張貼至該端點。 然後，您可以將負載修改為符合平臺所需格式。

  • Last updated on