시점을 정하는 두 가지 방법
스크립트에서 원하던 리마인더는 시각이 올 때까지 살아 있는 프로세스가 필요했어요. 이제는 그럴 필요가 없어요.
절대 시각
RFC3339, Unix 시간, 또는 간단한 날짜와 시각 중 편한 형식으로 정확한 타임스탬프를 지정하세요.
상대 지연
또는 30m, 2h, 혹은 초 단위 숫자로 상대적 지연을 지정하세요. “이 스크립트가 시작된 뒤 두 시간 후”처럼 트리거가 상대적일 때 유용해요.
UTC가 아닌 내 시간대
오프셋이 없는 시각은 계정 시간대 기준으로 해석돼요. 따라서 09:00은 여러분이 있는 곳 기준 오전 9시를 뜻해요.
조회와 취소
대기 중인 모든 메시지를 조회하고, 발송 전에 원하는 것을 취소하세요. 디스패처와 경합이 발생해도 중간 상태 없이 깔끔하게 처리돼요.
발송 전까지 암호화
발송 전까지 내용은 첨부 파일을 포함해 암호화된 상태로 저장돼요. 취소된 메시지의 파일도 함께 삭제돼요.
예약은 약속이에요
우선순위와 플랜은 예약하는 시점에 확정돼요. 중요도 높음으로 약속된 메시지는 그 사이 무엇이 바뀌었든 중요도 높음으로 도착해요.
3단계, 필드 하나면 충분해요
필드 하나 추가
이미 보내고 있는 메시지를 골라 시각을 뜻하는 send_at이나 오프셋을 뜻하는 delay를 추가하세요.
tid 보관하기
tid와 함께 여러분의 시간대 및 UTC로 환산된 발송 시각을 받게 돼요.
필요하면 취소
언제든 대기 중인 메시지를 조회할 수 있고, 계획이 바뀌면 DELETE로 취소하세요.
예약 발송은 이렇게 동작해요
일반적인 메시지 생성 요청에 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이 반환돼요. 우선순위와 플랜은 예약하는 시점에 확정되므로, 중요도 높음으로 예약한 메시지는 그대로 중요도 높음으로 도착해요.