# Klipper のプッシュ通知：印刷の完了・失敗をスマホで受け取る

> Klipper の印刷が完了・失敗・一時停止したときにプッシュ通知を受け取れます。Moonraker の標準通知機能と Pocket Alert の Webhook を使い、プラグインなし、設定ブロック 1 つで完了します。

*09.10.2026*

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

12 時間かかる印刷に、そばで付き添っている必要はありません。必要なのは、完了した瞬間を知ることです。そして、より重要なのは、途中で止まったことに気づくことです。

Klipper はその両方を通知できます。Mainsail や Fluidd の裏側で動く API サーバー Moonraker には標準の通知機能があり、印刷イベントに応じて [Apprise](https://github.com/caronc/apprise)経由で送信します。その送信先に Pocket Alert の Webhook を指定すると、完了・失敗・キャンセル・一時停止のすべての印刷がスマホにプッシュ通知として届きます。プラグインは不要で、Raspberry Pi に追加のサービスを入れる必要もなく、設定ブロック 1 つで済みます。

## 必要なもの

- Moonraker を動かしている Klipper 搭載のプリンター。ブラウザで Mainsail や Fluidd を開けるなら、Moonraker は入っています。
- 無料の [Pocket Alert](/) アカウントと、[iPhone または Android](/get-app) スマホのアプリ。
- 約 5 分の時間。

## ステップ 1：Pocket Alert で Webhook を作成する

ダッシュボードで [Webhooks](/webhooks) を開き、新しい Webhook を作成します。

- **名前**：プリンターの名前（例：`Voron 2.4`）。この名前がプッシュ通知のタイトル（`Webhook Voron 2.4`）になるので、プリンターが複数あっても、どれが対応を必要としているか一目でわかります。
- **アプリケーション**と**デバイス**：通知の送信先。
- **メッセージ**：次のテンプレートを貼り付けます。

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

保存して Webhook の URL をコピーします。形式は `https://p4a.me/wh/<your-webhook-id>` です。

このテンプレートにする理由：Moonraker は各通知を Apprise に渡し、Apprise の JSON 通知機能は次のような小さなペイロードを送信します。

```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 の対応するフィールドの値に置き換えられます。プッシュ通知では 1 行目にタイトル、その下にメッセージが表示されます。テンプレートのパスの詳細は [最初の Webhook URL を作成する](/blog/create-your-first-webhook-url) をご覧ください。

## ステップ 2：moonraker.conf に通知設定を追加する

`moonraker.conf` を開きます。Mainsail では **Machine**、Fluidd では **Configuration** の中にあります。ファイルの末尾に次の 3 つのセクションを追加してください。`YOUR_WEBHOOK_ID` は、Webhook の URL に含まれる ID に置き換えます。

```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://`**：HTTPS で JSON を送信する Apprise の通知機能です。上記のペイロードを Webhook に送信します。
- **`events`**：セクションを発動させる印刷の状態を指定します。Moonraker が扱えるのは `started`、`complete`、`error`、`cancelled`、`paused`、`resumed` です。
- **`?:level=high`**：Apprise に JSON へ `"level": "high"` を追加させます。Pocket Alert はこのフィールドを読み取り、高優先度でプッシュ通知を送ります。iPhone では時間に敏感な通知として届き、集中モードでも通知が届きます。「complete」のセクションには level を指定していないため、通常のプッシュ通知として届きます。
- **`{event_args[1]}`**：イベント発生後のジョブの状態です。Klipper の `print_stats` オブジェクトに対応しており、`filename` は G-code ファイル名、`message` は印刷が失敗したときの Klipper のエラーメッセージです。
- **`{event_name}`**：発動したイベント名です。これにより 1 つのセクションで `error` と `cancelled` の両方を扱えて、タイトルでどちらが起きたかもわかります。

## ステップ 3：Moonraker を再起動してテストする

Mainsail または Fluidd の電源メニューから、あるいは SSH で Moonraker を再起動します。

```bash
sudo systemctl restart moonraker
```

フィラメントを使ってテストする前に、curl で Webhook を確認しておくと安心です。以下のコマンドは Apprise と同じ形式の JSON を送信します。

```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 側は正常に動いています。次に、小さな印刷を開始し、1 層目が終わったところでキャンセルしてください。数秒以内に `❌ 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 では、重大な通知がおやすみモードを突破します。重大な通知は有料機能です。無料プランでは、メッセージは高優先度で届きます。詳しくは [重大な通知](/use-cases/critical-alerts) をご覧ください。
- **複数のプリンターを使う。** プリンターごとに Webhook を 1 つ作成し、機械の名前を付けます。プッシュ通知のタイトルで、どのプリンターが停止したかがわかります。
- **自分で作成したマクロからの通知。** 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` を呼び出してください。

## 通知が届かない場合

- **ダッシュボードで Webhook を開く。** [Webhook 履歴](/features/webhook-history) には、すべての呼び出しが元のペイロードとともに記録されます。記録がなければ、Moonraker が Pocket Alert に到達していません。エラーが記録されていれば、その理由がわかります。
- **`moonraker.log` を確認する。** Moonraker は通知のエラーを、インストールされている Apprise のバージョンとともにここに書き込みます。多くの環境では `~/printer_data/logs/moonraker.log` にあります。
- **プッシュ通知の内容が空になる。** テンプレートのキーは Apprise のペイロードと一致している必要があります。`%title%` ではなく、`%message%` と `%body%` を使ってください。

## なぜプラグインを使わないのか

Klipper 向けの Telegram ボットやリモートアクセスサービスは、カメラのスナップショット、タイムラプス、リモート操作など、より多くの機能を備えています。しかし、Raspberry Pi に追加のサービスをインストールして、更新し続ける必要もあります。「終わったら知らせてほしい、失敗したら起こしてほしい」という目的であれば、通知の送信はすでに Moonraker が行っています。Pocket Alert は受け取るだけで十分です。

プリンターが [ホームラボ](/use-cases/homelab-alerts) の近くにある場合は、そのアラートがサーバー、バックアップ、cron ジョブのアラートと同じアプリにまとまります。履歴も優先度レベルも共通になります。

## FAQ

### Raspberry Pi に何かインストールする必要はありますか？

いいえ。通知機能は Moonraker の一部で、Apprise は依存関係として一緒にインストールされます。編集するのは `moonraker.conf` だけで、その後 Moonraker を再起動します。

### Mainsail と Fluidd でも使えますか？

はい。どちらも Moonraker の Web インターフェースで、通知機能は Moonraker 側にあるため、設定は同じです。どちらからでも `moonraker.conf` を編集できます。

### 複数のプリンターから通知を受け取れますか？

はい。プリンターごとに Webhook を 1 つ作成し、機械の名前を付けてください。Webhook の名前がプッシュ通知のタイトルになります。

### 失敗時に夜中でも起こされますか？

`level=high` の場合、iPhone では時間に敏感な通知として届き、集中モードでも通知が届きます。Android でおやすみモードを突破するには、有料プランで `level=critical` を使用してください。

### 無料で使えますか？

はい。Webhook は無料プランでも使えます。各イベントは 1 日の上限のうち 1 件のメッセージを消費します。一般的な印刷では 1〜2 件です。

[Webhook を作成して](/webhooks)設定を貼り付ければ、次の印刷が終わったときにお知らせします。
