# Отправка сейчас, доставка позже.

> Отложенная отправка push-уведомлений в Pocket Alert. Укажите точное время или задержку до 30 дней, просматривайте запланированные сообщения и отменяйте их до доставки. Cron-задача не нужна.

<!-- source: https://pocketalert.app/ru/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 означает девять утра там, где вы находитесь.
- **Просмотр и отмена** — Просматривайте все ожидающие сообщения и отменяйте любое из них до доставки. Гонка с диспетчером разрешается корректно, никогда не на полпути.
- **Зашифровано до доставки** — Содержимое хранится зашифрованным до момента доставки, включая вложения. Отменённое сообщение удаляет и свой файл.
- **Расписание — это обещание** — Приоритет и тариф определяются в момент планирования. Сообщение, обещанное как критическое, придёт как критическое, что бы ни изменилось после.

## Как работает отложенная отправка

    
Добавьте `send_at` или `delay` в обычный запрос на создание сообщения. Вместо немедленной отправки Pocket Alert сохраняет зашифрованный снимок сообщения и передаёт его внутреннему диспетчеру, который доставит его в нужный момент как обычное push-уведомление. Доставленное сообщение затем появляется в истории, как любое другое.

    
В ответ вы получите `201` с `"scheduled": true`, итоговым временем доставки как в вашем часовом поясе, так и в UTC, и `tid`. Сохраните его: именно им вы отменяете сообщение.

    
## Что это заменяет

    
Напоминания об истечении срока сертификатов, окна технического обслуживания, напоминание через два часа после начала миграции проверить количество строк, фоллоу-ап на следующее утро после деплоя. Раньше для всего этого нужна была запись в cron или рабочий процесс, который должен был дожить до нужного момента. Теперь это одно дополнительное поле в запросе, который вы и так отправляете.

    
## Граничные случаи

    
Прошедшее время в `send_at` возвращает `400`, при этом допускается расхождение часов в шестьдесят секунд: внутри этого окна сообщение просто уходит сразу. Просроченные сообщения после перезапуска доставляются с опозданием, а не теряются. Вложения загружаются при планировании и привязываются при доставке.

## Частые вопросы

### Как запланировать push-уведомление?

Добавьте в любое сообщение `send_at` с точным временем или `delay` с относительным смещением. `send_at` принимает RFC3339, Unix-время или простой формат `YYYY-MM-DD HH:MM`; `delay` принимает длительности вроде `30m` и `2h`. Укажите что-то одно, но не оба поля сразу.

### На какой срок вперёд можно планировать?

На 30 дней. Запросы с более отдалённым временем отклоняются, а не молча обрезаются до лимита.

### Какой часовой пояс используется?

Часовой пояс вашего аккаунта. Значение `send_at` 2026-08-15 09:00 означает девять утра там, где вы находитесь, а не по UTC. Если хотите исключить неоднозначность, укажите смещение явно.

### Можно ли отменить запланированное сообщение?

Список ожидающих сообщений выводится через `GET /v1/messages/scheduled`, а отменить одно из них можно через `DELETE /v1/messages/scheduled/{tid}`. Если доставка уже началась, вы получите `409`, а не наполовину отменённое сообщение. Вместе с отменой удаляется и вложение.

### Что будет, если время доставки наступит во время простоя?

Сообщение доставляется с опозданием, но не теряется. Если сервис перезапустился после времени доставки, сообщение уйдёт при следующем тике. С момента планирования содержимое хранится зашифрованным вашим ключом.

### Доступно ли планирование на бесплатном тарифе?

Отложенная отправка доступна в платном тарифе. Запрос с `send_at` или `delay` на бесплатном тарифе возвращает `403`, а не отправляется сразу без уведомления. Приоритет и тариф определяются в момент планирования, поэтому сообщение, запланированное как критическое, придёт как критическое.
