# Уведомления Uptime Kuma на телефон: громко при падении, тихо при восстановлении

> Отправляйте уведомления Uptime Kuma о падении и восстановлении сервиса на iPhone и Android через встроенный тип Webhook. Падения приходят с высоким приоритетом, восстановления приходят тихо, истечение сертификата отправляет отдельный push, а повторные проверки не дают нестабильной проверке завалить телефон.

*26.10.2026*

<!-- source: https://pocketalert.app/ru/blog/uptime-kuma-notifications -->

Uptime Kuma хорошо замечает, что что-то упало. А вот куда попадает это уведомление, отдельный вопрос. Чаще всего его отправляют в групповой чат Telegram, канал Discord или папку с письмами, рядом со всем остальным, что весь день вибрирует в телефоне. Сообщение «восстановлено» звучит точно так же, как «упало», поэтому через пару беспокойных ночей люди отключают канал и перестают его читать.

Это руководство отправляет уведомления Uptime Kuma в Pocket Alert как push-уведомления с разными приоритетами. Падение монитора приходит с приоритетом `high`, и такое уведомление пробивается через Фокусирование на iPhone. Восстановление приходит с приоритетом `low`: оно появляется в ленте, когда вы на неё смотрите, и никого не будит. Всё делается через встроенный тип уведомлений **Webhook** в Uptime Kuma, так что ничего дополнительно устанавливать не нужно.

Всё, что описано ниже, проверено на Uptime Kuma 2.5.8, запущенном в Docker.

## Что понадобится

- Uptime Kuma 2.x. Большая часть также работает на 1.23.x, различия описаны в конце.
- Приложение Pocket Alert [на телефоне](/get-app) и аккаунт. Если его нет, [зарегистрируйтесь](/signup): для начала достаточно бесплатного тарифа.
- API-ключ из раздела [API Keys](/account/apikeys) (маршрут 1) или вебхук из раздела [Webhooks](/webhooks) (маршрут 2).

## Два способа подключения

Webhook-уведомление Uptime Kuma может отправлять данные на любой URL, либо в собственном JSON, либо в теле, которое вы напишете сами. Поэтому есть два маршрута:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th></th><th>Маршрут 1: API Pocket Alert</th><th>Маршрут 2: URL вебхука Pocket Alert</th></tr></thead>
<tbody>
<tr><th>URL отправки</th><td><code>https://api.pocketalert.app/v1/messages</code></td><td><code>https://p4a.me/wh/&lt;slug&gt;</code></td></tr>
<tr><th>Заголовок push</th><td>Ваш, например <strong>Down: Website</strong></td><td>Всегда <strong>Webhook &lt;name&gt;</strong></td></tr>
<tr><th>Падение громко, восстановление тихо</th><td>Да</td><td>Да, с собственным телом; иначе один уровень для всего</td></tr>
<tr><th>Секрет хранится в Uptime Kuma</th><td>API-ключ с полным доступом к вашему аккаунту</td><td>URL, который может только создавать push через этот вебхук</td></tr>
<tr><th>Журнал запросов в Pocket Alert</th><td>Нет</td><td>Да, в <a href="/ru/features/webhook-history">истории вебхуков</a></td></tr>
</tbody>
</table>
</div>

**Выбирайте маршрут 1**, если нужны читаемые заголовки и минимум движущихся частей. **Выбирайте маршрут 2**, если не хотите хранить полный API-ключ в Uptime Kuma (он сохраняет настройки уведомлений, включая заголовки, в базе данных в виде обычного JSON) или если хотите, чтобы каждый отправленный им запрос логировался на стороне Pocket Alert для отладки.

## Маршрут 1: отправка напрямую в API Pocket Alert

В Uptime Kuma откройте **Settings → Notifications** и нажмите **Set Up Notification**. Заполните так:

- **Notification Type:** Webhook
- **Friendly Name:** `Pocket Alert`
- **Post URL:** `https://api.pocketalert.app/v1/messages`
- **HTTP Method:** POST
- **Request Body:** Custom Body

Вставьте это в поле тела, заменив `kuma.example.com` на адрес вашего Uptime Kuma:

```
{%- assign level = "default" -%}
{%- assign title = "Uptime Kuma" -%}
{%- assign text = msg -%}
{%- if heartbeatJSON -%}
  {%- assign text = heartbeatJSON.msg | default: msg -%}
  {%- if heartbeatJSON.status == 0 -%}
    {%- assign title = "Down: " | append: monitorJSON.name -%}
    {%- assign level = "high" -%}
    {%- for tag in monitorJSON.tags -%}
      {%- if tag.name == "critical" -%}{%- assign level = "critical" -%}{%- endif -%}
    {%- endfor -%}
  {%- else -%}
    {%- assign title = "Up: " | append: monitorJSON.name -%}
    {%- assign level = "low" -%}
  {%- endif -%}
{%- elsif msg contains "will expire" -%}
  {%- assign title = "Expiring soon" -%}
{%- endif -%}
{
  "title": {{ title | json }},
  "message": {{ text | json }},
  "level": "{{ level }}",
  "actions": [
    {
      "type": "view",
      "label": "Open in Uptime Kuma",
      "value": "https://kuma.example.com/dashboard/{{ monitorJSON.id }}"
    }
  ]
}
```

Затем включите **Additional Headers** и вставьте:

```json
{
  "Token": "YOUR_API_KEY",
  "Content-Type": "application/json"
}
```

Что делает тело:

- **Тело — это шаблон Liquid.** Uptime Kuma передаёт в него `msg` (готовый текст), `monitorJSON` (монитор) и `heartbeatJSON` (проверку, которая изменила состояние). `heartbeatJSON.status` равен `0` при падении и `1` при восстановлении.
- **Фильтр `| json` записывает полную JSON-строку, включая кавычки.** Тексты ошибок и названия мониторов могут содержать кавычки и обратные слеши; с фильтром они не могут сломать запрос. Монитор с названием `Bob's "main" site` всё равно даст корректный JSON.
- **Падение — `high`, восстановление — `low`.** `high` на iPhone считается срочным и проходит через Фокусирование и отложенную сводку. `low` доставляется без того, чтобы вас прерывать.
- **Пометьте монитор тегом `critical`, чтобы сделать уведомление громче.** Добавьте в Uptime Kuma тег с именем `critical` к самым важным мониторам, и их падения будут отправляться как `critical`: такие уведомления звучат даже при выключенном беззвучном режиме и в режиме «Не беспокоить». Критические уведомления доступны в платной версии; на бесплатном тарифе они доставляются как `high`.
- **У сертификатов и тестовых сообщений нет проверки (heartbeat).** Для них push использует собственный текст Uptime Kuma. Тот же текст служит запасным, когда текст проверки пустой, как у ping-монитора при восстановлении; API отклоняет push с пустым сообщением.
- **Кнопка открывает монитор.** `/dashboard/<id>` — это страница монитора в Uptime Kuma. Для предупреждения о сертификате ID монитора нет, и кнопка открывает панель. Кнопки действий доступны в платной версии; на бесплатном тарифе API их отбрасывает, и push доставляется без них. Что ещё умеют кнопки действий, см. в разделе [кнопки действий](/features/action-buttons).

**Не пропускайте заголовок `Content-Type`.** Когда Uptime Kuma отправляет собственное тело, он помечает его как `application/x-www-form-urlencoded`, если не указано иное. Так было в моём тесте. API Pocket Alert принимает только JSON или multipart и на такой запрос отвечает `400`.

Нажмите **Test**. Push с заголовком «Uptime Kuma» и текстом «Pocket Alert Testing» должен прийти в течение нескольких секунд. Сохраните.

Вот что отправил Uptime Kuma 2.5.8 при реальном падении и восстановлении:

```json
{
  "title": "Down: Website",
  "message": "timeout of 4000ms exceeded",
  "level": "high",
  "actions": [
    { "type": "view", "label": "Open in Uptime Kuma", "value": "https://kuma.example.com/dashboard/1" }
  ]
}
```

```json
{
  "title": "Up: Website",
  "message": "200 - OK",
  "level": "low",
  "actions": [
    { "type": "view", "label": "Open in Uptime Kuma", "value": "https://kuma.example.com/dashboard/1" }
  ]
}
```

Используйте отдельный API-ключ с названием Uptime Kuma, чтобы его можно было отозвать отдельно, если этот сервер когда-нибудь скомпрометируют.

## Маршрут 2: URL вебхука Pocket Alert

Здесь Uptime Kuma отправляет собственный JSON на вебхук Pocket Alert, а шаблон на стороне Pocket Alert превращает его в push.

### Создайте вебхук

Шаблон кнопки можно задать только через API, поэтому самый быстрый способ — один вызов. Он создаёт вебхук «Uptime Kuma» с шаблоном сообщения, уровнем по умолчанию `high` (`1`) и кнопкой «Open in Uptime Kuma», а затем выводит URL для приёма:

```bash
PA_KEY='your-api-key'
KUMA_URL='https://kuma.example.com'

jq -n --arg kuma "$KUMA_URL" '{
  name: "Uptime Kuma",
  message: "%msg%",
  default_level: 1,
  actions: ([{type: "view", label: "Open in Uptime Kuma", value: ($kuma + "/dashboard/%monitor.id%")}] | tojson)
}' |
curl -sS https://api.pocketalert.app/v1/webhooks \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- |
jq -r '"Receive URL: https://p4a.me/wh/" + .url'
```

Если вам удобнее кликать, создайте его в консоли в разделе [Webhooks](/webhooks): название **Uptime Kuma**, **Default priority** High, сообщение `%msg%`. Push-уведомления будут теми же, только без кнопки.

### Направьте на него Uptime Kuma

Создайте новое уведомление типа **Webhook**, вставьте URL для приёма в поле **Post URL** и установите **Request Body** в **Preset - application/json**. Заголовки не нужны: секрет — это сам URL, поэтому относитесь к нему как к паролю. Не выбирайте пресет multipart: вебхуки Pocket Alert читают только JSON.

Вот что Uptime Kuma отправил в моей тестовой конфигурации при падении монитора (сокращено; объект `monitor` содержит около сотни полей):

```json
{
  "heartbeat": {
    "monitorID": 1,
    "status": 0,
    "time": "2026-10-31 16:09:56.331",
    "msg": "timeout of 4000ms exceeded",
    "important": true,
    "localDateTime": "2026-10-31 16:09:56"
  },
  "monitor": {
    "id": 1,
    "name": "Website",
    "url": "http://tls-target/",
    "type": "http",
    "tags": []
  },
  "msg": "[Website] [🔴 Down] timeout of 4000ms exceeded"
}
```

Шаблон `%msg%` использует поле `msg` верхнего уровня, потому что оно есть в каждом запросе. Для предупреждений о сертификатах и тестовых сообщений `heartbeat` и `monitor` равны `null`, и заполнено только `msg`. Push приходит с заголовком «Webhook Uptime Kuma» и текстом «[Website] [🔴 Down] timeout of 4000ms exceeded». Плейсхолдер с отсутствующим путём превращается в пустую строку, поэтому при предупреждении о сертификате кнопка ведёт на `/dashboard/` и всё равно работает.

### Падение громко, восстановление тихо на этом маршруте

С пресетом JSON каждый запрос получает уровень вебхука по умолчанию, поэтому восстановления приходят так же громко, как падения. Чтобы это исправить, переключите **Request Body** на **Custom Body** и передавайте поле `level` самостоятельно. Вебхуки Pocket Alert читают `level` верхнего уровня из полезной нагрузки и только потом используют уровень по умолчанию:

```
{
  "level": "{% if heartbeatJSON %}{% if heartbeatJSON.status == 0 %}high{% else %}low{% endif %}{% else %}default{% endif %}",
  "msg": {{ msg | json }},
  "monitor": { "id": "{{ monitorJSON.id }}" }
}
```

Тело сохраняет имена полей `msg` и `monitor.id`, поэтому шаблоны сообщения и кнопки вебхука работают без изменений. Вебхуки Pocket Alert читают тело как JSON независимо от его `Content-Type`, так что этому маршруту не нужен дополнительный заголовок.

## Включите для каждого монитора

Уведомление ничего не делает, пока им не пользуется монитор. Внизу формы уведомления есть два переключателя:

- **Default enabled** включает это уведомление для каждого монитора, который вы создадите с этого момента.
- **Apply on all existing monitors** добавляет его ко всем уже существующим мониторам. Выполняется один раз при сохранении и не запоминается.

Включите оба при первом сохранении. Чтобы исключить монитор, откройте его и снимите отметку с уведомления в форме редактирования.

## Предупреждения об истечении сертификата

Uptime Kuma может предупредить вас до того, как TLS-сертификат истечёт. Откройте HTTP(s)-монитор (у мониторов Keyword и JSON Query тоже есть эта опция) и отметьте **Certificate Expiry Notification** в разделе **Advanced**. Флажок неактивен, пока включена опция **Ignore TLS/SSL errors for HTTPS websites**.

Пороги задаются глобально, в **Settings → Notifications → TLS Certificate Expiry**, по умолчанию это 7, 14 и 21 день. Предупреждение уходит в те же уведомления, что и падения монитора, с текстом вида:

```text
[TLS site][https://tls-target/] server certificate tls-target will expire in 4 days
```

Тело маршрута 1 перехватывает его по условию `msg contains "will expire"` и присваивает заголовок «Expiring soon» с уровнем `default`. Uptime Kuma отправляет его один раз на каждый порог, а не при каждой проверке: в моём тесте монитор проверили 119 раз при сертификате, истекающем через четыре дня, и ушло ровно одно предупреждение.

## Как не дать нестабильному монитору завалить телефон

Три настройки монитора определяют, насколько шумит нестабильный сервис:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Настройка</th><th>Что делает</th><th>Рекомендация</th></tr></thead>
<tbody>
<tr><th>Retries</th><td>Сколько неудачных проверок помечаются как <strong>Pending</strong>, прежде чем монитор считается упавшим. Проверки в состоянии Pending не отправляют уведомлений.</td><td><code>2</code> или <code>3</code></td></tr>
<tr><th>Heartbeat Retry Interval</th><td>Секунды между проверками в состоянии Pending.</td><td><code>20</code> — <code>60</code></td></tr>
<tr><th>Resend Notification if Down X times consecutively</th><td>Повторяет уведомление о падении после стольких дополнительных неудачных проверок. <code>0</code> отправляет его один раз.</td><td><code>0</code> или значение, которое даёт 30–60 минут</td></tr>
</tbody>
</table>
</div>

При **Retries**, равном 2, в моём тесте первые две неудачные проверки помечались как pending, и только третья отправила «Down». При **Resend**, равном 3, уведомление о падении повторялось после каждых трёх дополнительных неудачных проверок, пока сервис не восстановился. Счётчик повторов считается в проверках, а не в минутах. При интервале 60 секунд значение 30 означает напоминание каждые полчаса.

Каждое падение, каждое восстановление и каждый повтор — это одно сообщение. Бесплатный тариф позволяет 50 сообщений в день, поэтому один нестабильный монитор без повторов может исчерпать лимит за полдня. Повторные проверки — самое дешёвое решение.

## Если ничего не приходит

- **Тест завершается с HTTP 400.** На маршруте 1 проверьте, что **Additional Headers** содержит `"Content-Type": "application/json"`. Без него запрос уходит как данные формы.
- **HTTP 401.** Заголовок `Token` отсутствует или ключ отозван. Создайте новый в разделе [API Keys](/account/apikeys).
- **Тест приходит, а падения нет.** Откройте монитор и проверьте, что уведомление отмечено. Также учтите: Uptime Kuma не отправляет уведомление при первой проверке монитора, если тот работает, поэтому новый монитор молчит, пока что-нибудь не изменится.
- **На маршруте 2 ничего не видно.** Откройте историю вебхука в консоли. Если запрос там есть с ошибкой, она объяснит причину: невалидный JSON или шаблон, который дал пустое сообщение. Если запросов нет вообще, значит, Uptime Kuma не смог достучаться до `p4a.me`. Также можно отправить запросы в [тестер вебхуков](/tools/webhook), чтобы увидеть, что именно отправляет Uptime Kuma.
- **Кажется, восстановление не пришло.** Уведомления `low` беззвучны. Проверьте ленту в приложении.

## FAQ

### Какая версия Uptime Kuma нужна?

Всё проверено на 2.5.8, последнем релизе на момент написания. Версия 1.23.x тоже имеет тип Webhook с Custom Body и Additional Headers, а в шаблоне доступны те же переменные `msg`, `monitorJSON` и `heartbeatJSON`. Я отрисовал тело маршрута 1 движком шаблонов, который входит в 1.23.16, и получил тот же JSON, но полный сквозной прогон выполнялся только на 2.5.8.

### Что делать, если сервер с Uptime Kuma упадёт?

Тогда оповещение никто не отправит. Uptime Kuma не может сообщить о собственном падении, поэтому запустите что-то снаружи, что это заметит: проверку с другой машины или хостед-монитор. На странице [мониторинга доступности](/use-cases/uptime-monitoring) перечислены хостед-мониторы, которые работают с вебхуками Pocket Alert.

### Можно ли отправлять разные мониторы на разные телефоны?

Да, на платном тарифе. Создайте уведомление для каждой группы с разным `device_id` в теле (маршрут 1) или отдельный вебхук с собственным устройством (маршрут 2), и отметьте нужное уведомление на каждом мониторе. На бесплатном тарифе есть одно устройство и один вебхук, поэтому телефон один.

### Работает ли это для ping-, port- и DNS-мониторов?

Да. Тело использует только имя и ID монитора, а также статус и сообщение проверки, которые есть у всех типов мониторов. У некоторых типов, в том числе ping, сообщение при успешной проверке пустое; тогда тело использует собственный текст Uptime Kuma. Кнопка ведёт на страницу монитора в Uptime Kuma, а не на проверяемый адрес, поэтому работает, даже если адрес не является URL.

### Я уже использую это для Proxmox. Можно ли использовать один API-ключ?

Можно, но лучше дать Uptime Kuma собственный ключ, чтобы отзыв одного не сломал другой. В [руководстве по Proxmox](/blog/proxmox-alerts) описаны оповещения о бэкапах и дисках из той же домашней лаборатории.

[Создайте бесплатный аккаунт](/signup), вставьте тело в уведомление Webhook и пусть следующее падение дойдёт до телефона, а восстановление тихо подождёт в ленте.
