발송
예약과 취소
예약 발송을 걸고 취소하는 법. 취소할 수 있는 시점의 경계.
발송 요청에 scheduledAt 을 넣으면 그 시각에 나갑니다. 생략하면 즉시 발송입니다.
시각 형식
ISO 8601 로 적되 시간대 오프셋을 함께 주세요. 2026-08-20T10:00:00+09:00 처럼 씁니다.
접수 응답
예약이 잡히면 status 가 RESERVED 로 옵니다 (즉시 발송은 QUEUED). 포인트 홀드는 예약 시점이 아니라 접수 시점에 잡힙니다 — 발송 시각까지 그만큼의 잔액이 묶여 있으니, 큰 예약을 여러 건 걸어 둘 때는 잔액을 함께 살피세요.
취소
예약 취소에 groupId 를 넘기면 됩니다. 취소되면 잡아 두었던 홀드가 풀리고, 응답의 releasedHoldAmount 가 그 값입니다.
광고성 메시지의 야간 제한
광고성 메시지는 야간 시간대 발송이 제한됩니다. 그 시각으로 예약을 걸면 접수 단계에서 경고가 붙거나 거절될 수 있습니다. 어떻게 판정되는지 미리 보고 싶다면 모의발송에 같은 scheduledAt 을 넣어 보세요 — warnings 에 그대로 나옵니다.
예약 상태 확인
- 발송 그룹 결과의
scheduledAt으로 언제 나갈 예정인지 확인합니다. - 취소된 예약은
status가CANCELED이고canceledAt에 취소 시각이 들어갑니다.