# Push-уведомления Klipper: оповещения о печати на телефон

> Получайте push-уведомление, когда печать в Klipper завершилась, сорвалась или приостановлена. Встроенный notifier Moonraker и вебхук Pocket Alert: без плагинов, один блок настроек.

*09.10.2026*

<!-- source: https://pocketalert.app/ru/blog/klipper-print-notifications -->

Двенадцатичасовая печать не требует, чтобы вы стояли рядом. Ей нужно, чтобы вы узнали о ней в нужный момент: когда она закончится и, что важнее, когда остановится.

Klipper уже умеет сообщать о том и о другом. В Moonraker, API-сервере, на котором работают Mainsail и Fluidd, есть встроенный notifier: он срабатывает на события печати и отправляет их через [Apprise](https://github.com/caronc/apprise). Укажите ему вебхук Pocket Alert, и каждая завершённая, сорвавшаяся, отменённая или приостановленная печать придёт на телефон push-уведомлением. Без плагина, без дополнительного сервиса на Raspberry Pi, один блок настроек.

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

- Принтер с Klipper и Moonraker. Если Mainsail или Fluidd открываются в браузере, Moonraker у вас уже есть.
- Бесплатный аккаунт [Pocket Alert](/) и приложение на [iPhone или Android](/get-app).
- Около пяти минут.

## Шаг 1. Создайте вебхук в Pocket Alert

Откройте [Webhooks](/webhooks) на панели и создайте новый вебхук:

- **Name**: название принтера, например `Voron 2.4`. Оно становится заголовком push-уведомления (`Webhook Voron 2.4`), поэтому при нескольких принтерах сразу видно, какому нужно внимание.
- **Application** и **Device**: куда отправлять уведомление.
- **Message**: вставьте этот шаблон:

```
%title%
%message%
```

Сохраните и скопируйте URL вебхука. Он выглядит так: `https://p4a.me/wh/<your-webhook-id>`.

Зачем нужен этот шаблон: Moonraker передаёт каждое уведомление в Apprise, а JSON-notifier Apprise отправляет небольшой payload такого вида:

```json
{
  "version": "1.0",
  "title": "❌ Print error",
  "message": "3DBenchy.gcode Move out of range: 235.000 0.000 0.200 [0.000]",
  "attachments": [],
  "type": "info",
  "level": "high"
}
```

Каждый `%key%` в шаблоне заменяется соответствующим полем из JSON. В push заголовок выводится первой строкой, а сообщение под ним. Подробнее о путях в шаблонах читайте в статье [Create your first webhook URL](/blog/create-your-first-webhook-url).

## Шаг 2. Добавьте notifier'ы в moonraker.conf

Откройте `moonraker.conf`: в Mainsail это раздел **Machine**, в Fluidd: **Configuration**. Добавьте в конец файла три секции. Замените `YOUR_WEBHOOK_ID` на идентификатор из URL вебхука.

```ini
[notifier pocketalert_done]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID
events: complete
title: ✅ Print complete
body: {event_args[1].filename}

[notifier pocketalert_fail]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: error, cancelled
title: ❌ Print {event_name}
body: {event_args[1].filename} {event_args[1].message}

[notifier pocketalert_pause]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: paused
title: ⏸ Print paused
body: {event_args[1].filename}: check the printer
```

Что делает каждая часть:

- **`jsons://`** это JSON-notifier Apprise поверх HTTPS. Он отправляет payload выше на ваш вебхук.
- **`events`** выбирает состояния печати, которые запускают секцию. Moonraker знает `started`, `complete`, `error`, `cancelled`, `paused` и `resumed`.
- **`?:level=high`** говорит Apprise добавить `"level": "high"` в JSON. Pocket Alert читает это поле и отправляет push с высоким приоритетом: на iPhone такое уведомление приходит как срочное и проходит через режимы Фокусирование. У секции «complete» уровня нет, поэтому она приходит как обычный push.
- **`{event_args[1]}`** это состояние задания после события. Оно повторяет объект `print_stats` Klipper: `filename` это G-code файл, `message` это текст ошибки Klipper, когда печать срывается.
- **`{event_name}`** это событие, которое сработало. Поэтому одна секция покрывает и `error`, и `cancelled`, а заголовок всё равно говорит, что именно произошло.

## Шаг 3. Перезапустите Moonraker и проверьте

Перезапустите Moonraker из меню питания в Mainsail или Fluidd либо по SSH:

```bash
sudo systemctl restart moonraker
```

Прежде чем тратить пластик на тестовую печать, проверьте вебхук через curl. Эта команда отправляет тот же JSON, что и Apprise:

```bash
curl -X POST https://p4a.me/wh/YOUR_WEBHOOK_ID \
  -H 'Content-Type: application/json' \
  -d '{"title":"❌ Print error","message":"test.gcode Move out of range","level":"high"}'
```

Если телефон завибрировал, часть Pocket Alert работает. Теперь запустите небольшую печать и отмените её после первого слоя: через несколько секунд должно прийти `❌ Print cancelled`.

## Что приходит на телефон

Сорвавшаяся ночью печать выглядит на экране блокировки так:

```
Webhook Voron 2.4
❌ Print error
3DBenchy.gcode Move out of range: 235.000 0.000 0.200 [0.000]
```

Вы знаете, какой принтер, какой файл и почему он остановился, ещё до того, как разблокируете телефон.

## Настройте под себя

Всё ниже делается небольшой правкой того же файла.

- **Тихо фиксируйте старт печати.** Добавьте секцию с `events: started` и `?:level=silent`. Старт сохранится в истории сообщений без звука.
- **Просыпайтесь от сбоев.** Замените `?:level=high` на `?:level=critical` в секции ошибок. На Android критическое оповещение пробивается через режим «Не беспокоить». Критические уведомления доступны в платном тарифе; на бесплатном тарифе сообщение всё равно придёт с высоким приоритетом. Подробности в статье [critical alerts](/use-cases/critical-alerts).
- **Несколько принтеров.** Один вебхук на каждый принтер, названный по имени машины. Заголовок push подскажет, какой принтер остановился.
- **Уведомления из своих макросов.** У Moonraker есть событие `gcode`, поэтому макрос Klipper может отправить любой текст. Это удобно для смены филамента или датчика окончания пластика.

В `moonraker.conf`:

```ini
[notifier pocketalert_macro]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: gcode
title: 🧵 Printer needs you
body: {event_message}
```

В `printer.cfg`:

```ini
[gcode_macro NOTIFY_FILAMENT_CHANGE]
gcode:
  {action_call_remote_method("notify",
                             name="pocketalert_macro",
                             message="Filament change needed")}
```

Вызывайте `NOTIFY_FILAMENT_CHANGE` из макроса `M600` или из `runout_gcode` датчика филамента.

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

- **Откройте вебхук на панели.** [История вебхуков](/features/webhook-history) фиксирует каждый вызов вместе с исходным payload. Если записей нет, Moonraker не смог достучаться до Pocket Alert. Запись с ошибкой подскажет причину.
- **Посмотрите `moonraker.log`.** Moonraker пишет туда ошибки notifier'а и версию установленного Apprise. На большинстве установок файл лежит в `~/printer_data/logs/moonraker.log`.
- **Пустые строки в push.** Ключи шаблона должны совпадать с payload Apprise: `%title%` и `%message%`, а не `%body%`.

## Почему не плагин?

Telegram-боты и сервисы удалённого доступа для Klipper умеют больше: снимки с камеры, таймлапсы, удалённое управление. Но они добавляют на Raspberry Pi ещё один сервис, который нужно устанавливать и обновлять. Если вам нужно «сообщи, когда закончится, разбуди, если сорвётся», Moonraker уже сам отправляет уведомления, а Pocket Alert лишь принимает их.

А если принтер стоит рядом с [домашней лабораторией](/use-cases/homelab-alerts), его оповещения попадают в то же приложение, что и уведомления о сервере, бэкапах и cron-задачах: с одной историей и теми же уровнями приоритета.

## FAQ

### Нужно ли что-то устанавливать на Raspberry Pi?

Нет. Notifier входит в состав Moonraker, а Apprise устанавливается вместе с ним как зависимость. Вам нужно только отредактировать `moonraker.conf` и перезапустить Moonraker.

### Работает ли это с Mainsail и Fluidd?

Да. Оба интерфейса работают с Moonraker, а notifier находится в самом Moonraker, поэтому настройка одинаковая. Редактировать `moonraker.conf` можно из любого из них.

### Можно ли получать уведомления с нескольких принтеров?

Да. Создайте по одному вебхуку на каждый принтер и назовите его по имени машины. Название вебхука становится заголовком push-уведомления.

### Разбудит ли меня сорвавшаяся ночью печать?

С `level=high` push приходит на iPhone как срочное уведомление и проходит через Фокусирование. Чтобы пробиться через «Не беспокоить» на Android, используйте `level=critical` на платном тарифе.

### Это бесплатно?

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

[Создайте вебхук](/webhooks), вставьте настройки, и следующая печать сообщит, когда она закончится.
