예약과 취소

발송 요청에 scheduledAt 을 넣으면 그 시각에 나갑니다. 생략하면 즉시 발송입니다.

시각 형식

ISO 8601 로 적되 시간대 오프셋을 함께 주세요. 2026-08-20T10:00:00+09:00 처럼 씁니다.

접수 응답

예약이 잡히면 status 가 RESERVED 로 옵니다 (즉시 발송은 QUEUED). 포인트 홀드는 예약 시점이 아니라 접수 시점에 잡힙니다 — 발송 시각까지 그만큼의 잔액이 묶여 있으니, 큰 예약을 여러 건 걸어 둘 때는 잔액을 함께 살피세요.

취소

예약 취소에 groupId 를 넘기면 됩니다. 취소되면 잡아 두었던 홀드가 풀리고, 응답의 releasedHoldAmount 가 그 값입니다.

여러 그룹을 한꺼번에 취소하려면 예약 일괄 취소에 groupIds 를 최대 1,000개까지 담아 보내세요. 일정이 바뀌어 다시 예약해야 한다면, 일괄 취소한 뒤 알림톡 다건 발송으로 새 시각에 다시 접수하면 됩니다.

야간 광고 · 브랜드 메시지 발송 시간

광고성 메시지를 21:00~08:00(KST)에 보내려면 수신자에게 별도의 야간 수신동의를 받아 두어야 합니다. 서버는 수신자의 동의 여부를 알 수 없어서 예약 시각만으로 접수를 거절하지 않고, 응답에 경고도 싣지 않습니다 — 동의를 받았는지는 보내는 쪽이 확인해야 합니다.

브랜드 메시지는 이와 별개로 08:00~20:50(KST)에만 나갑니다. 즉시 발송이든 예약이든 그 밖의 시각이면 6966 으로 거절되고, 응답의 data.suggestedScheduleAt 에 다음 발송 가능 시각이 담깁니다. 그 값을 scheduledAt 으로 넣어 다시 요청하면 됩니다.

예약 상태 확인

• 발송 그룹 결과의 scheduledAt 으로 언제 나갈 예정인지 확인합니다.
• 취소된 예약은 status 가 CANCELED 이고 canceledAt 에 취소 시각이 들어갑니다.