Jetzt senden, später zustellen.
Lege für jede Nachricht einen genauen Zeitpunkt oder eine relative Verzögerung fest, bis zu 30 Tage im Voraus, und brich sie jederzeit vor dem Auslösen ab. Kein Cronjob, kein Worker-Prozess.
Zwei Wege, den Zeitpunkt festzulegen
Jede Erinnerung, die du dir je aus einem Skript gewünscht hast, brauchte einen Prozess, der bis zum Eintreffen des Moments am Leben blieb. Damit ist jetzt Schluss.
Absolute Zeitpunkte
Gib einen genauen Zeitstempel in RFC3339, Unix-Zeit oder als einfaches Datum mit Uhrzeit an, je nachdem, was in deiner Sprache am einfachsten ist.
Relative Verzögerungen
Oder gib eine relative Verzögerung an: 30m, 2h oder einfach Sekunden. Praktisch, wenn der Auslöser „zwei Stunden nachdem dieses Skript gestartet ist“ lautet.
Deine Zeitzone, nicht UTC
Zeiten ohne Versatz werden in der Zeitzone deines Kontos gelesen, 09:00 heißt also neun Uhr an deinem Standort.
Auflisten und abbrechen
Liste alles Wartende auf und brich jede Nachricht vor der Zustellung ab. Ein Wettlauf mit dem Dispatcher wird sauber aufgelöst, niemals halb.
Verschlüsselt bis zur Zustellung
Der Inhalt liegt bis zur Zustellung verschlüsselt im Speicher, Anhänge eingeschlossen. Eine abgebrochene Nachricht nimmt ihre Datei mit.
Ein Zeitplan ist ein Versprechen
Priorität und Tarif werden zum Zeitpunkt der Planung festgelegt. Eine als kritisch zugesagte Nachricht kommt als kritisch an, egal was sich seitdem geändert hat.
Drei Schritte, ein zusätzliches Feld
Ein Feld hinzufügen
Nimm eine Nachricht, die du bereits sendest, und füge send_at mit einem Zeitpunkt oder delay mit einem Versatz hinzu.
Die tid aufbewahren
Du erhältst eine tid und den aufgelösten Zustellzeitpunkt in deiner Zeitzone und in UTC.
Bei Bedarf abbrechen
Wartende Nachrichten kannst du jederzeit auflisten, und mit einem DELETE abbrechen, falls sich die Pläne ändern.
So funktioniert geplanter Versand
Füge send_at oder delay einer normalen Anfrage zum Erstellen einer Nachricht hinzu. Statt sofort zu senden, speichert Pocket Alert einen verschlüsselten Snapshot der Nachricht und übergibt ihn an einen internen Dispatcher, der sie im richtigen Moment als gewöhnliche Push-Benachrichtigung zustellt. Die zugestellte Nachricht erscheint dann wie jede andere in deinem Verlauf.
Du erhältst ein 201 mit "scheduled": true, dem aufgelösten Zustellzeitpunkt sowohl in deiner Zeitzone als auch in UTC und einer tid. Bewahre sie auf, mit ihr brichst du ab.
Was es ersetzt
Erinnerungen an ablaufende Zertifikate, Wartungsfenster, ein Anstoß zwei Stunden nach Beginn einer Migration, um die Zeilenanzahlen zu prüfen, ein Follow-up am Morgen nach einem Deployment. Dafür brauchte man früher einen Cron-Eintrag oder einen Worker-Prozess, der bis zum Eintreffen des Moments durchhalten musste. Jetzt ist es ein zusätzliches Feld in einer Anfrage, die du ohnehin schon stellst.
Randfälle, abgedeckt
Ein send_at in der Vergangenheit liefert 400, mit sechzig Sekunden Toleranz für Uhrenabweichungen. Innerhalb dieses Fensters wird die Nachricht einfach sofort gesendet. Überfällige Nachrichten nach einem Neustart werden verspätet statt verworfen zugestellt. Anhänge werden beim Planen hochgeladen und bei der Zustellung verknüpft.
Fragen und Antworten
Füge jeder Nachricht send_at mit einem genauen Zeitpunkt oder delay mit einem relativen Versatz hinzu. send_at akzeptiert RFC3339, einen Unix-Timestamp oder einfaches YYYY-MM-DD HH:MM; delay akzeptiert Dauern wie 30m und 2h. Verwende entweder das eine oder das andere, niemals beides.
Dreißig Tage. Alles, was weiter in der Zukunft liegt, wird abgelehnt und nicht stillschweigend gekürzt.
Die Zeitzone deines Kontos. Ein send_at von 2026-08-15 09:00 bedeutet neun Uhr morgens an deinem Standort, nicht in UTC. Gib einen Versatz explizit an, wenn du es eindeutig haben willst.
Wartende Nachrichten listest du mit GET /v1/messages/scheduled auf, und eine davon brichst du mit DELETE /v1/messages/scheduled/{tid} ab. Hat die Zustellung bereits begonnen, erhältst du ein 409 statt einer halb abgebrochenen Nachricht. Beim Abbrechen wird auch ein Anhang gelöscht.
Sie wird verspätet zugestellt, nicht verworfen. Startet der Dienst neu, nachdem ein Zustellzeitpunkt verstrichen ist, geht die Nachricht beim nächsten Durchlauf raus. Der Inhalt liegt ab dem Moment der Planung mit deinem Schlüssel verschlüsselt im Speicher.
Geplanter Versand ist eine kostenpflichtige Funktion. Eine Anfrage im kostenlosen Tarif mit send_at oder delay liefert 403, statt stillschweigend sofort gesendet zu werden. Priorität und Tarif werden bei der Planung festgelegt, sodass eine als kritisch geplante Nachricht auch als kritisch ankommt.
Lass den Cronjob weg. Behalte die Erinnerung.
Ein zusätzliches Feld bei einer Nachricht, die du ohnehin schon sendest, und die Erinnerung erscheint dann, wenn sie zählt, statt sofort.