API

그룹 메시지 예약

작성일 2026.03.05 | 수정일 2026.03.05

POST/messages/v4/groups/:groupId/schedule

Parameters

groupId*— 예약 설정할 그룹의 아이디

그룹 메시지를 지정된 시간에 자동으로 발송하도록 예약합니다. 마케팅 메시지를 특정 시간대에 맞춰 발송하거나, 업무 시간 외에 발송을 준비해두고 싶을 때 활용할 수 있습니다.
PENDING 상태인 그룹만 예약할 수 있으며, 예약 시간은 현재 시간 이후 ~ 최대 6개월 이내여야 합니다.

Body Params

Name	Type	Required	Description
scheduledDate	string	*	예약 발송 일시 (ISO 8601). 현재 시간 이후, 최대 6개월 이내. 타임존을 포함하여 정확한 시간을 지정 (예: 2024-06-01T09:00:00+09:00)

Response

그룹 객체가 반환됩니다. 응답 스키마는 공통 그룹 객체 응답 스키마 및 그룹 객체 구조를 참조하세요.

Structure

Request

{
  "scheduledDate": "2024-06-01T09:00:00+09:00"
}