1 of 1

양방향 대화방 수정

Request

❖ request body sample

{
    "chatbot": {
        "subNum": "07082245290",
        "subTitle": "대화방(양방향)",
        "display": "11",
        "service": "a2p",
        "inputField": 1,
        "botAgencyId": "twRcsCorpAgency",
        "subDesr": "대화방 검색 시 노출되는 소개글",
        "saftyStatusYn": "Y"
    }
}

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

대화방 기본 정보입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

chatbotId

string

대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.

brandId

string

브랜드ID

subNum

string

회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.

isMainNum

boolean

대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.

subTitle

string

대화방명입니다.

service

string

대화방 유형입니다.

a2p : 발신번호를 이용한 대화방
chat : 양방향ID를 이용한 대화방

display

string

단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다. 브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.

'11' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 전시
'10' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 비전시
'01' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 전시
'00' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 비전시

inputField

integer

단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.

0 : 비활성화
1 : 활성화

subDescr

string

대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.

botAgencyId

string

양방향 대화방 서비스 계약 관계에 있는 대행사ID로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다. 예를들어 양방향ID 대화방을 생성하는 경우 대행사ID를 지정하지 않아도 생성이 가능합니다. 대화방(발신번호)를 전환하는 경우에는 반드시 대행사ID를 지정해야 합니다.

기업에서 양방향 대화방 등록 시: 브랜드 대행사 중 양방향 서비스가 가능한 대행사ID 지정
양방향 서비스 대행사에서 양방향 대화방 등록 시: 연계된 중계사의 RBC 등록ID 지정(RBC 등록 ID는 해당 중계사에 직접 확인)

saftyStatusYn

string

안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.

Y : 안심마크 표시
N : 안심마크 미표시

psMenuUse

boolean

false

대화방메뉴 사용 여부입니다.

true : 사용
false : 미사용

approvalResult

string

대화방의 승인 상태입니다.

저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.
승인대기 : 대화방 등록 직후 검수 이전 상태입니다.
검수시작 : 대화방 검수가 시작된 상태입니다.
승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.
반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.
검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.
검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.

registerDate

string

대화방 등록일시

approvalDate

string

대화방 승인일시

updateDate

string

대화방 수정일시

registerId

string

대화방 등록 계정 ID

updateId

string

대화방 수정 계정 ID

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "07082245290",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "isMainNum": true,
            "subTitle": "대화방(양방향)",
            "service": "a2p",
            "display": "11",
            "inputField": 1,
            "subDescr": null,
            "botAgencyId": "twRcsCorpAgency",
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인대기(수정)",
            "registerDate": "2024-06-26T09:54:55.000+09",
            "approvalDate": "2024-06-26T09:54:39.000+09",
            "updateDate": "2024-06-26T09:54:55.000+09",
            "registerId": "hong",
            "updateId": "hong",
            "mediaUrl": [
                {
                    "fileId": "LT-common-Cni7oQ",
                    "fileName": "교육.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-Cni7oQ_1.png",
                    "typeName": "profile"
                }
            ],
            "approvalReason": "승인완료",
            "status": "published",
            "rcsReply": "1",
            "searchWeight": "512",
            "webhook": "http://demo9295359.mockable.io/",
            "botTcPage": "http://www.rcsbizcenter.com"
        }
    ],
    "status": 200
}

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

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

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

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

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

양방향 대화방 수정

Request

❖ request body sample

{
    "chatbot": {
        "subNum": "07082245290",
        "subTitle": "대화방(양방향)",
        "display": "11",
        "service": "a2p",
        "inputField": 1,
        "botAgencyId": "twRcsCorpAgency",
        "subDesr": "대화방 검색 시 노출되는 소개글",
        "saftyStatusYn": "Y"
    }
}

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

대화방 기본 정보입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

chatbotId

string

대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.

brandId

string

브랜드ID

subNum

string

회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.

isMainNum

boolean

대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.

subTitle

string

대화방명입니다.

service

string

대화방 유형입니다.

a2p : 발신번호를 이용한 대화방
chat : 양방향ID를 이용한 대화방

display

string

'11' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 전시
'10' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 비전시
'01' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 전시
'00' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 비전시

inputField

integer

단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.

0 : 비활성화
1 : 활성화

subDescr

string

대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.

botAgencyId

string

기업에서 양방향 대화방 등록 시: 브랜드 대행사 중 양방향 서비스가 가능한 대행사ID 지정
양방향 서비스 대행사에서 양방향 대화방 등록 시: 연계된 중계사의 RBC 등록ID 지정(RBC 등록 ID는 해당 중계사에 직접 확인)

saftyStatusYn

string

안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.

Y : 안심마크 표시
N : 안심마크 미표시

psMenuUse

boolean

false

대화방메뉴 사용 여부입니다.

true : 사용
false : 미사용

approvalResult

string

대화방의 승인 상태입니다.

저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.
승인대기 : 대화방 등록 직후 검수 이전 상태입니다.
검수시작 : 대화방 검수가 시작된 상태입니다.
승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.
반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.
검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.
검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.

registerDate

string

대화방 등록일시

approvalDate

string

대화방 승인일시

updateDate

string

대화방 수정일시

registerId

string

대화방 등록 계정 ID

updateId

string

대화방 수정 계정 ID

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "chatbotId": "07082245290",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "isMainNum": true,
            "subTitle": "대화방(양방향)",
            "service": "a2p",
            "display": "11",
            "inputField": 1,
            "subDescr": null,
            "botAgencyId": "twRcsCorpAgency",
            "saftyStatusYn": "N",
            "psMenuUse": false,
            "approvalResult": "승인대기(수정)",
            "registerDate": "2024-06-26T09:54:55.000+09",
            "approvalDate": "2024-06-26T09:54:39.000+09",
            "updateDate": "2024-06-26T09:54:55.000+09",
            "registerId": "hong",
            "updateId": "hong",
            "mediaUrl": [
                {
                    "fileId": "LT-common-Cni7oQ",
                    "fileName": "교육.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-Cni7oQ_1.png",
                    "typeName": "profile"
                }
            ],
            "approvalReason": "승인완료",
            "status": "published",
            "rcsReply": "1",
            "searchWeight": "512",
            "webhook": "http://demo9295359.mockable.io/",
            "botTcPage": "http://www.rcsbizcenter.com"
        }
    ],
    "status": 200
}

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

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

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

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

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

양방향 대화방 수정

Request

❖ request body sample

Response

result - array<object>

❖ response body sample

양방향 대화방 수정

Request

❖ request body sample

Response

result - array<object>

❖ response body sample

대화방(양방향) 정보를 수정 합니다.