Condividi tramite

Webhooks di App Center

Importante

Visual Studio App Center è stato ritirato il 31 marzo 2025, ad eccezione delle funzionalità di Analisi e diagnostica, che continueranno a essere supportate fino al 30 giugno 2026. Ulteriori informazioni.

Informazioni generali

I webhook sono un modo semplice per notificare alle applicazioni di terze parti quando si è verificato un evento specificato. L'obiettivo principale dei webhook è comunicare informazioni importanti da App Center agli utenti invece di far venire gli utenti al portale o eseguire chiamate API per ricevere una notifica quando si verificano determinati eventi.

I webhook di App Center consentono agli utenti di inviare notifiche automatiche alle applicazioni connesse per gli eventi seguenti:

  • Guasti: quando viene creato un gruppo di guasti
  • Distribuisci: quando viene rilasciata una nuova versione a un gruppo di distribuzione

    Annotazioni

    Per Distribuisci, il webhook verrà attivato quando viene rilasciata una nuova versione a un gruppo di distribuzione. Se è stato selezionato non notificare i tester nel passaggio Revisione della creazione di una nuova versione, il webhook non verrà attivato. Per Diagnostica, il webhook verrà attivato per i nuovi gruppi di errori con i simboli forniti. Se non viene trovato alcun simbolo per il nuovo gruppo di errori, il webhook non verrà attivato.

App Center invierà un payload HTTP POST all'URL specificato del webhook. I webhook vengono configurati a livello di app nella pagina Impostazioni dell'app specificata. Gli utenti devono disporre delle autorizzazioni di gestione o sviluppatore nell'app per creare e configurare i webhook. Attualmente sono supportati solo webhook per Slack e Microsoft Teams. Per pubblicare post su altre piattaforme, è possibile scrivere una funzione di Azure che traduce il modo in cui lo facciamo per adattarsi ai requisiti della piattaforma.

Come iniziare

  1. Passare ad App Center e selezionare l'app specifica desiderata per l'integrazione dei webhook.

  2. Nell'app, nel pannello a sinistra, selezionare Impostazioni

  3. Nel pannello delle righe intitolato Webhook, passare all'angolo destro e fare clic sull'icona a forma di matita, che consente di visualizzare il pannello Webhook.

    Come modificare le impostazioni del webhook

  4. Nell'angolo in alto a destra fare clic sul pulsante blu Nuovo webhook e immettere:

    • Nome webhook

    • URL del Webhook

      È possibile ottenere l'URL del webhook dalle impostazioni dell'applicazione integrata( ad esempio, ecco i dettagli su come ottenere l'URL del webhook da Microsoft Teams e su come ottenere l'URL del webhook da Slack).

      Selezionare la casella di controllo relativa a "Arresti anomali" e "Distribuisci notifiche" per decidere quali eventi attiveranno gli avvisi del webhook.

      Come creare un nuovo webhook

  5. Fatto! Il tuo webhook è stato creato e abilitato. È possibile creare più webhook ripetendo il passaggio 4.

  6. Passare alla mano estrema destra del webhook per testare, disabilitare o eliminare il webhook.

    • test invierà un avviso di test all'applicazione connessa.
    • Disabilitare mantiene il webhook inattivo ma presente sul cruscotto.
    • delete rimuoverà il webhook dal dashboard.

Quando si verificano questi eventi, le notifiche di App Center vengono inserite nelle applicazioni integrate.

Payload webhook di esempio

Ecco alcuni esempi del payload del webhook JSON per:

  1. Scontro
{
  "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. Distribuire
{
  "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"
}

È anche possibile esaminare il payload usando RequestBin. A tale scopo, naviga su RequestBin, fai clic su Crea un RequestBin, quindi copia l'URL generato sotto URL del Bin e incolla l'URL come webhook in App Center.

Supporto webhook personalizzato

Per effettuare una pubblicazione su altre piattaforme, potete scrivere una funzione di Azure che traduce il modo in cui POST per soddisfare i requisiti della piattaforma. A tale scopo, creare una funzione di Azure, incollare l'URL nel campo URL del webhook nel passaggio 4 e App Center pubblicherà il payload del webhook in tale endpoint. È quindi possibile modificare il payload in base ai requisiti della piattaforma.

  • Last updated on