# Jetzt senden, später zustellen.

> Plane Push-Benachrichtigungen mit Pocket Alert. Lege einen exakten Zeitpunkt oder eine Verzögerung von bis zu 30 Tagen fest, liste ausstehende Nachrichten auf und storniere sie vor der Zustellung. Kein Cronjob nötig.

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

Zuletzt aktualisiert: 2026-08-11

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.

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

## Drei Schritte, ein zusätzliches Feld

1. **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.
2. **Die tid aufbewahren** — Du erhältst eine tid und den aufgelösten Zustellzeitpunkt in deiner Zeitzone und in UTC.
3. **Bei Bedarf abbrechen** — Wartende Nachrichten kannst du jederzeit auflisten, und mit einem DELETE abbrechen, falls sich die Pläne ändern.

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

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

## FAQ

### Wie plane ich eine Push-Benachrichtigung?

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.

### Wie weit im Voraus kann ich planen?

Dreißig Tage. Alles, was weiter in der Zukunft liegt, wird abgelehnt und nicht stillschweigend gekürzt.

### Welche Zeitzone wird verwendet?

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.

### Kann ich eine geplante Nachricht abbrechen?

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.

### Was passiert, wenn der Zustellzeitpunkt in einer Ausfallzeit verstreicht?

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.

### Ist das Planen im kostenlosen Tarif verfügbar?

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.
