# 今すぐ送信するか、 後から配信 。

> Pocket Alert でプッシュ通知を予約送信。日時の指定や最大 30 日先までの遅延送信に対応し、送信待ちのメッセージの一覧表示や配信前のキャンセルも可能です。cron ジョブは不要です。

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

最終更新日:2026-08-11

任意のメッセージに、正確な時刻か相対的な遅延を設定できます。最大 30 日先まで指定でき、発火前であればいつでもキャンセルできます。cron ジョブもワーカープロセスも不要です。

ドキュメント:https://info.pocketalert.app/features/scheduled-delivery.html

## 3 つのステップと、項目 1 つの追加

1. **項目を 1 つ追加** — すでに送信しているメッセージを用意し、時刻を指定する send_at か、オフセットを指定する delay を追加します。
2. **tid を保存** — tid と、お客様のタイムゾーンおよび UTC で確定した配信時刻が返されます。
3. **必要に応じてキャンセル** — 送信待ちのメッセージはいつでも一覧表示できます。予定が変わった場合は DELETE でキャンセルします。

## 時刻を指定する 2 つの方法

スクリプトからリマインダーを送りたいとき、これまでは時刻が来るまでプロセスを動かし続ける必要がありました。もうその必要はありません。

- **絶対時刻** — RFC3339、Unix 時間、または単純な日付と時刻で、正確なタイムスタンプを指定できます。お使いの言語で扱いやすい形式を選んでください。
- **相対遅延** — 相対的な遅延を指定することもできます。30m、2h、または秒数のみで指定できます。「このスクリプトの開始から 2 時間後」のようなトリガーに便利です。
- **UTC ではなく、お客様のタイムゾーン** — オフセットのない時刻は、アカウントのタイムゾーンで解釈されます。そのため 09:00 は、お客様のいる地域での午前 9 時を意味します。
- **一覧表示とキャンセル** — 送信待ちのメッセージをすべて一覧表示し、配信前に任意のものをキャンセルできます。ディスパッチャーとの競合も、中途半端な状態にならず、きれいに解決されます。
- **配信まで暗号化** — 内容は配信されるまで暗号化されて保存されます。添付ファイルも同様です。キャンセルされたメッセージは、ファイルもあわせて削除されます。
- **予約は約束です** — 優先度とプランは予約時点で確定します。重要として約束されたメッセージは、その後に何が変わっても、重要として届きます。

## 予約送信の仕組み

    
通常のメッセージ作成リクエストに `send_at` または `delay` を追加します。Pocket Alert は即時送信する代わりに、メッセージの暗号化されたスナップショットを保存し、内部のディスパッチャーに渡します。ディスパッチャーは適切なタイミングで、通常のプッシュ通知として配信します。配信されたメッセージは、他のメッセージと同様に履歴に表示されます。

    
レスポンスとして `"scheduled": true` を含む `201` が返されます。また、お客様のタイムゾーンと UTC の両方で確定した配信時刻と、`tid` が返されます。`tid` は必ず保存してください。キャンセルする際に必要です。

    
## 置き換えられるもの

    
証明書の有効期限のリマインダー、メンテナンス時間帯の通知、マイグレーション開始 2 時間後に行数を確認する依頼、デプロイの翌朝のフォローアップなどです。これまではこうした用途に cron の設定や、時刻が来るまで稼働し続けるワーカープロセスが必要でした。今では、すでに送信しているリクエストに項目を 1 つ追加するだけです。

    
## エッジケースへの対応

    
過去の `send_at` は `400` を返します。ただし、時計のずれを考慮して 60 秒の許容範囲があります。その範囲内であれば、メッセージはすぐに送信されます。再起動後に期限を過ぎたメッセージは、破棄されずに遅れて配信されます。添付ファイルは予約時にアップロードされ、配信時に関連付けられます。

## よくある質問

### プッシュ通知を予約するにはどうすればよいですか？

任意のメッセージに、正確な時刻を指定する `send_at` か、相対的な遅延を指定する `delay` を追加します。`send_at` は RFC3339、Unix タイムスタンプ、または `YYYY-MM-DD HH:MM` 形式の単純な日時を受け付けます。`delay` は `30m` や `2h` のような期間を受け付けます。どちらか一方だけを指定してください。両方は指定できません。

### どのくらい先まで予約できますか？

30 日後までです。それより先の時刻は、黙って丸められるのではなく拒否されます。

### どのタイムゾーンが使われますか？

アカウントのタイムゾーンが使われます。`send_at` に 2026-08-15 09:00 を指定すると、UTC ではなく、お客様のいる地域での午前 9 時を意味します。曖昧さをなくしたい場合は、オフセットを明示的に指定してください。

### 予約したメッセージをキャンセルできますか？

送信待ちのメッセージは `GET /v1/messages/scheduled` で一覧表示でき、`DELETE /v1/messages/scheduled/{tid}` で個別にキャンセルできます。配信がすでに始まっている場合は、中途半端にキャンセルされたメッセージではなく `409` が返されます。キャンセルすると、添付ファイルも削除されます。

### 停止中に配信時刻を過ぎた場合はどうなりますか？

配信が遅れて届きますが、破棄されることはありません。配信時刻を過ぎた状態でサービスが再起動した場合、次の処理タイミングでメッセージが送信されます。予約した時点から、内容はお客様のキーで暗号化されて保存されます。

### 無料プランでも予約できますか？

予約送信は有料機能です。`send_at` または `delay` を使った無料プランのリクエストは、黙って即時送信されるのではなく `403` が返されます。優先度とプランは予約時点で確定するため、重要として予約したメッセージは、重要として届きます。
