# 立即发送， 稍后送达 。

> 用 Pocket Alert 定时发送推送通知。可指定精确时间，或设置最长 30 天的延迟，随时查看待发送消息，并在送达前取消。无需 cron 任务。

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

最后更新：2026-08-11

为任意消息设置精确时间或相对延迟，最长可提前 30 天，触发前随时取消。无需 cron 任务，也无需工作进程。

文档：https://info.pocketalert.app/features/scheduled-delivery.html

## 三步，一个额外字段

1. **添加一个字段** — 选择一条你已经在发送的消息，加上 send_at 指定时间，或加上 delay 指定偏移。
2. **保存 tid** — 你会收到一个 tid，以及按你的时区和 UTC 给出的实际送达时间。
3. **需要时取消** — 随时可以列出待发送的消息；如果计划有变，使用 DELETE 取消即可。

## 两种指定时间的方式

以前从脚本里设置提醒，都需要一个一直运行到时间点的进程。现在不用了。

- **绝对时间** — 使用 RFC3339、Unix 时间或简单的日期时间给出精确时间戳，选你的语言最方便的那种即可。
- **相对延迟** — 也可以给出相对延迟：30m、2h，或直接给秒数。当触发条件是“脚本启动两小时后”时，这种方式很方便。
- **按你的时区，而不是 UTC** — 不带偏移的时间按你的账户时区解析，因此 09:00 就是你所在地的上午 9 点。
- **列出与取消** — 列出所有待发送的消息，并可在送达前取消任意一条。与调度器的竞争会被干净地处理，不会出现只完成一半的状态。
- **送达前保持加密** — 内容在送达前一直加密存储，附件也不例外。取消的消息会连同其文件一起删除。
- **排程即承诺** — 优先级和套餐在安排时确定。承诺为关键级别的消息，无论之后发生了什么变化，都会以关键级别送达。

## 定时发送的工作原理

    
在普通的创建消息请求中加入 `send_at` 或 `delay`。Pocket Alert 不会立即发送，而是存储一份消息的加密快照，交给内部调度器，在正确的时刻以普通推送的形式送出。送达后，这条消息会像其他消息一样出现在你的历史记录中。

    
你会收到一个 `201` 响应，其中包含 `"scheduled": true`、按你的时区和 UTC 分别给出的实际送达时间，以及一个 `tid`。请保存好它，取消时需要用到。

    
## 它能替代什么

    
证书到期提醒、维护窗口、迁移开始两小时后提醒去检查行数、部署后次日早上的跟进。这些过去都需要 cron 条目或一直运行到时间点的工作进程。现在，只需在你本来就在发送的请求上多加一个字段即可。

    
## 边界情况的处理

    
过去的 `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 表示你所在地的上午 9 点，而不是 UTC 的 9 点。如果想避免歧义，可以显式加上时区偏移。

### 可以取消定时消息吗？

使用 `GET /v1/messages/scheduled` 列出待发送的消息，使用 `DELETE /v1/messages/scheduled/{tid}` 取消其中一条。如果已经开始发送，你会收到 `409`，而不会得到一条只取消了一半的消息。取消时还会删除所有附件。

### 如果送达时间恰好遇上服务停机怎么办？

消息会延迟送达，而不会丢失。如果服务在某个送达时间之后才重启，消息会在下一个调度周期发出。从你安排的那一刻起，内容就以你的密钥加密存储。

### 免费套餐可以使用定时发送吗？

定时发送是付费功能。免费套餐使用 `send_at` 或 `delay` 的请求会返回 `403`，而不会被悄悄地立即发送。优先级和套餐在安排时就已确定，因此以关键级别安排的消息，仍会以关键级别送达。
