# Notificaciones push para Klipper: alertas de impresión en tu teléfono

> Recibe una notificación push cuando una impresión de Klipper termine, falle o se pause. El notificador integrado de Moonraker más un webhook de Pocket Alert: sin plugins y con un solo bloque de configuración.

*09.10.2026*

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

Una impresión de doce horas no necesita que estés junto a la impresora. Necesita que sepas el momento exacto en que termina y, más importante aún, el momento en que se detiene.

Klipper ya puede avisarte de las dos cosas. Moonraker, el servidor de API detrás de Mainsail y Fluidd, tiene un notificador integrado que se activa con los eventos de impresión y los envía a través de [Apprise](https://github.com/caronc/apprise). Apúntalo a un webhook de Pocket Alert y cada impresión terminada, fallida, cancelada o pausada llegará a tu teléfono como notificación push. Sin plugin, sin servicio extra en la Raspberry Pi y con un solo bloque de configuración.

## Lo que necesitas

- Una impresora con Klipper y Moonraker. Si abres Mainsail o Fluidd en el navegador, ya tienes Moonraker.
- Una cuenta [Pocket Alert](/) gratuita y la aplicación en tu [iPhone o Android](/get-app).
- Unos cinco minutos.

## Paso 1. Crea un webhook en Pocket Alert

Abre [Webhooks](/webhooks) en el panel y crea uno nuevo:

- **Name** – la impresora, por ejemplo `Voron 2.4`. El nombre se convierte en el título de la push (`Webhook Voron 2.4`), así que si tienes más de una impresora verás de un vistazo cuál te necesita.
- **Application** y **Device** – a dónde va la notificación.
- **Message** – pega esta plantilla:

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

Guarda y copia la URL del webhook. Tiene este aspecto: `https://p4a.me/wh/<your-webhook-id>`.

Por qué esta plantilla: Moonraker entrega cada notificación a Apprise, y el notificador JSON de Apprise envía una carga útil pequeña como esta:

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

Cada `%key%` de la plantilla se sustituye por ese campo del JSON. La push muestra el título en la primera línea y el mensaje debajo. Más información sobre las rutas de plantilla en [Crea tu primera URL de webhook](/blog/create-your-first-webhook-url).

## Paso 2. Añade los notificadores a moonraker.conf

Abre `moonraker.conf` (en Mainsail, en **Machine**; en Fluidd, en **Configuration**) y añade estas tres secciones al final. Sustituye `YOUR_WEBHOOK_ID` por el identificador de tu URL de 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
```

Qué hace cada parte:

- **`jsons://`** es el notificador JSON de Apprise sobre HTTPS. Envía la carga útil de arriba a tu webhook.
- **`events`** elige los estados de impresión que activan una sección. Moonraker reconoce `started`, `complete`, `error`, `cancelled`, `paused` y `resumed`.
- **`?:level=high`** le indica a Apprise que añada `"level": "high"` al JSON. Pocket Alert lee ese campo y envía la push con prioridad alta, que en iPhone llega como notificación sensible al tiempo y atraviesa los modos Concentración. La sección "complete" no tiene nivel, así que llega como push normal.
- **`{event_args[1]}`** es el estado del trabajo tras el evento. Refleja el objeto `print_stats` de Klipper: `filename` es el archivo G-code y `message` es el texto de error de Klipper cuando una impresión falla.
- **`{event_name}`** es el evento que se ha disparado, así que una sola sección cubre `error` y `cancelled` y el título sigue indicando cuál de los dos ocurrió.

## Paso 3. Reinicia Moonraker y haz una prueba

Reinicia Moonraker desde el menú de energía en Mainsail o Fluidd, o por SSH:

```bash
sudo systemctl restart moonraker
```

Antes de gastar filamento en una prueba, comprueba el webhook con curl. Esto envía la misma forma de JSON que 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"}'
```

Si el teléfono vibra, la parte de Pocket Alert funciona. Ahora inicia una impresión pequeña y cancélala después de la primera capa: deberías recibir `❌ Print cancelled` en segundos.

## Lo que llega a tu teléfono

Una impresión fallida de noche se ve así en la pantalla de bloqueo:

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

Sabes qué impresora, qué archivo y por qué se detuvo antes de desbloquear el teléfono.

## Adáptalo a tu caso

Todo lo que sigue es una pequeña edición del mismo archivo.

- **Registra en silencio el inicio de las impresiones.** Añade una sección con `events: started` y `?:level=silent`. El inicio queda registrado en el historial de mensajes sin sonido.
- **Que los fallos te despierten.** Cambia `?:level=high` por `?:level=critical` en la sección de fallos. En Android, una alerta crítica atraviesa No molestar. La entrega crítica es una función de pago; en el plan gratuito el mensaje sigue llegando con prioridad alta. Detalles en [alertas críticas](/use-cases/critical-alerts).
- **Varias impresoras.** Un webhook por impresora, cada uno con el nombre de la máquina. El título de la push te indica cuál se ha detenido.
- **Alertas desde tus propias macros.** Moonraker también tiene un evento `gcode`, así que una macro de Klipper puede enviar cualquier texto que quieras. Es útil para un cambio de filamento o un sensor de fin de filamento.

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

En `printer.cfg`:

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

Llama a `NOTIFY_FILAMENT_CHANGE` desde tu macro `M600` o desde el `runout_gcode` de un sensor de filamento.

## Si no llega nada

- **Abre el webhook en el panel.** [Historial de webhooks](/features/webhook-history) registra cada llamada con su carga útil sin procesar. Si no hay entrada, Moonraker nunca llegó a Pocket Alert. Una entrada con error te indica el motivo.
- **Lee `moonraker.log`.** Moonraker escribe ahí los errores del notificador, junto con la versión de Apprise instalada. En la mayoría de instalaciones está en `~/printer_data/logs/moonraker.log`.
- **Líneas vacías en la push.** Las claves de la plantilla deben coincidir con la carga útil de Apprise: `%title%` y `%message%`, no `%body%`.

## ¿Por qué no un plugin?

Los bots de Telegram y los servicios de acceso remoto para Klipper hacen más: capturas de cámara, timelapses, control remoto. Pero también añaden otro servicio en la Raspberry Pi que instalar y mantener actualizado. Si lo que quieres es "avísame cuando termine y despiértame si falla", Moonraker ya se encarga del envío; Pocket Alert solo tiene que recibirlo.

Y si la impresora está junto a un [homelab](/use-cases/homelab-alerts), sus alertas acaban en la misma aplicación que las de tu servidor, las copias de seguridad y las tareas cron, con un solo historial y los mismos niveles de prioridad.

## Preguntas frecuentes

### ¿Tengo que instalar algo en la Raspberry Pi?

No. El notificador forma parte de Moonraker, y Apprise se instala con él como dependencia. Solo editas `moonraker.conf` y reinicias Moonraker.

### ¿Funciona con Mainsail y Fluidd?

Sí. Ambos son interfaces web de Moonraker, y el notificador vive en Moonraker, así que la configuración es idéntica. Puedes editar `moonraker.conf` desde cualquiera de las dos.

### ¿Puedo recibir notificaciones de varias impresoras?

Sí. Crea un webhook por impresora y ponle el nombre de la máquina. El nombre del webhook se convierte en el título de la push.

### ¿Una impresión fallida me despertará de noche?

Con `level=high`, la push llega como sensible al tiempo en iPhone y atraviesa Concentración. Para atravesar No molestar en Android, usa `level=critical` con un plan de pago.

### ¿Es gratis?

Sí. Los webhooks funcionan en el plan gratuito, y cada evento consume un mensaje de tu límite diario; una impresión típica envía uno o dos.

[Crea un webhook](/webhooks), pega la configuración y tu próxima impresión te avisará cuando termine.
