# Kirim sekarang, kirim nanti.

> Jadwalkan push notification dengan Pocket Alert. Tentukan waktu persis atau penundaan hingga 30 hari ke depan, lihat pesan yang tertunda, dan batalkan sebelum terkirim. Tanpa cron job.

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

Terakhir diperbarui: 2026-08-11

Tetapkan waktu pasti atau penundaan relatif pada pesan apa pun, hingga 30 hari ke depan, dan batalkan kapan saja sebelum terkirim. Tanpa cron job, tanpa proses worker.

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

## Tiga langkah, satu field tambahan

1. **Tambahkan satu field** — Ambil pesan yang sudah Anda kirim dan tambahkan send_at dengan waktu, atau delay dengan offset.
2. **Simpan tid** — Anda akan menerima tid dan waktu pengiriman yang sudah diproses dalam zona waktu Anda dan UTC.
3. **Batalkan jika perlu** — Lihat pesan yang menunggu kapan saja, dan batalkan dengan DELETE jika rencana berubah.

## Dua cara menentukan waktu

Setiap pengingat yang pernah Anda inginkan dari sebuah skrip membutuhkan proses yang tetap hidup sampai saatnya tiba. Tidak lagi.

- **Waktu absolut** — Berikan timestamp pasti dalam RFC3339, Unix time, atau tanggal dan waktu biasa, mana pun yang paling mudah bagi Anda.
- **Penundaan relatif** — Atau berikan penundaan relatif: 30m, 2h, atau detik saja. Berguna saat pemicunya adalah "dua jam setelah skrip ini dimulai".
- **Zona waktu Anda, bukan UTC** — Waktu tanpa offset dibaca dalam zona waktu akun Anda, jadi 09:00 berarti pukul sembilan di lokasi Anda.
- **Lihat dan batalkan** — Lihat semua yang menunggu dan batalkan kapan saja sebelum pengiriman. Persaingan dengan dispatcher selesai dengan rapi, tidak pernah setengah jalan.
- **Terenkripsi sampai terkirim** — Isi pesan tersimpan terenkripsi hingga dikirim, termasuk lampiran. Pesan yang dibatalkan ikut menghapus filenya.
- **Jadwal adalah janji** — Prioritas dan paket ditentukan saat penjadwalan. Pesan yang dijanjikan sebagai critical tetap tiba sebagai critical, apa pun yang berubah setelahnya.

## Cara kerja pengiriman terjadwal

    
Tambahkan `send_at` atau `delay` ke permintaan create-message biasa. Alih-alih langsung mengirim, Pocket Alert menyimpan salinan pesan yang terenkripsi dan menyerahkannya ke dispatcher internal, yang mengirimkannya tepat pada waktunya sebagai push notification biasa. Pesan yang terkirim kemudian muncul di riwayat Anda seperti pesan lainnya.

    
Anda akan menerima `201` dengan `"scheduled": true`, waktu pengiriman yang sudah diproses dalam zona waktu Anda dan UTC, serta `tid` — simpan yang ini, karena itulah yang Anda gunakan untuk membatalkan.

    
## Yang digantikannya

    
Pengingat kedaluwarsa sertifikat, jendela pemeliharaan, pengingat dua jam setelah migrasi dimulai untuk memeriksa jumlah baris, tindak lanjut keesokan paginya setelah deploy. Semua itu dulu membutuhkan entri cron atau proses worker yang harus tetap hidup sampai waktunya tiba. Sekarang cukup satu field tambahan pada permintaan yang memang sudah Anda kirim.

    
## Kasus khusus, sudah ditangani

    
`send_at` di masa lalu mengembalikan `400`, dengan toleransi enam puluh detik untuk selisih jam — dalam rentang itu pesan langsung dikirim sekarang. Pesan yang terlewat waktunya setelah restart dikirim terlambat, bukan dibuang. Lampiran diunggah saat penjadwalan dan ditautkan saat pengiriman.

## FAQ

### Bagaimana cara menjadwalkan push notification?

Tambahkan `send_at` dengan waktu pasti atau `delay` dengan offset relatif ke pesan mana pun. `send_at` menerima RFC3339, Unix timestamp, atau `YYYY-MM-DD HH:MM` biasa; `delay` menerima durasi seperti `30m` dan `2h`. Kirim salah satunya saja, jangan keduanya.

### Seberapa jauh ke depan saya bisa menjadwalkan?

Tiga puluh hari. Waktu yang lebih jauh akan ditolak, tidak dipotong diam-diam.

### Zona waktu mana yang digunakan?

Zona waktu akun Anda. `send_at` 2026-08-15 09:00 berarti pukul sembilan pagi di lokasi Anda, bukan UTC. Tambahkan offset secara eksplisit jika Anda ingin lebih jelas.

### Bisakah saya membatalkan pesan yang sudah dijadwalkan?

Lihat pesan yang menunggu dengan `GET /v1/messages/scheduled` dan batalkan satu pesan dengan `DELETE /v1/messages/scheduled/{tid}`. Jika pengiriman sudah dimulai, Anda akan mendapat `409`, bukan pesan yang setengah dibatalkan. Membatalkan juga menghapus lampiran apa pun.

### Bagaimana jika waktu pengiriman terlewat saat layanan down?

Pesan tetap dikirim, hanya terlambat, tidak dibuang. Jika layanan restart melewati waktu pengiriman, pesan akan dikirim pada siklus berikutnya. Isinya tersimpan terenkripsi dengan kunci Anda sejak Anda menjadwalkannya.

### Apakah penjadwalan tersedia di paket gratis?

Pengiriman terjadwal adalah fitur berbayar, dan permintaan paket gratis yang menggunakan `send_at` atau `delay` akan mengembalikan `403`, bukan langsung dikirim diam-diam. Prioritas dan paket ditentukan saat Anda menjadwalkan, jadi pesan yang dijadwalkan sebagai critical tetap tiba sebagai critical.
