Invia adesso, consegna dopo.
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.
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.
Tre passaggi, un campo in più
Aggiungi un campo
Prendi un messaggio che già invii e aggiungi send_at con un orario, oppure delay con uno scostamento.
Conserva il tid
Ricevi un tid e l'orario di consegna risolto nel tuo fuso orario e in UTC.
Annulla se necessario
Elenca i messaggi in attesa in qualsiasi momento, e annulla con una DELETE se i piani cambiano.
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.
Le risposte alle tue domande
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.
Trenta giorni. Tutto ciò che va oltre viene rifiutato, non modificato in silenzio.
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.
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.
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.
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.
Elimina il cron job. Tieni il promemoria.
Un campo in più su un messaggio che già stavi inviando, e il promemoria arriva quando serve invece che subito.