예약된 API 트리거 캠페인 업데이트

이 엔드포인트를 사용하여 대시보드에서 생성된 예약된 API 트리거 캠페인을 업데이트하여 어떤 작업을 트리거하여 메시지를 보낼지 결정할 수 있습니다.

메시지 자체에 템플릿이 지정된 trigger_properties 을 전달할 수 있습니다.

이 엔드포인트로 메시지를 보내려면 API 트리거 캠페인을 만들 때 생성한 캠페인 ID가 있어야 합니다.

모든 일정은 일정 생성 요청 또는 이전 업데이트 일정 요청에서 제공한 일정을 완전히 덮어씁니다. 예를 들어 원래 일정을 "schedule" : {"time" : "2015-02-20T13:14:47", "in_local_time" : true} 으로 설정했다가 나중에 "schedule" : {"time" : "2015-02-20T14:14:47"} 으로 업데이트하면 이제 사용자의 현지 시각이 아닌 UTC로 지정된 시간에 메시지가 전송됩니다.

예약된 트리거는 전송 예정 시간에 매우 가깝게 또는 그 시간에 업데이트되어 마지막 초의 변경 사항이 타겟팅된 사용자 전체, 일부 또는 전혀에게 적용될 수 있도록 최선을 다해 업데이트됩니다. 원래 일정이 현지 시간을 사용했고 어떤 시간대에서든 원래 시간이 이미 지난 경우에는 업데이트가 적용되지 않습니다.

필수 구성 요소

이 엔드포인트를 사용하려면 campaigns.trigger.schedule.update 권한이 있는 API 키가 필요합니다.

사용량 제한

API 속도 제한에 설명된 대로 이 엔드포인트에 시간당 250,000건의 기본 Braze 속도 제한을 적용합니다.

요청 본문

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3
4
5
6
7
{
  "campaign_id": (required, string) see campaign identifier,
  "schedule_id": (required, string) the `schedule_id` to update (obtained from the response to create schedule),
  "schedule": {
    // required, see create schedule documentation
  }
}

요청 매개변수

요청 예시

1
2
3
4
5
6
7
8
9
10
11
curl --location --request POST 'https://rest.iad-01.braze.com/campaigns/trigger/schedule/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "campaign_id": "campaign_identifier",
  "schedule_id": "schedule_identifier",
  "schedule": {
    "time": "2017-05-24T21:30:00Z",
    "in_local_time": true
  }
}'