Envoyez maintenant, livrez plus tard.
Définissez une heure précise ou un délai relatif sur n’importe quel message, jusqu’à 30 jours à l’avance, et annulez-le à tout moment avant l’envoi. Ni tâche cron, ni processus worker.
Deux façons d’indiquer le moment
Chaque rappel qu’un script pouvait envoyer exigeait jusqu’ici un processus resté actif jusqu’à l’instant voulu. Ce n’est plus le cas.
Heures absolues
Indiquez une date et une heure exactes au format RFC3339, en horodatage Unix ou sous forme de date et d’heure simples, selon ce qui est le plus pratique dans votre langage.
Délais relatifs
Ou indiquez un délai relatif : 30m, 2h, ou un nombre de secondes. Pratique lorsque le déclencheur est « deux heures après le démarrage de ce script ».
Votre fuseau horaire, pas l’UTC
Les heures sans décalage sont lues dans le fuseau horaire de votre compte : 09:00 signifie neuf heures là où vous vous trouvez.
Lister et annuler
Listez tous les messages en attente et annulez-en n’importe lequel avant l’envoi. Une collision avec le dispatcher se résout proprement, jamais à moitié.
Chiffré jusqu’à la livraison
Le contenu reste chiffré au repos jusqu’à sa livraison, pièces jointes comprises. Un message annulé emporte son fichier avec lui.
Une programmation est une promesse
La priorité et l’offre sont figées au moment de la programmation. Un message annoncé comme critique arrive comme critique, quels que soient les changements intervenus entre-temps.
Trois étapes, un seul champ en plus
Ajoutez un champ
Prenez un message que vous envoyez déjà et ajoutez send_at avec une heure, ou delay avec un décalage.
Conservez le tid
Vous recevez un tid ainsi que l’heure de livraison résolue, dans votre fuseau horaire et en UTC.
Annulez si nécessaire
Listez les messages en attente à tout moment, et annulez avec un DELETE si les plans changent.
Fonctionnement de l’envoi programmé
Ajoutez send_at ou delay à une requête classique de création de message. Au lieu d’envoyer immédiatement, Pocket Alert conserve une copie chiffrée du message et la confie à un dispatcher interne, qui la livre au moment voulu sous forme de notification push ordinaire. Le message livré apparaît ensuite dans votre historique comme les autres.
Vous recevez un 201 avec "scheduled": true, l’heure de livraison résolue à la fois dans votre fuseau horaire et en UTC, ainsi qu’un tid — conservez-le, c’est lui qui sert à annuler.
Ce qu’il remplace
Les rappels d’expiration de certificats, les fenêtres de maintenance, une relance deux heures après le début d’une migration pour vérifier le nombre de lignes, un suivi le lendemain matin d’un déploiement. Tout cela nécessitait autrefois une entrée cron ou un processus worker qui devait tenir jusqu’au moment voulu. Désormais, c’est un seul champ supplémentaire dans une requête que vous faisiez déjà.
Cas limites, gérés
Un send_at passé renvoie un 400, avec une tolérance de soixante secondes pour le décalage d’horloge : dans cet intervalle, le message est simplement envoyé immédiatement. Les messages en retard après un redémarrage sont livrés tardivement plutôt qu’abandonnés. Les pièces jointes sont envoyées lors de la programmation et liées au moment de la livraison.
Vos questions, nos réponses
Ajoutez send_at avec une heure précise ou delay avec un décalage relatif à n’importe quel message. send_at accepte le format RFC3339, un horodatage Unix ou un simple YYYY-MM-DD HH:MM ; delay accepte des durées comme 30m et 2h. Indiquez l’un ou l’autre, jamais les deux.
Trente jours. Toute date au-delà est rejetée plutôt que ramenée silencieusement à cette limite.
Le fuseau horaire de votre compte. Un send_at de 2026-08-15 09:00 correspond à neuf heures du matin là où vous vous trouvez, et non en UTC. Ajoutez explicitement un décalage horaire si vous voulez éviter toute ambiguïté.
Listez les messages en attente avec GET /v1/messages/scheduled et annulez-en un avec DELETE /v1/messages/scheduled/{tid}. Si l’envoi a déjà commencé, vous recevez un 409 au lieu d’un message annulé à moitié. L’annulation supprime aussi toute pièce jointe.
Il est livré en retard, pas abandonné. Si le service redémarre après une heure d’envoi, le message part au prochain cycle. Le contenu reste chiffré au repos avec votre clé dès le moment où vous le programmez.
L’envoi programmé est une fonctionnalité payante : une requête de l’offre gratuite utilisant send_at ou delay renvoie un 403, au lieu d’être envoyée immédiatement en silence. La priorité et l’offre sont déterminées au moment de la programmation, donc un message programmé comme critique arrive toujours comme critique.
Supprimez la tâche cron. Gardez le rappel.
Un seul champ en plus sur un message que vous envoyiez déjà, et le rappel arrive au bon moment au lieu de partir immédiatement.