Webhooks App Center

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

Gambaran Umum

Webhook adalah cara sederhana untuk memberi tahu aplikasi pihak ketiga ketika peristiwa tertentu telah terjadi. Tujuan utama webhook adalah untuk mengomunikasikan informasi penting dari App Center kepada pengguna daripada meminta pengguna datang ke portal, atau menjalankan panggilan API untuk diberi tahu ketika peristiwa tertentu terjadi.

Webhook App Center memungkinkan pengguna mengirim pemberitahuan otomatis ke aplikasi yang terhubung untuk peristiwa berikut:

• Kecelakaan: saat grup kecelakaan dibuat
• Distribusikan: saat versi baru dirilis ke grup distribusi

  Nota

  Untuk Distribusi, webhook akan dipicu ketika versi baru dirilis ke grup distribusi. Jika Anda memilih tidak memberi tahu penguji di langkah Tinjau dalam membuat rilis baru, webhook tidak akan diaktifkan. Untuk Diagnostics, webhook akan dipicu untuk kelompok kesalahan baru dengan simbol yang diberikan. Jika tidak ada simbol yang ditemukan untuk grup kesalahan baru, webhook tidak akan diaktifkan.

App Center akan mengirim payload HTTP POST ke URL webhook yang ditentukan. Webhook dikonfigurasi di tingkat aplikasi di bawah halaman Pengaturan aplikasi yang Anda tentukan. Pengguna harus memiliki izin manajer atau pengembang di aplikasi untuk membuat dan mengonfigurasi webhook. Saat ini kami hanya mendukung webhook untuk Slack dan Microsoft Teams. Untuk memposting ke platform lain, Anda dapat menulis fungsi Azure yang menerjemahkan cara kami POST agar sesuai dengan persyaratan platform.

Memulai Langkah Awal

1. Navigasi ke App Center, dan pilih aplikasi tertentu yang Anda inginkan untuk integrasi webhook.

2. Di aplikasi Anda, di panel paling kiri, pilih Pengaturan

3. Di panel baris berjudul Webhook, buka sudut kanan dan klik ikon pensil, yang memunculkan panel Webhooks .

   

4. Di sudut kanan atas, klik tombol Webhook Baru berwarna biru dan masukkan:

   • Nama webhook

   • Webhook URL

     Anda dapat memperoleh URL webhook dari pengaturan aplikasi terintegrasi Anda (misalnya, berikut adalah detail tentang cara mendapatkan URL webhook dari Microsoft Teams dan cara mendapatkan URL webhook dari Slack).

     Pilih kotak centang untuk pemberitahuan Crash dan Distribusi untuk memutuskan peristiwa apa yang akan memicu peringatan webhook.

     

5. Selesai! Webhook Anda sekarang dibuat dan diaktifkan. Anda dapat membuat beberapa webhook dengan mengulangi langkah 4.

6. Alihkan ke bagian paling kanan webhook untuk menguji, menonaktifkan, atau menghapus webhook.

   • pengujian akan mengirim pemberitahuan pengujian ke aplikasi anda yang terhubung.
   • nonaktifkan menjaga webhook tetap tidak aktif tetapi ada di dasbor Anda.
   • hapus akan menghapus webhook dari dasbor Anda.

Saat peristiwa ini terjadi, pemberitahuan App Center diposting ke dalam aplikasi terintegrasi Anda.

Contoh payload webhook

Berikut adalah contoh payload webhook JSON untuk:

1. Kecelakaan

{
  "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"
}

2. Distribusikan

{
  "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"
}

Anda juga dapat memeriksa payload dengan menggunakan RequestBin. Untuk melakukannya, navigasikan ke RequestBin, klik Buat RequestBin, lalu salin URL yang dihasilkan di bawah URL Bin dan tempelkan URL sebagai webhook di App Center.

Dukungan webhook kustom

Untuk memposting ke platform lain, Anda dapat menulis fungsi Azure yang menerjemahkan cara kami POST agar sesuai dengan persyaratan platform. Untuk melakukannya, buat fungsi Azure, tempelkan URL di bawah bidang URL Webhook di langkah 4, dan App Center akan memposting payload webhook ke titik akhir tersebut. Anda kemudian dapat memodifikasi payload ke persyaratan platform.