양방향 대화방 등록

Request

대화방(양방향)을 등록합니다.

post

양방향ID를 이용한 대화방을 등록하거나 대화방에 다음과 같은 사항을 연결을 하고자 하는 경우 사용합니다.

• 양방향ID 대화방 등록
• 발신번호 또는 양방향ID 대화방에 대화방 메뉴 등록
• 발신번호 또는 양방향ID 대화방에 양방향 서비스 대행사 연결(자동응답메시지, 챗봇 사용)

대화방명 등록/변경 시 RBC 운영자 검수 승인 후 등록됩니다.

• 발신번호를 이용한 양방향 대화방 전환 등록 시 대화방명이 변경된 경우
• 사용자 입력 양방향ID를 이용한 신규 양방향 대화방 등록 시

• 계정 권한 : 마스터, 매니저, 대행사
• 브랜드 권한 : 브랜드 대표운영자, 운영자

Authorizations

Path parameters

brandIdstring · max: 13Required

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

Header parameters

X-RCS-Brandkeystring · max: 18Optional

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

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

Body

post

HTTPcURLJavaScriptPython

POST /api/1.1/brand/{brandId}/bidirectional/chatbot HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 171

{
  "chatbot": {
    "chatbotId": "text",
    "subNum": "text",
    "subTitle": "text",
    "display": "11",
    "service": "a2p",
    "inputField": 0,
    "botAgencyId": "text",
    "subDescr": "text",
    "saftyStatusYn": "Y"
  }
}

❖ request body sample

대화방(양방향) 정보

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

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<object>		O		대화방 기본 정보입니다.
code	string	5	O	20000000
status	integer	3	O	200
desc	string		O

result - array<object>

필드명	타입	길이	필수여부	기본값	설명
groupId	string	10			대화방이 대량등록된 경우 그룹ID 입니다.
chatbotId	string	15	O		대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.
brandId	string	13	O		브랜드ID
subNum	string	40			회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.
isMainNum	boolean				대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.
subTitle	string	20			대화방명입니다.
service	string			a2p	대화방 유형입니다. a2p : 발신번호를 이용한 대화방 chat : 양방향ID를 이용한 대화방
display	string				단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다. 브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다. '11' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 전시 '10' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 비전시 '01' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 전시 '00' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 비전시
inputField	integer			1	단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다. 0 : 비활성화 1 : 활성화
subDescr	string	50			대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.
botAgencyId	string	20			양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.
saftyStatusYn	string			Y	안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다. 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

200

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "chatbotId": "07082245290",
            "brandId": "BR.u720xwadx0",
            "subNum": "07082245290",
            "subTitle": "대화방(양방향)",
            "service": "a2p",
            "display": "01",
            "webhook": "http://demo9295359.mockable.io/",
            "botTcPage": "http://www.rcsbizcenter.com",
            "inputField": 1,
            "botAgencyId": "twRcsCorpAgency",
            "psMenuUse": false,
            "saftyStatusYn": "N",
            "subDescr": "null",
            "approvalResult": "승인대기",
            "registerDate": "2024-06-18 09:42:21",
            "approvalDate": "2024-06-18 09:48:37",
            "updateDate": "2024-06-26 09:15:31",
            "registerId": "swjeong75",
            "updateId": null
        }
    ],
    "status": 200
}

400

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

{
    "error": {
        "code": "64304",
        "message": "Over specified size (chatbotId)"
    },
    "status": 400
}

{
    "error": {
        "code": "64383",
        "message": "the value of subnum does not exist or is not valid"
    },
    "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 참조