Sdílet prostřednictvím

Webhooky Centra aplikací

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

Přehled

Webhooky představují jednoduchý způsob, jak upozornit aplikace třetích stran, když dojde k zadané události. Hlavním cílem webhooků je sdělit uživatelům důležité informace z App Center, než aby se uživatelé museli dostávat na portál nebo spouštět volání API, aby byli informováni, když dojde k určitým událostem.

Webhooky App Center umožňují uživatelům odesílat automatická oznámení připojeným aplikacím pro následující události:

  • Selhání: při vytvoření skupiny selhání
  • Distribuce: Při vydání nové verze do distribuční skupiny

    Poznámka:

    Při distribuci se webhook aktivuje při vydání nové verze do distribuční skupiny. Pokud jste v kroku revizeneoznamovali testerům vytvoření nové verze, webhook se neaktivuje. V případě diagnostiky se webhook aktivuje pro nové skupiny chyb se zadanými symboly. Pokud nejsou nalezeny žádné symboly pro novou skupinu chyb, webhook se neaktivuje.

App Center odešle datovou část HTTP POST na zadanou adresu URL webhooku. Webhooky se konfigurují na úrovni aplikace na stránce Nastavení zadané aplikace. Aby uživatelé mohli vytvářet a konfigurovat webhooky, musí mít v aplikaci oprávnění správce nebo vývojáře. V současné době podporujeme pouze webhooky pro Slack a Microsoft Teams. Pokud chcete publikovat na jiné platformy, můžete napsat funkci Azure , která překládá způsob, jakým POST vyhovuje požadavkům platformy.

Začínáme

  1. Přejděte do App Center a vyberte konkrétní aplikaci, kterou chcete použít pro integraci webhooků.

  2. V aplikaci na levém panelu vyberte Nastavení.

  3. Na panelu řádků s názvem Webhooky přejděte do pravého rohu a klikněte na ikonu tužky, která zobrazí panel Webhooků .

    Úprava nastavení webhooku

  4. V pravém horním rohu klikněte na modré tlačítko Nový webhook a zadejte:

  5. Hotovo! Webhook je teď vytvořený a povolený. Opakováním kroku 4 můžete vytvořit několik webhooků.

  6. Přepněte na extrémní pravou ruku webhooku a otestujte, zakažte nebo odstraňte webhook.

    • test odešle testovací upozornění do připojené aplikace.
    • zakázat webhook zůstane neaktivní, ale bude přítomen na řídicím panelu.
    • odstraněním odstraníte webhook z řídicího panelu.

Když k těmto událostem dojde, oznámení App Center se publikují do integrovaných aplikací.

Ukázková datová část webhooku

Tady jsou příklady datové části webhooku JSON pro:

  1. Havárie
{
  "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. Distribuovat
{
  "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"
}

Datovou část můžete také zkontrolovat pomocí RequestBin. Uděláte to tak, že přejdete na RequestBin, kliknete na Vytvořit RequestBin, a potom zkopírujete vygenerovanou adresu URL pod Bin URL a vložíte tuto adresu URL jako webhook do App Center.

Podpora vlastních webhooků

Pokud chcete publikovat na jiné platformy, můžete napsat funkci Azure , která přeloží způsob, jakým POST vyhovuje požadavkům platformy. Uděláte to tak, že vytvoříte funkci Azure, vložte adresu URL do pole Adresa URL webhooku v kroku 4 a App Center odešle payload webhooku do tohoto koncového bodu. Datovou část pak můžete upravit podle požadavků platformy.

  • Last updated on