대행사_webhookUri

Request

대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다.

대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다.
등록/수정/삭제 알림 대상은 다음과 같습니다.

• 브랜드 계약(권한) 등록
• 브랜드 수정/반려
• 대화방 승인/수정/반려/삭제
• 템플릿 승인/수정/반려/삭제
• 자동응답메시지 등록/수정/삭제
• 신규 포멧/템플릿 상품 등록
• 대행사 키 재발급
• 레아아웃 등록/수정/삭제
• 로고 승인/수정/반려/삭제

post

/{webhookUrl}

Authorizations

Path parameters

webhookUrlstringrequired

RBC에 등록된 대행사 계정 정보 상에 대행사가 직접 등록한 수신서버(Webhook) URL 정보입니다.

Body

one of

대행사 키가 재발급된 경우에 한하여 전달됩니다. 삭제 시에는 전송되지 않습니다.

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/{webhookUrl}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "notiType": "text",
    "corpId": "text",
    "corpRegNum": "text",
    "brandId": "text",
    "method": "rejected",
    "reason": "text"
  }'

❖ request body sample

브랜드계약

{
      "notiType": "contract",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

대화방

{
      "notiType": "chatbot",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

템플릿양식

{
      "notiType": "messagebaseform",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

템플릿

{
      "notiType": "template",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

포멧

{
      "notiType": "format",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

브랜드

{
      "notiType": "brand",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

자동응답

{
      "notiType": "autoreplymsg",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

대행사키

{
      "notiType": "agencykey",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

레이아웃

{
      "notiType": "formatbr",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

로고

{
      "notiType": "logo",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

Response

필드명	타입	길이	필수여부	기본값	설명
status	string		O		200 : 성공적으로 알림을 수신하였을 경우 응답합니다. 400 : 대행사 측 청약이 우선 처리되지 않은 상태에서 'contract'가 전달된 경우 필히 응답되어야 합니다.
error	object

error - object

필드명	타입	길이	필수여부	기본값	설명
code	string
message	string

❖ response body sample

200

{
  "status": "200",
  "error": {
    "code": "",
    "message": ""
  }
}

400

{
  "status": "400",
  "error": {
    "code": "69999",
    "message": "No Subscription"
  }
}

error code는 RCS Biz Center - Response body error code 참조