Поделиться через

Вебхуки Центра приложений

Это важно

Центр приложений Visual Studio был прекращен 31 марта 2025 г., за исключением функций аналитики и диагностики, которые будут поддерживаться до 30 июня 2026 г. Подробнее.

Обзор

Веб-перехватчики — это простой способ уведомления сторонних приложений о возникновении указанного события. Основная цель веб-перехватчиков заключается в том, чтобы передавать важные сведения из Центра приложений пользователям, а не приходить на портал или запускать вызовы API, чтобы получать уведомления при возникновении определенных событий.

Веб-перехватчики Центра приложений позволяют пользователям отправлять автоматические уведомления в подключенные приложения для следующих событий:

  • Сбои: при создании группы сбоев
  • Распространение: при выпуске новой версии в группу рассылки

    Замечание

    Для распространения веб-перехватчик будет активирован при выпуске новой версии в группу рассылки. Если вы указали не уведомлять тестировщиков на этапе проверки создания нового выпуска, веб-перехватчик не будет срабатывать. Для диагностики вебхук будет активирован для новых групп ошибок с предоставленными идентификаторами. Если для новой группы ошибок не найдены символы, веб-хук не будет активирован.

Центр приложений отправит нагрузку HTTP POST на указанный URL-адрес веб-перехватчика. Веб-перехватчики настраиваются на уровне приложения в разделе параметров указанного приложения. Пользователи должны обладать правами менеджера или разработчика в приложении, чтобы создавать и настраивать вебхуки. В настоящее время мы поддерживаем только вебхуки для Slack и Microsoft Teams. Для публикации на других платформах вы можете написать функцию Azure, которая переводит наш подход, чтобы соответствовать требованиям той платформы.

Начало работы

  1. Перейдите в Центр приложений и выберите конкретное приложение, которое вам необходимо для интеграции вебхуков.

  2. В приложении на панели слева выберите "Параметры"

  3. На панели строки под названием Webhooks перейдите в правый угол и щелкните значок карандаша, который откроет панель Webhooks.

    Как изменить параметры веб-перехватчика

  4. В правом верхнем углу нажмите синюю кнопку "Создать вебхук" и введите:

  5. Готово! Теперь ваш вебхук создан и включен. Вы можете создать несколько вебхуков, повторяя шаг 4.

  6. Переключитесь на крайнюю правую часть вебхука, чтобы тестировать, отключить или удалить его.

    • тест отправляет тестовое оповещение в подключенное приложение.
    • Отключение сохраняет веб-перехватчик неактивным, но видимым на панели управления.
    • delete удаляет веб-перехватчик с панели мониторинга.

Когда эти события происходят, уведомления Центра приложений публикуются в интегрированных приложениях.

Пример полезных данных вебхука

Ниже приведены примеры полезных данных веб-перехватчика JSON для:

  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, затем скопируйте созданный URL-адрес, указанный под Bin URL, и вставьте URL-адрес как веб-перехватчик в App Center.

Поддержка пользовательского вебхука

Для публикации на других платформах можно написать функцию Azure, которая адаптирует наши процессы в соответствии с требованиями платформы. Для этого создайте функцию Azure, вставьте URL-адрес в поле URL-адреса веб-перехватчика на шаге 4, а Центр приложений разместит полезные данные веб-перехватчика в этой конечной точке. Затем вы можете изменить нагрузку в соответствии с требованиями платформы.

  • Last updated on