Compartilhar via

App Center Webhooks

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

Visão geral

Webhooks são uma maneira simples de notificar aplicativos de terceiros quando um evento especificado ocorreu. O principal objetivo dos webhooks é comunicar informações importantes do App Center aos usuários, em vez de fazer com que os usuários venham ao portal ou executem chamadas de API para serem notificados quando determinados eventos acontecerem.

Os webhooks do App Center permitem que os usuários enviem notificações automáticas para aplicativos conectados para os seguintes eventos:

  • Falhas: quando um grupo de falhas é criado
  • Distribuir: quando uma nova versão é lançada em um grupo de distribuição

    Observação

    Para Distribuir, o webhook será disparado quando uma nova versão for lançada em um grupo de distribuição. Se você tiver verificado não notificar os testadores na etapa Revisão da criação de uma nova versão, o webhook não será acionado. Para Diagnósticos, o webhook será disparado para novos grupos de erros com símbolos fornecidos. Se nenhum símbolo for encontrado para o novo grupo de erros, o webhook não será acionado.

O App Center enviará um conteúdo HTTP POST para a URL especificada do webhook. Os webhooks são configurados no nível do aplicativo na página Configurações do aplicativo especificado. Os usuários devem ter permissões de gerente ou desenvolvedor no aplicativo para criar e configurar os webhooks. Atualmente, só oferecemos suporte a webhooks para Slack e Microsoft Teams. Para postar em outras plataformas, você pode escrever uma função do Azure que traduza a maneira como nos ajustamos POST aos requisitos da plataforma.

Introdução

  1. Navegue até o App Center e selecione o aplicativo específico que você deseja para a integração de webhooks.

  2. Em seu aplicativo, no painel à esquerda, selecione Configurações

  3. No painel de linhas intitulado Webhooks, vá para o canto direito e clique no ícone de lápis, que apresenta o painel Webhooks .

    Como editar as configurações do webhook

  4. No canto superior direito, clique no botão azul Novo Webhook e insira:

    • Nome do webhook

    • Webhook URL

      Você pode obter a URL do webhook das configurações do aplicativo integrado (por exemplo, aqui estão detalhes sobre como obter a URL do webhook do Microsoft Teams e como obter a URL do webhook do Slack).

      Selecione a caixa de seleção para Erros e a distribuição de notificações para decidir quais eventos dispararão os alertas do webhook.

      Como criar um novo webhook

  5. Feito! Seu webhook agora está criado e habilitado. Você pode criar vários webhooks repetindo a etapa 4.

  6. Alterne para a extrema direita do webhook para testar, desabilitar ou excluir o webhook.

    • O teste enviará um alerta de teste para seu aplicativo conectado.
    • desabilitar mantém o webhook inativo, mas presente em seu painel.
    • Delete removerá o webhook do painel.

Quando esses eventos acontecem, as notificações do App Center são postadas em seus aplicativos integrados.

Conteúdo de webhook de exemplo

Aqui estão exemplos do conteúdo do webhook JSON para:

  1. Colisão
{
  "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. Distribuir
{
  "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"
}

Você também pode inspecionar o payload usando RequestBin. Para fazer isso, navegue até RequestBin, clique em Criar um RequestBin e copie a URL gerada na URL bin e cole a URL como um webhook no App Center.

Suporte personalizado de webhook

Para postar em outras plataformas, você pode escrever uma função do Azure que adapte nossa abordagem POST para se adequar aos requisitos da plataforma. Para fazer isso, crie uma função do Azure, cole a URL no campo URL do Webhook na etapa 4 e o App Center postará o conteúdo do webhook nesse ponto de extremidade. Em seguida, você pode modificar a carga útil para os requisitos da plataforma.

  • Last updated on