대화방 승인 요청 취소

Request

지정된 대화방(발신번호, 양방향ID)의 승인요청을 취소합니다.

put

지정된 대화방(발신번호, 양방향ID)의 승인요청을 취소합니다.

• 계정 권한: 마스터, 매니저, 대행사

• 브랜드 권한: 브랜드 대표운영자, 운영자

각 상태별 취소 요청 동작은 다음과 같습니다.

• 승인대기 : 저장 상태로 변경

• 승인대기(수정) : 직전 승인 상태 및 데이터로 롤백

• 반려(수정) : 직전 승인 상태 및 데이터로 롤백

• 이외의 경우 에러 리턴

Authorizations

Path parameters

brandIdstring · max: 13Required

maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.

chatbotIdstringRequired

브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.

Header parameters

X-RCS-Brandkeystring · max: 18Optional

maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.

대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.

put

HTTPcURLJavaScriptPython

PUT /api/1.1/brand/{brandId}/chatbot/{chatbotId}/cancel HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Accept: */*

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<object>		O		대화방ID(=chatbotId)
code	string	5	O	20000000
status	integer	3	O	200
desc	string		O

result - array<object>

필드명	타입	길이	필수여부	기본값	설명
chatbotId	string		O		대화방ID(=chatbotId)

❖ response body sample

200

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "chatbotId": "15330001"
        }
    ],
    "status": 200
}

400

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "status": 400
}

401

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

403

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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