予約送信

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

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

最大 30 日先まで予約可能いつでもキャンセル可能お客様のタイムゾーン 更新
できること

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

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

絶対時刻

RFC3339、Unix 時間、または単純な日付と時刻で、正確なタイムスタンプを指定できます。お使いの言語で扱いやすい形式を選んでください。

相対遅延

相対的な遅延を指定することもできます。30m、2h、または秒数のみで指定できます。「このスクリプトの開始から 2 時間後」のようなトリガーに便利です。

UTC ではなく、お客様のタイムゾーン

オフセットのない時刻は、アカウントのタイムゾーンで解釈されます。そのため 09:00 は、お客様のいる地域での午前 9 時を意味します。

一覧表示とキャンセル

送信待ちのメッセージをすべて一覧表示し、配信前に任意のものをキャンセルできます。ディスパッチャーとの競合も、中途半端な状態にならず、きれいに解決されます。

配信まで暗号化

内容は配信されるまで暗号化されて保存されます。添付ファイルも同様です。キャンセルされたメッセージは、ファイルもあわせて削除されます。

予約は約束です

優先度とプランは予約時点で確定します。重要として約束されたメッセージは、その後に何が変わっても、重要として届きます。

はじめ方

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

1

項目を 1 つ追加

すでに送信しているメッセージを用意し、時刻を指定する send_at か、オフセットを指定する delay を追加します。

2

tid を保存

tid と、お客様のタイムゾーンおよび UTC で確定した配信時刻が返されます。

3

必要に応じてキャンセル

送信待ちのメッセージはいつでも一覧表示できます。予定が変わった場合は DELETE でキャンセルします。

予約送信の仕組み

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

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

置き換えられるもの

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

エッジケースへの対応

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

FAQ

よくある質問

任意のメッセージに、正確な時刻を指定する 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 が返されます。優先度とプランは予約時点で確定するため、重要として予約したメッセージは、重要として届きます。

cron ジョブは削除して、リマインダーは残しましょう。

今まで送っていたメッセージに項目を 1 つ追加するだけで、リマインダーを今ではなく必要なタイミングで届けられます。