# Notifiche push per Klipper: avvisi di stampa sul telefono

> Ricevi una notifica push quando una stampa Klipper termina, fallisce o viene messa in pausa. Il notifier integrato di Moonraker più un webhook Pocket Alert: nessun plugin, un solo blocco di configurazione.

*09.10.2026*

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

Una stampa da dodici ore non ha bisogno che tu le stia accanto. Ha bisogno che tu sappia nel momento in cui finisce e, cosa più importante, nel momento in cui si ferma.

Klipper può già segnalarti entrambe le cose. Moonraker, il server API alla base di Mainsail e Fluidd, ha un notifier integrato che si attiva sugli eventi di stampa e li invia tramite [Apprise](https://github.com/caronc/apprise). Puntalo a un webhook di Pocket Alert e ogni stampa completata, fallita, annullata o messa in pausa arriva sul tuo telefono come notifica push. Nessun plugin, nessun servizio extra sul Pi, un solo blocco di configurazione.

## Cosa ti serve

- Una stampante con Klipper e Moonraker. Se apri Mainsail o Fluidd nel browser, hai già Moonraker.
- Un account [Pocket Alert](/) gratuito e l'app sul tuo telefono [iPhone o Android](/get-app).
- Circa cinque minuti.

## Passo 1. Crea un webhook in Pocket Alert

Apri [Webhook](/webhooks) nella dashboard e creane uno nuovo:

- **Nome**: la stampante, per esempio `Voron 2.4`. Il nome diventa il titolo della notifica push (`Webhook Voron 2.4`), così, con più stampanti, vedi a colpo d'occhio quale ha bisogno di te.
- **Applicazione** e **Dispositivo**: dove deve arrivare la notifica.
- **Messaggio**: incolla questo modello:

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

Salva e copia l'URL del webhook. Ha questo aspetto: `https://p4a.me/wh/<your-webhook-id>`.

Perché questo modello: Moonraker passa ogni notifica ad Apprise, e il notifier JSON di Apprise invia un payload di questo tipo:

```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"
}
```

Ogni `%key%` nel modello viene sostituito con il campo corrispondente del JSON. La notifica mostra il titolo sulla prima riga e il messaggio sotto. Per saperne di più sui percorsi dei modelli, leggi [Crea il tuo primo URL webhook](/blog/create-your-first-webhook-url).

## Passo 2. Aggiungi i notifier a moonraker.conf

Apri `moonraker.conf` (in Mainsail sotto **Machine**, in Fluidd sotto **Configuration**) e aggiungi in fondo queste tre sezioni. Sostituisci `YOUR_WEBHOOK_ID` con l'ID presente nell'URL del tuo webhook.

```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
```

Cosa fa ciascuna parte:

- **`jsons://`** è il notifier JSON di Apprise su HTTPS. Invia il payload mostrato sopra al tuo webhook.
- **`events`** sceglie gli stati di stampa che attivano una sezione. Moonraker riconosce `started`, `complete`, `error`, `cancelled`, `paused` e `resumed`.
- **`?:level=high`** dice ad Apprise di aggiungere `"level": "high"` al JSON. Pocket Alert legge questo campo e invia la notifica con priorità alta, che su iPhone arriva come notifica time-sensitive e supera le modalità Full immersion. La sezione "complete" non ha livello, quindi arriva come notifica push normale.
- **`{event_args[1]}`** è lo stato del lavoro dopo l'evento. Riflette l'oggetto `print_stats` di Klipper: `filename` è il file G-code, `message` è il testo dell'errore di Klipper quando una stampa fallisce.
- **`{event_name}`** è l'evento che si è verificato, così una sola sezione copre sia `error` sia `cancelled` e il titolo indica comunque quale dei due è successo.

## Passo 3. Riavvia Moonraker e fai un test

Riavvia Moonraker dal menu di alimentazione in Mainsail o Fluidd, oppure via SSH:

```bash
sudo systemctl restart moonraker
```

Prima di consumare filamento per un test, verifica il webhook con curl. Questo invia la stessa struttura JSON che usa 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"}'
```

Se il telefono vibra, la parte di Pocket Alert funziona. Ora avvia una stampa piccola e annullala dopo il primo strato: dovresti ricevere `❌ Print cancelled` in pochi secondi.

## Cosa arriva sul telefono

Una stampa fallita di notte appare così sulla schermata di blocco:

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

Sai quale stampante, quale file e perché si è fermata prima ancora di sbloccare il telefono.

## Personalizzalo

Tutto quello che segue è una piccola modifica allo stesso file.

- **Registra in silenzio l'inizio delle stampe.** Aggiungi una sezione con `events: started` e `?:level=silent`. L'avvio viene registrato nella cronologia dei messaggi senza suono.
- **Fatti svegliare dagli errori.** Sostituisci `?:level=high` con `?:level=critical` nella sezione dei fallimenti. Su Android un avviso critico supera Non disturbare. La consegna critica è una funzione a pagamento; con il piano gratuito il messaggio arriva comunque con priorità alta. Dettagli in [avvisi critici](/use-cases/critical-alerts).
- **Più stampanti.** Un webhook per ogni stampante, ciascuno con il nome della macchina. Il titolo della notifica ti dice quale si è fermata.
- **Avvisi dalle tue macro.** Moonraker ha anche un evento `gcode`, quindi una macro Klipper può inviare qualsiasi testo tu voglia. Utile per un cambio filamento o per un sensore di esaurimento.

In `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}
```

In `printer.cfg`:

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

Richiama `NOTIFY_FILAMENT_CHANGE` dalla tua macro `M600` oppure dal `runout_gcode` di un sensore di filamento.

## Se non arriva nulla

- **Apri il webhook nella dashboard.** [Cronologia webhook](/features/webhook-history) registra ogni chiamata con il payload originale. Se non c'è nessuna voce, Moonraker non ha mai raggiunto Pocket Alert. Una voce con errore ti indica il motivo.
- **Leggi `moonraker.log`.** Moonraker scrive lì gli errori del notifier, insieme alla versione di Apprise installata. Nella maggior parte delle installazioni si trova in `~/printer_data/logs/moonraker.log`.
- **Righe vuote nella notifica.** Le chiavi del modello devono corrispondere al payload di Apprise: `%title%` e `%message%`, non `%body%`.

## Perché non un plugin?

I bot Telegram e i servizi di accesso remoto per Klipper fanno di più: snapshot della camera, timelapse, controllo remoto. Però aggiungono un altro servizio sul Pi da installare e tenere aggiornato. Se ti basta "dimmi quando è finita, svegliami se fallisce", Moonraker fa già l'invio: a Pocket Alert resta solo da riceverlo.

E se la stampante vive accanto a un [homelab](/use-cases/homelab-alerts), i suoi avvisi finiscono nella stessa app dei tuoi avvisi del server, dei backup e dei cron job, con un'unica cronologia e gli stessi livelli di priorità.

## FAQ

### Devo installare qualcosa sul Raspberry Pi?

No. Il notifier fa parte di Moonraker, e Apprise viene installato insieme come dipendenza. Devi solo modificare `moonraker.conf` e riavviare Moonraker.

### Funziona con Mainsail e Fluidd?

Sì. Entrambe sono interfacce web per Moonraker e il notifier vive in Moonraker, quindi la configurazione è identica. Puoi modificare `moonraker.conf` da una qualsiasi delle due.

### Posso ricevere notifiche da più stampanti?

Sì. Crea un webhook per ogni stampante e dagli il nome della macchina. Il nome del webhook diventa il titolo della notifica push.

### Una stampa fallita mi sveglia di notte?

Con `level=high` la notifica arriva come time-sensitive su iPhone e supera Full immersion. Per superare Non disturbare su Android, usa `level=critical` con un piano a pagamento.

### È gratuito?

Sì. I webhook funzionano con il piano gratuito e ogni evento consuma un messaggio dal tuo limite giornaliero: una stampa tipica ne invia uno o due.

[Crea un webhook](/webhooks), incolla la configurazione e la tua prossima stampa ti dirà quando è finita.
