# Invia adesso, consegna dopo.

> Programma notifiche push con Pocket Alert. Scegli un orario preciso o un ritardo fino a 30 giorni, consulta i messaggi in attesa e annullali prima dell'invio. Nessun cron job necessario.

<!-- source: https://pocketalert.app/it/features/scheduled-delivery -->

Ultimo aggiornamento: 2026-08-11

Imposta un orario preciso o un ritardo relativo su qualsiasi messaggio, fino a 30 giorni, e annullalo in qualsiasi momento prima che scatti. Niente cron job, niente processo worker.

Documentazione: https://info.pocketalert.app/features/scheduled-delivery.html

## Tre passaggi, un campo in più

1. **Aggiungi un campo** — Prendi un messaggio che già invii e aggiungi send_at con un orario, oppure delay con uno scostamento.
2. **Conserva il tid** — Ricevi un tid e l'orario di consegna risolto nel tuo fuso orario e in UTC.
3. **Annulla se necessario** — Elenca i messaggi in attesa in qualsiasi momento, e annulla con una DELETE se i piani cambiano.

## Due modi per dire quando

Ogni promemoria che avresti voluto da uno script richiedeva un processo rimasto attivo fino al momento giusto. Non più.

- **Orari assoluti** — Indica un timestamp preciso in RFC3339, in tempo Unix o come data e ora semplici, quello che è più comodo nella tua lingua.
- **Ritardi relativi** — Oppure indica un ritardo relativo: 30m, 2h, o semplicemente secondi. Utile quando il trigger è "due ore dopo che questo script è partito".
- **Il tuo fuso orario, non UTC** — Gli orari senza offset vengono letti secondo il fuso orario del tuo account, quindi 09:00 significa le nove dove ti trovi tu.
- **Elenca e annulla** — Elenca tutto ciò che è in attesa e annulla qualsiasi elemento prima della consegna. Una corsa con il dispatcher si risolve in modo pulito, mai a metà.
- **Cifrato fino alla consegna** — Il contenuto resta cifrato a riposo fino alla consegna, allegati inclusi. Un messaggio annullato porta via anche il suo file.
- **Una programmazione è una promessa** — Priorità e piano vengono risolti al momento della programmazione. Un messaggio promesso come critico arriva come critico, qualunque cosa sia cambiata nel frattempo.

## Come funziona l'invio programmato

    
Aggiungi `send_at` o `delay` a una normale richiesta di creazione di un messaggio. Invece di inviare subito, Pocket Alert salva uno snapshot cifrato del messaggio e lo passa a un dispatcher interno, che lo consegna al momento giusto come normale notifica push. Il messaggio consegnato appare poi nella cronologia come qualsiasi altro.

    
Ricevi un `201` con `"scheduled": true`, l'orario di consegna risolto sia nel tuo fuso orario sia in UTC, e un `tid`: conservalo, è quello con cui annulli.

    
## Cosa sostituisce

    
Promemoria per la scadenza dei certificati, finestre di manutenzione, un sollecito due ore dopo l'inizio di una migrazione per controllare il numero di righe, un follow-up la mattina dopo un deploy. Tutto questo richiedeva una voce cron o un processo worker che restasse attivo fino al momento giusto. Ora è un campo in più su una richiesta che già facevi.

    
## Casi limite, gestiti

    
Un `send_at` nel passato restituisce un `400`, con sessanta secondi di tolleranza per il disallineamento dell'orologio: entro questa finestra il messaggio viene semplicemente inviato subito. I messaggi scaduti dopo un riavvio vengono consegnati in ritardo, non scartati. Gli allegati vengono caricati al momento della programmazione e collegati alla consegna.

## FAQ

### Come programmo una notifica push?

Aggiungi `send_at` con un orario preciso oppure `delay` con uno scostamento relativo a qualsiasi messaggio. `send_at` accetta RFC3339, un timestamp Unix o un semplice `YYYY-MM-DD HH:MM`; `delay` accetta durate come `30m` e `2h`. Usane uno o l'altro, mai entrambi.

### Di quanto posso programmare in anticipo?

Trenta giorni. Tutto ciò che va oltre viene rifiutato, non modificato in silenzio.

### Quale fuso orario viene usato?

Il fuso orario del tuo account. Un `send_at` di 2026-08-15 09:00 significa le nove del mattino dove ti trovi tu, non in UTC. Se vuoi evitare ambiguità, aggiungi esplicitamente un offset.

### Posso annullare un messaggio programmato?

Elenca i messaggi in attesa con `GET /v1/messages/scheduled` e annullane uno con `DELETE /v1/messages/scheduled/{tid}`. Se l'invio è già iniziato ricevi un `409`, invece di un messaggio annullato a metà. Annullando viene eliminato anche qualsiasi allegato.

### Cosa succede se l'orario di consegna passa durante un'interruzione?

Viene consegnato in ritardo, non scartato. Se il servizio si riavvia dopo un orario di consegna, il messaggio parte al ciclo successivo. Il contenuto resta cifrato a riposo con la tua chiave dal momento in cui lo programmi.

### La programmazione è disponibile nel piano gratuito?

L'invio programmato è una funzione a pagamento: una richiesta del piano gratuito che usa `send_at` o `delay` restituisce un `403`, invece di essere inviata subito in silenzio. Priorità e piano vengono risolti al momento della programmazione, quindi un messaggio programmato come critico arriva comunque come critico.
