# Envoyez maintenant, livrez plus tard.

> Programmez des notifications push avec Pocket Alert. Choisissez une heure précise ou un délai jusqu’à 30 jours, consultez les messages en attente et annulez avant l’envoi. Aucune tâche cron requise.

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

Dernière mise à jour : 2026-08-11

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.

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

## 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.

## 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.

## 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

### Comment programmer une notification push ?

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.

### Jusqu’où puis-je programmer un envoi ?

Trente jours. Toute date au-delà est rejetée plutôt que ramenée silencieusement à cette limite.

### Quel fuseau horaire est utilisé ?

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é.

### Puis-je annuler un message programmé ?

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.

### Que se passe-t-il si l’heure d’envoi est dépassée pendant une indisponibilité ?

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.

### La programmation est-elle disponible sur l’offre gratuite ?

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.
