> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tenderly.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Как использовать Webhooks для оповещений

> Узнайте, как создать свой первый webhook и начать получать события оповещений.

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

### Добавление webhook как назначения оповещения

<Note>
  Чтобы продолжить, [войдите в свой аккаунт](https://dashboard.tenderly.co/) или [создайте бесплатный
  аккаунт](https://dashboard.tenderly.co/register), если у вас его ещё нет.
</Note>

После входа создайте новый [проект Tenderly](/platform/account/projects/overview) или выберите существующий, в котором вы хотите создать webhook.

В меню слева перейдите на вкладку **Alerts → Destinations**, где вы увидите список [всех доступных назначений](/monitoring/alerts/destinations/overview).

<Frame caption="Переход в раздел Destination">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-1.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=5081e986e0f1637eecc285aafacefd4f" alt="Navigating to the Destination section" width="3186" height="1932" data-path="images/alerts/how-to-use-webhooks-for-alerting-1.webp" />
</Frame>

Чтобы создать назначение оповещения webhook, нажмите на карточку Webhook, которая откроет модальное окно конфигурации. Вам будет предложено настроить следующие опции:

* **Webhook name** — должно быть уникальным и не может быть изменено позже
* **Webhook URL** — URL, куда вы будете получать события в реальном времени от Tenderly
* **Description** — необязательный параметр, но вы можете использовать его, чтобы предоставить больше информации о конфигурации webhook

<Frame caption="Модальное окно Add Webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-2.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=3327f3664a1f1ec5b9ecbc642c0081fa" alt="Add Webhook Modal" width="1322" height="1210" data-path="images/alerts/how-to-use-webhooks-for-alerting-2.webp" />
</Frame>

Если вы нажмёте на ссылку **Advanced Configuration**, откроется модальное окно с фрагментами кода JavaScript, Python или Go, которые вы можете использовать для настройки собственного webhook.

<Frame caption="Модальное окно Advanced Configuration для Webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-3.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=992dec434e4fd86fdff9c2f61b70a36d" alt="Webhook Modal Advanced Configuration Modal" width="2650" height="1472" data-path="images/alerts/how-to-use-webhooks-for-alerting-3.webp" />
</Frame>

Чтобы проверить, что указанный URL может принимать события от Tenderly, нажмите кнопку **Send test webhook** — заранее определённая тестовая полезная нагрузка будет отправлена на вашу конечную точку.

<Frame caption="Отправка тестового webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-4.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=a965f4441f9ae179104989380c43b192" alt="Send Test Webhook" width="916" height="822" data-path="images/alerts/how-to-use-webhooks-for-alerting-4.webp" />
</Frame>

Если всё работает как ожидается и вы получили событие, нажмите кнопку **Add Webhook**. Это действие добавит новое назначение webhook в список **Active Destinations**.

<Frame caption="Новый webhook добавлен в список активных назначений">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-5.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=396c2f24af38b9b0fef4f638e9ab4a09" alt="New Webhook is added to the active destinations list" width="2208" height="570" data-path="images/alerts/how-to-use-webhooks-for-alerting-5.webp" />
</Frame>

Нажатие на кнопку справа откроет страницу обзора webhook. Здесь вы можете найти информацию о статусе webhook, URL, дате создания, секретных ключах подписи и т. д.

<Frame caption="Страница Webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-6.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=ce7941e7f04bf69c9ecb4c9cd2287f85" alt="Webhook Page" width="3186" height="1932" data-path="images/alerts/how-to-use-webhooks-for-alerting-6.webp" />
</Frame>

Вы также можете выполнять другие действия со своими webhook, такие как включение/отключение webhook или изменение существующей конфигурации.

**Включить/отключить Webhook:** переключение статуса webhook между активным и неактивным.

**Удалить Webhook:** удаление webhook из вашего проекта Tenderly. Удаление webhook — это постоянное действие, которое нельзя отменить.

<Frame caption="Опции Webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-7.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=f5b584ed5ca779c0d021692d1f3129f6" alt="Webhook Options" width="1084" height="402" data-path="images/alerts/how-to-use-webhooks-for-alerting-7.webp" />
</Frame>

**Отправить тестовый запрос:** проверьте функциональность webhook, отправив тестовое событие на указанный URL, указав хеш транзакции и её сеть.

<Frame caption="Модальное окно Test Webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-8.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=31d30fd1edfa75c3c8da5d280c6db2ef" alt="Test Webhook Modal" width="1312" height="716" data-path="images/alerts/how-to-use-webhooks-for-alerting-8.webp" />
</Frame>

**Редактировать Webhook:** изменение конфигурации существующего webhook, например URL или описания.

<Frame caption="Модальное окно Edit Webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-9.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=c5993f7e59b7a248710729b610db5332" alt="Edit Webhook Modal" width="1316" height="774" data-path="images/alerts/how-to-use-webhooks-for-alerting-9.webp" />
</Frame>

### История выполнения webhook

На странице обзора webhook нажмите Execution History, чтобы увидеть полезную нагрузку транзакции, отправленную на указанный URL webhook, и ответ от конечной точки webhook.

<Frame caption="Ручное срабатывание webhook после нажатия кнопки Test Webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-10.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=19e5e4ce268469c2ab898b32ae45fd93" alt="Manually Triggered Webhook After Clicking on Test Webhook Button" width="1042" height="610" data-path="images/alerts/how-to-use-webhooks-for-alerting-10.webp" />
</Frame>

Выполнение webhook может иметь несколько статусов:

* **Success:** webhook был успешно выполнен, и событие было доставлено на указанный URL.
* **Failed:** webhook не удалось выполнить из-за ошибки, такой как проблема с соединением, ошибка в URL и т. д. Проверьте содержимое ответа, чтобы понять причину ошибки, или обратитесь в нашу поддержку.
* **Pending:** webhook находится в процессе выполнения и ещё не завершён.
* **Retry:** выполнение webhook не удалось, но будет повторено не более 5 раз, пока статус не изменится на Success или Failed.
* **Skipped:** webhook не был выполнен, поскольку был отключён.

<Frame caption="Страница выполнения webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-11.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=b0c46e22e2546272ac16ef5ba3a1d17b" alt="Webhook Execution Page" width="2734" height="1820" data-path="images/alerts/how-to-use-webhooks-for-alerting-11.webp" />
</Frame>

Вы также можете просмотреть предыдущие выполнения webhook, применив различные фильтры, такие как **Filter by Status** и **Select a Date Range**.

<Frame caption="Страница истории выполнения webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-12.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=8d0820aced9bbbaf657448b5889b647d" alt="Webhook Execution History Page" width="2600" height="900" data-path="images/alerts/how-to-use-webhooks-for-alerting-12.webp" />
</Frame>

<Frame caption="Выпадающий список Select Webhook Status">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-13.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=d713943ca9d54b5367f1fcebb3efb4b1" alt="Select Webhook Status Dropdown" width="372" height="580" data-path="images/alerts/how-to-use-webhooks-for-alerting-13.webp" />
</Frame>

<Frame caption="Выпадающий список Select Date Range">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-14.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=2498dc8ea3bf70411a72e17ff33671c3" alt="Select Date Range Dropdown" width="2572" height="1234" data-path="images/alerts/how-to-use-webhooks-for-alerting-14.webp" />
</Frame>

### Подключение webhook к оповещению

Когда конечная точка webhook настроена, вы можете добавить её как назначение к любому из ваших оповещений.

<Info>
  [Следуйте этому руководству](/monitoring/alerts/tutorials/quickstart), чтобы узнать, как настроить оповещение.
</Info>

<Frame caption="Добавление webhook как назначения к правилу оповещения">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-15.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=2f3702b3cb1406ef17bd9596e34ed555" alt="Adding a Webhook as a Destination to the Alert Rule" width="3180" height="2022" data-path="images/alerts/how-to-use-webhooks-for-alerting-15.webp" />
</Frame>

Когда вы создадите правило оповещения, вы будете перенаправлены на следующую страницу:

<Frame caption="Правило оповещения с webhook в качестве назначения">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-16.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=93b904f96c99f499a29d1f7d5ad7095c" alt="Alert Rule with a Webhook as a Destination" width="3350" height="2168" data-path="images/alerts/how-to-use-webhooks-for-alerting-16.webp" />
</Frame>

Если ваше оповещение включено, вы начнёте получать события на конечную точку webhook.

<Frame caption="Страница истории выполнения webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-17.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=7cb913db45bfbcfaf688ca0634da2169" alt="Webhook Execution History Page" width="3040" height="1962" data-path="images/alerts/how-to-use-webhooks-for-alerting-17.webp" />
</Frame>

В этом примере мы использовали [https://webhook.site](https://webhook.site/), чтобы создать временную конечную точку webhook и протестировать, как работают webhook Tenderly. Ниже приведено изображение полезной нагрузки, успешно отправленной на webhook.

<Frame caption="Успешные выполнения webhook">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/alerts/how-to-use-webhooks-for-alerting-18.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=5d0fae3a15e01503b31a57e87efe72a1" alt="Successful Webhook Executions" width="3354" height="1932" data-path="images/alerts/how-to-use-webhooks-for-alerting-18.webp" />
</Frame>