Отложенная отправка

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

Задайте точное время или относительную задержку для любого сообщения, на срок до 30 дней, и отмените его в любой момент до отправки. Без cron-задач и без рабочих процессов.

До 30 дней вперёдОтмена в любое времяВаш часовой поясОбновлено
Что вы получаете

Два способа указать время

Каждому напоминанию из скрипта раньше требовался процесс, который работал бы до самого момента отправки. Теперь это не нужно.

Абсолютное время

Укажите точную метку времени в RFC3339, Unix-времени или просто дату и время, в том формате, который удобнее вашему языку.

Относительные задержки

Или задайте относительную задержку: 30m, 2h или просто секунды. Удобно, когда отправка должна случиться через «два часа после запуска этого скрипта».

Ваш часовой пояс, а не UTC

Время без смещения читается в часовом поясе вашего аккаунта, так что 09:00 означает девять утра там, где вы находитесь.

Просмотр и отмена

Просматривайте все ожидающие сообщения и отменяйте любое из них до доставки. Гонка с диспетчером разрешается корректно, никогда не на полпути.

Зашифровано до доставки

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

Расписание — это обещание

Приоритет и тариф определяются в момент планирования. Сообщение, обещанное как критическое, придёт как критическое, что бы ни изменилось после.

Быстрый старт

Три шага и одно дополнительное поле

1

Добавьте одно поле

Возьмите сообщение, которое вы уже отправляете, и добавьте send_at со временем или delay со смещением.

2

Сохраните tid

В ответ придёт tid и итоговое время доставки в вашем часовом поясе и в UTC.

3

Отмените при необходимости

Просматривайте ожидающие сообщения в любой момент и отменяйте их через DELETE, если планы изменились.

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

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

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

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

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

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

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

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. Если хотите исключить неоднозначность, укажите смещение явно.

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

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

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

Удалите cron-задачу. Напоминание оставьте.

Одно дополнительное поле в сообщении, которое вы и так отправляли, и напоминание придёт тогда, когда это важно, а не сразу.