스케줄 객체

캠페인 및 캔버스 일정 생성 엔드포인트의 매개변수는 전송 엔드포인트의 매개변수를 반영하고 schedule 매개변수를 추가하여 타겟 사용자가 메시지를 수신할 시기를 지정할 수 있습니다. schedule 객체에 time 매개변수만 포함하면 Braze는 해당 시점에 모든 사용자에게 메시지를 보냅니다.

in_local_time 을 true 으로 설정하면 모든 시간대에서 시간 매개 변수가 지나간 경우 오류 응답이 표시됩니다. at_optimal_time 을 true로 설정하면 사용자가 지정한 날짜에 최적의 시간에 메시지를 받게 됩니다(제공한 시간에 관계없이). 현지 시간 또는 최적 시간 전송을 사용하는 경우 시간 매개변수 값에 시간대 지정자를 제공하지 마세요(예: "2015-02-20T13:14:47-05:00" 대신 "2015-02-20T13:14:47" 사용).

이 응답은 나중에 예약한 메시지를 취소하거나 업데이트해야 할 경우를 대비하여 저장해야 하는 schedule_id 주소를 제공합니다:

개체 본문

필요에 따라 이 개체를 삽입하여 메시지를 예약하세요.

1
2
3
4
5
"schedule": {
  "time": (required, datetime as ISO 8601 string) time to send the message in UTC,
  "in_local_time": (optional, bool),
  "at_optimal_time": (optional, bool),
}

ID 응답 예약

생성한 예약 메시징에 대한 schedule_id 이메일이 수신됩니다.

1
2
3
{
  "schedule_id" : (required, string) identifier for the scheduled message you created
}

서버 간 호출에 API를 사용하는 경우 방화벽 뒤에 있는 경우 적절한 API URL을 허용 목록에 추가해야 할 수 있습니다.

메시지 스케줄링 엔드포인트 응답에는 메시지 발송을 다시 참조할 수 있도록 메시지의 dispatch_id 이 포함됩니다. dispatch_id 은 메시지 발송의 ID(Braze에서 보낸 각 ‘전송’에 대한 고유 ID)입니다.