# 지금 보내거나, 나중에 보내세요.

> Pocket Alert로 푸시 알림을 예약 발송하세요. 정확한 시각이나 최대 30일 뒤까지 지연 시간을 지정하고, 대기 중인 메시지를 확인하고, 발송 전에 취소할 수 있어요. 크론 작업은 필요 없어요.

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

마지막 업데이트: 2026-08-11

아무 메시지에나 정확한 시각이나 상대적 지연을 설정하세요. 최대 30일 뒤까지 예약할 수 있고, 발송 전이라면 언제든 취소할 수 있어요. 크론 작업도, 워커 프로세스도 필요 없어요.

문서: https://info.pocketalert.app/features/scheduled-delivery.html

## 3단계, 필드 하나면 충분해요

1. **필드 하나 추가** — 이미 보내고 있는 메시지를 골라 시각을 뜻하는 send_at이나 오프셋을 뜻하는 delay를 추가하세요.
2. **tid 보관하기** — tid와 함께 여러분의 시간대 및 UTC로 환산된 발송 시각을 받게 돼요.
3. **필요하면 취소** — 언제든 대기 중인 메시지를 조회할 수 있고, 계획이 바뀌면 DELETE로 취소하세요.

## 시점을 정하는 두 가지 방법

스크립트에서 원하던 리마인더는 시각이 올 때까지 살아 있는 프로세스가 필요했어요. 이제는 그럴 필요가 없어요.

- **절대 시각** — RFC3339, Unix 시간, 또는 간단한 날짜와 시각 중 편한 형식으로 정확한 타임스탬프를 지정하세요.
- **상대 지연** — 또는 30m, 2h, 혹은 초 단위 숫자로 상대적 지연을 지정하세요. “이 스크립트가 시작된 뒤 두 시간 후”처럼 트리거가 상대적일 때 유용해요.
- **UTC가 아닌 내 시간대** — 오프셋이 없는 시각은 계정 시간대 기준으로 해석돼요. 따라서 09:00은 여러분이 있는 곳 기준 오전 9시를 뜻해요.
- **조회와 취소** — 대기 중인 모든 메시지를 조회하고, 발송 전에 원하는 것을 취소하세요. 디스패처와 경합이 발생해도 중간 상태 없이 깔끔하게 처리돼요.
- **발송 전까지 암호화** — 발송 전까지 내용은 첨부 파일을 포함해 암호화된 상태로 저장돼요. 취소된 메시지의 파일도 함께 삭제돼요.
- **예약은 약속이에요** — 우선순위와 플랜은 예약하는 시점에 확정돼요. 중요도 높음으로 약속된 메시지는 그 사이 무엇이 바뀌었든 중요도 높음으로 도착해요.

## 예약 발송은 이렇게 동작해요

    
일반적인 메시지 생성 요청에 `send_at` 또는 `delay`를 추가하세요. Pocket Alert은 즉시 보내는 대신 메시지의 암호화된 스냅샷을 저장하고, 이를 내부 디스패처에 넘겨요. 디스패처는 적절한 시점에 일반 푸시 알림으로 메시지를 발송해요. 발송된 메시지는 다른 메시지와 똑같이 기록에 남아요.

    
요청이 성공하면 `"scheduled": true`와 함께 `201`이 반환되며, 여러분의 시간대와 UTC로 환산된 발송 시각, 그리고 `tid`를 받게 돼요. `tid`는 꼭 보관하세요. 예약을 취소할 때 필요해요.

    
## 이전에는 이런 작업이 필요했어요

    
인증서 만료 알림, 점검 시간대 공지, 마이그레이션이 시작된 두 시간 뒤에 행 수를 확인하라는 알림, 배포 다음 날 아침의 후속 확인 같은 것들이요. 이 모든 작업에는 예전에 크론 항목이나, 발송 시각까지 살아남아야 하는 워커 프로세스가 필요했어요. 이제는 이미 보내고 있던 요청에 필드 하나만 추가하면 돼요.

    
## 예외 상황도 처리해요

    
과거 시각의 `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`이 반환돼요. 우선순위와 플랜은 예약하는 시점에 확정되므로, 중요도 높음으로 예약한 메시지는 그대로 중요도 높음으로 도착해요.
