# Создание веб-перехватчиков

Вы можете создавать веб-перехватчики для подписки на определенные события, которые происходят в GitHub.

## О создании веб-перехватчиков

Вы можете создавать веб-перехватчики для подписки на определенные события, GitHub происходящие в репозитории, организации, учетной записи, GitHub Marketplaceучетной записиGitHub Sponsorsили учетной записи. GitHub App

Дополнительные сведения о различных типах веб-перехватчиков см. в разделе [Типы веб-перехватчиков](/ru/webhooks/types-of-webhooks).

Полный список событий веб-перехватчика см. в разделе [События и полезные данные веб-перехватчика](/ru/webhooks/webhook-events-and-payloads).

## Создание веб-перехватчика репозитория

Вы можете создать веб-перехватчик для подписки на события, происходящие в определенном репозитории. Вы должны быть владельцем репозитория или иметь доступ администратора в репозитории для создания веб-перехватчиков в этом репозитории.

Веб-интерфейс или REST API можно использовать GitHub для создания веб-перехватчика репозитория. Дополнительные сведения об использовании REST API для создания веб-перехватчика репозитория см. в разделе [Конечные точки REST API для веб-перехватчиков репозитория](/ru/rest/repos/webhooks#create-a-repository-webhook).

1. На GitHubперейдите на главную страницу репозитория.
2. Под именем репозитория щелкните **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg> Settings**. Если вкладка "Параметры" не отображается, выберите **раскрывающееся меню <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>** и нажмите кнопку **"Параметры**".

   ![Снимок экрана: заголовок репозитория с вкладками. Вкладка "Параметры" выделена темно-оранжевым контуром.](/assets/images/help/repository/repo-actions-settings.png)
3. На левой боковой панели щелкните **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-webhook" aria-label="webhook" role="img"><path d="M5.5 4.25a2.25 2.25 0 0 1 4.5 0 .75.75 0 0 0 1.5 0 3.75 3.75 0 1 0-6.14 2.889l-2.272 4.258a.75.75 0 0 0 1.324.706L7 7.25a.75.75 0 0 0-.309-1.015A2.25 2.25 0 0 1 5.5 4.25Z"></path><path d="M7.364 3.607a.75.75 0 0 1 1.03.257l2.608 4.349a3.75 3.75 0 1 1-.628 6.785.75.75 0 0 1 .752-1.299 2.25 2.25 0 1 0-.033-3.88.75.75 0 0 1-1.03-.256L7.107 4.636a.75.75 0 0 1 .257-1.03Z"></path><path d="M2.9 8.776A.75.75 0 0 1 2.625 9.8 2.25 2.25 0 1 0 6 11.75a.75.75 0 0 1 .75-.751h5.5a.75.75 0 0 1 0 1.5H7.425a3.751 3.751 0 1 1-5.55-3.998.75.75 0 0 1 1.024.274Z"></path></svg> Webhooks**.
4. Щелкните **Add webhook** (Добавить веб-перехватчик).
5. В поле "URL-адрес полезных данных" введите URL-адрес, в котором вы хотите получать полезные данные.
6. При необходимости выберите **раскрывающееся меню типа** контента и выберите формат данных для получения полезных данных веб-перехватчика.
   * **application/json доставляет полезные данные JSON** непосредственно в тексте `POST` запроса.
   * **application/x-www-form-urlencoded** отправляет полезные данные JSON в качестве параметра `payload`формы.
7. При необходимости в разделе "Секрет" введите строку для использования в качестве `secret` ключа. Следует выбрать случайную строку текста с высокой энтропией. Секрет веб-перехватчика можно использовать, чтобы ограничить входящие запросы только теми, из GitHubкоторых происходит. Дополнительные сведения см. в разделе [Проверка доставки веб-перехватчика](/ru/webhooks/using-webhooks/validating-webhook-deliveries).
8. В разделе "Какие события вы хотите активировать этот веб-перехватчик?", выберите события веб-перехватчика, которые вы хотите получить. Вы должны подписаться только на нужные события веб-перехватчика.
9. Если вы выбрали **"Разрешить мне выбрать отдельные события**", выберите события, которые вы хотите активировать веб-перехватчик.
10. Чтобы сделать веб-перехватчик активным сразу после добавления конфигурации, нажмите кнопку **"Активный**".
11. Щелкните **Add webhook** (Добавить веб-перехватчик).

После создания нового веб-перехватчика вы отправите простое GitHub событие, чтобы сообщить вам, `ping` что вы правильно настроили веб-перехватчик. Дополнительные сведения см. в разделе [События и полезные данные веб-перехватчика](/ru/webhooks/webhook-events-and-payloads#ping).

## Создание веб-перехватчика организации

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

Веб-интерфейс или REST API можно использовать GitHub для создания веб-перехватчика организации. Дополнительные сведения об использовании REST API для создания веб-перехватчика организации см. в разделе [Конечные точки REST API для веб-перехватчиков организации](/ru/rest/orgs/webhooks#create-an-organization-webhook).

1. В правом верхнем углу любой страницы на GitHub, нажмите на свою фотографию профиля.
2. Щелкните **Your organizations** (Ваши организации).
3. Справа от организации нажмите кнопку **"Параметры**".
4. На левой боковой панели щелкните **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-webhook" aria-label="webhook" role="img"><path d="M5.5 4.25a2.25 2.25 0 0 1 4.5 0 .75.75 0 0 0 1.5 0 3.75 3.75 0 1 0-6.14 2.889l-2.272 4.258a.75.75 0 0 0 1.324.706L7 7.25a.75.75 0 0 0-.309-1.015A2.25 2.25 0 0 1 5.5 4.25Z"></path><path d="M7.364 3.607a.75.75 0 0 1 1.03.257l2.608 4.349a3.75 3.75 0 1 1-.628 6.785.75.75 0 0 1 .752-1.299 2.25 2.25 0 1 0-.033-3.88.75.75 0 0 1-1.03-.256L7.107 4.636a.75.75 0 0 1 .257-1.03Z"></path><path d="M2.9 8.776A.75.75 0 0 1 2.625 9.8 2.25 2.25 0 1 0 6 11.75a.75.75 0 0 1 .75-.751h5.5a.75.75 0 0 1 0 1.5H7.425a3.751 3.751 0 1 1-5.55-3.998.75.75 0 0 1 1.024.274Z"></path></svg> Webhooks**.
5. Щелкните **Add webhook** (Добавить веб-перехватчик).
6. В поле "URL-адрес полезных данных" введите URL-адрес, в котором вы хотите получать полезные данные.
7. При необходимости выберите **раскрывающееся меню типа** контента и выберите формат данных для получения полезных данных веб-перехватчика.
   * **application/json доставляет полезные данные JSON** непосредственно в тексте `POST` запроса.
   * **application/x-www-form-urlencoded** отправляет полезные данные JSON в качестве параметра `payload`формы.
8. При необходимости в разделе "Секрет" введите строку для использования в качестве `secret` ключа. Следует выбрать случайную строку текста с высокой энтропией. Секрет веб-перехватчика можно использовать, чтобы ограничить входящие запросы только теми, из GitHubкоторых происходит. Дополнительные сведения см. в разделе [Проверка доставки веб-перехватчика](/ru/webhooks/using-webhooks/validating-webhook-deliveries).
9. В разделе "Какие события вы хотите активировать этот веб-перехватчик?", выберите типы веб-перехватчиков, которые вы хотите получить. Вы должны подписаться только на нужные события веб-перехватчика.
10. Если вы выбрали **"Разрешить мне выбрать отдельные события**", выберите события, которые будут активировать веб-перехватчик.
11. Чтобы сделать веб-перехватчик активным сразу после добавления конфигурации, нажмите кнопку **"Активный**".
12. Щелкните **Add webhook** (Добавить веб-перехватчик).

После создания нового веб-перехватчика вы отправите простое GitHub событие, чтобы сообщить вам, `ping` что вы правильно настроили веб-перехватчик. Дополнительные сведения см. в разделе [События и полезные данные веб-перехватчика](/ru/webhooks/webhook-events-and-payloads#ping).

## GitHub Marketplace Создание веб-перехватчика

Вы можете создать веб-перехватчик для подписки на события, связанные с приложением, опубликованным в GitHub Marketplace. Только владелец приложения или диспетчер приложений для приложения может создать GitHub Marketplace веб-перехватчик.

1. Перейдите на [GitHub Marketplace страницу описания](https://github.com/marketplace/manage).
2. Рядом с списком GitHub Marketplace , для которого требуется просмотреть поставки веб-перехватчика, нажмите кнопку **"Управление списком**".
3. На боковой панели щелкните **веб-перехватчик**.
4. В поле "URL-адрес полезных данных" введите URL-адрес, в котором вы хотите получать полезные данные.
5. При необходимости выберите **раскрывающееся меню типа** контента и выберите формат данных для получения полезных данных веб-перехватчика.
   * **application/json доставляет полезные данные JSON** непосредственно в тексте `POST` запроса.
   * **application/x-www-form-urlencoded** отправляет полезные данные JSON в качестве параметра `payload`формы.
6. При необходимости в разделе "Секрет" введите строку для использования в качестве `secret` ключа. Следует выбрать случайную строку текста с высокой энтропией. Секрет веб-перехватчика можно использовать, чтобы ограничить входящие запросы только теми, из GitHubкоторых происходит. Дополнительные сведения см. в разделе [Проверка доставки веб-перехватчика](/ru/webhooks/using-webhooks/validating-webhook-deliveries).
7. Чтобы сделать веб-перехватчик активным сразу после добавления конфигурации, нажмите кнопку **"Активный**".
8. Нажмите **Создать веб-перехватчик**.

После создания нового веб-перехватчика вы отправите простое GitHub событие, чтобы сообщить вам, `ping` что вы правильно настроили веб-перехватчик. Дополнительные сведения см. в разделе [События и полезные данные веб-перехватчика](/ru/webhooks/webhook-events-and-payloads#ping).

## GitHub Sponsors Создание веб-перехватчика

Вы можете создать веб-перехватчик для подписки на события, связанные с спонсорством. Только владелец спонсируемой учетной записи может создавать веб-перехватчики спонсорства для этой учетной записи. Дополнительные сведения о событии, на которое подписан веб-перехватчик спонсора, см. в [`sponsorship` событии](/ru/webhooks/webhook-events-and-payloads#sponsorship) веб-перехватчика.

1. В правом верхнем углу любой страницы щелкните рисунок профиля, а затем выберите **"Спонсоры**".
2. Рядом с учетной записью, для которой вы хотите создать веб-перехватчик, нажмите кнопку **"Панель мониторинга**".
3. На левой боковой панели нажмите **Веб-перехватчики**.
4. Щелкните **Add webhook** (Добавить веб-перехватчик).
5. В поле "URL-адрес полезных данных" введите URL-адрес, в котором вы хотите получать полезные данные.
6. При необходимости выберите **раскрывающееся меню типа** контента и выберите формат данных для получения полезных данных веб-перехватчика.
   * **application/json доставляет полезные данные JSON** непосредственно в тексте `POST` запроса.
   * **application/x-www-form-urlencoded** отправляет полезные данные JSON в качестве параметра `payload`формы.
7. При необходимости в разделе "Секрет" введите строку для использования в качестве `secret` ключа. Следует выбрать случайную строку текста с высокой энтропией. Секрет веб-перехватчика можно использовать, чтобы ограничить входящие запросы только теми, из GitHubкоторых происходит. Дополнительные сведения см. в разделе [Проверка доставки веб-перехватчика](/ru/webhooks/using-webhooks/validating-webhook-deliveries).
8. Чтобы сделать веб-перехватчик активным сразу после добавления конфигурации, нажмите кнопку **"Активный**".
9. Нажмите **Создать веб-перехватчик**.

## Создание веб-перехватчиков для GitHub App

Владелец GitHub App приложения может подписаться на события веб-перехватчика, чтобы получать уведомления при каждом возникновении определенных событий. Если владелец приложения назначил всех диспетчеров приложений для приложения GitHub App, руководители приложений также могут подписаться на события веб-перехватчика. Дополнительные сведения см. в разделе [Использование вебхуков с приложениями GitHub](/ru/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps).

Каждый из них GitHub App имеет один веб-перехватчик. Вы можете настроить веб-перехватчик при регистрации GitHub Appили изменить конфигурацию веб-перехватчика для существующей GitHub App регистрации.

Дополнительные сведения о настройке веб-перехватчика при регистрации GitHub Appсм. в разделе [Регистрация приложения GitHub](/ru/apps/creating-github-apps/registering-a-github-app/registering-a-github-app).

Чтобы настроить веб-перехватчик для существующей GitHub App регистрации:

1. В правом верхнем углу любой страницы на GitHubщелкните рисунок профиля.
2. Перейдите к настройкам учетной записи.
   * Для приложения, принадлежащих личная учетная запись, нажмите кнопку **"Параметры**".
   * Для приложения, принадлежащих организации:
     1. Щелкните **Your organizations** (Ваши организации).
     2. Справа от организации нажмите кнопку **"Параметры**".
3. На левой боковой панели щелкните **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-code" aria-label="code" role="img"><path d="m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z"></path></svg> Параметры разработчика**.
4. На левой боковой панели щелкните **GitHub Apps**.
5. Рядом с GitHub App нужным веб-перехватчиком нажмите кнопку **"Изменить**".
6. В разделе "Веб-перехватчик" выберите **"Активный**".
7. В поле "URL-адрес веб-перехватчика" введите URL-адрес, в котором вы хотите получать полезные данные.
8. При необходимости в разделе "Секрет веб-перехватчика" введите строку для использования в качестве `secret` ключа. Следует выбрать случайную строку текста с высокой энтропией. Секрет веб-перехватчика можно использовать, чтобы ограничить входящие запросы только теми, из GitHubкоторых происходит. Дополнительные сведения см. в разделе [Проверка доставки веб-перехватчика](/ru/webhooks/using-webhooks/validating-webhook-deliveries).
9. Нажмите кнопку **Сохранить изменения**.
10. На боковой панели щелкните **"Разрешения" и "События**".
11. Определенные события веб-перехватчика, которые можно выбрать для регистрации GitHub App, определяются типом разрешений, выбранных для вашего приложения. Сначала необходимо выбрать разрешения, которые требуется приложению, а затем подписаться на события веб-перехватчика, связанные с этим набором разрешений.

    В разделах "Разрешения репозитория", "Разрешения организации" и "Разрешения учетной записи" выберите разрешения, необходимые для событий, на которые будет подписано ваше приложение. Дополнительные сведения см. в разделе [Выбор разрешений для приложения GitHub](/ru/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app). Дополнительные сведения о том, что следует учитывать при изменении разрешений, см. в разделе ["Изменение GitHub App регистрации](/ru/apps/maintaining-github-apps/modifying-a-github-app-registration#changing-the-permissions-of-a-github-app)".
12. В разделе "Подписка на события" выберите события веб-перехватчика, которые вы хотите GitHub App получить.
13. Нажмите кнопку **Сохранить изменения**.

Для создания веб-перехватчика GitHub Appможно также использовать REST API. Дополнительные сведения см. в разделе [Конечные точки REST API для GitHub App вебхуков](/ru/rest/apps/webhooks).

## Дополнительные материалы

* [Сведения о веб-перехватчиках](/ru/webhooks/about-webhooks)
* [Обработка доставки веб-перехватчика](/ru/webhooks/using-webhooks/handling-webhook-deliveries)