Envoi programmé

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.

Jusqu’à 30 jours à l’avanceAnnulable à tout momentVotre fuseau horaireMis à jour le
Ce que vous obtenez

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.

Pour commencer

Trois étapes, un seul champ en plus

1

Ajoutez un champ

Prenez un message que vous envoyez déjà et ajoutez send_at avec une heure, ou delay avec un décalage.

2

Conservez le tid

Vous recevez un tid ainsi que l’heure de livraison résolue, dans votre fuseau horaire et en UTC.

3

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.

FAQ

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.