> For the complete documentation index, see [llms.txt](https://apidocs.rcsbizcenter.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.rcsbizcenter.com/rbc-api/bidirect_chatbot/post_bidirect_chatbot.md).

# 양방향 대화방 등록

## Request

## 대화방(양방향)을 등록합니다.<br>

> 양방향ID를 이용한 대화방을 등록하거나 대화방에 다음과 같은 사항을 연결을 하고자 하는 경우 사용합니다.  \
> &#x20; \
> &#x20; \+ 양방향ID 대화방 등록  \
> &#x20; \+ 발신번호 또는 양방향ID 대화방에 대화방 메뉴 등록  \
> &#x20; \+ 발신번호 또는 양방향ID 대화방에 양방향 서비스 대행사 연결(자동응답메시지, 챗봇 사용)  \
> \
> 대화방명 등록/변경 시 RBC 운영자 검수 승인 후 등록됩니다.    \
> \
> &#x20; \+ 발신번호를 이용한 양방향 대화방 전환 등록 시 대화방명이 변경된 경우  \
> &#x20; \+ 사용자 입력 양방향ID를 이용한 신규 양방향 대화방 등록 시  \
> \
> &#x20; \- \*\*계정 권한 : 마스터, 매니저, 대행사\*\*  \
> &#x20; \- \*\*브랜드 권한 : 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBiChatbot":{"description":"대화방(양방향) 정보 객체입니다.\n","type":"object","properties":{"chatbotId":{"type":"string","maxLength":15,"description":"maxLength: 15 - 대화방(양방향)으로 등록/전환하고자 하는 chatbotId를 지정합니다.  \n\n  + 발신번호(service = 'A2P')인 경우, 사전에 승인된 발신번호의 chatbotId를 입력합니다.\n  + 양방향ID(service = 'CHAT')를 새로 등록하는 경우, 원하는 문자열을 입력합니다.  \n\n**양방향ID(service 구분값: 'CHAT')의 포맷 규칙은 다음과 같습니다.**  \n\n  + chatbotId는 생략할 수 있으며 RBC에서 랜덤으로 chatbotId 생성하여 리턴합니다.  \n  + 등록 시 사용 가능한 문자는 alphanumeric, '-', '_' 만 허용 됩니다.  \n  + 알파벳은 대문자 입력시 소문자로 변환되어 처리됩니다.  \n  + 'bot-' prefix 가 기본 삽입됩니다.  \n  + 'bot-' prefix 삽입된 된 문자열 사용이 가능하며, 이때는 'bot-' prefix를 RBC에서 추가하지 않습니다.  \n  + 'bot-' prefix 포함 시 최대 15자리 입력이 가능하므로 'bot-'외 사용 가능한 문자열의 길이는 11자리 입니다.\n  + API 호출 시 입력한 chatbotId에 bot- prefix 삽입, 소문자 변환 등 변경이 발생할 수 있으므로 반드시 API 응답으로 리턴되는 chatbotId를 취득 사용해야 합니다.\n"},"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다.  \n\nA2P는 chatbotId와 동일하며, 생략 가능합니다.  \n\nservice가 chat인 경우 사전에 승인된 대화방(발신번호) 중 하나를 반드시 지정해야 합니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.  \n\n브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지\n수신이 불가능합니다.  \n\n  + '11' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 전시  \n  + '10' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 비전시  \n  + '01' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 전시  \n  + '00' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 비전시\n"},"service":{"type":"string","enum":["a2p","chat"],"default":"a2p","description":"대화방 유형입니다.  \n\n  + a2p : 발신번호를 이용한 대화방\n  + chat : 양방향ID를 이용한 대화방\n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"botAgencyId":{"type":"string","description":"maxLength: 20 - 양방향 대화방 서비스 계약 관계에 있는 대행사ID로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.    \n\n예를들어 양방향ID 대화방을 생성하는 경우 대행사ID를 지정하지 않아도 생성이 가능합니다.  \n\n대화방(발신번호)를 전환하는 경우에는 반드시 대행사ID를 지정해야 합니다.  \n\n  + 기업에서 양방향 대화방 등록 시: 브랜드 대행사 중 양방향 서비스가 가능한 대행사ID 지정  \n  + 양방향 서비스 대행사에서 양방향 대화방 등록 시: 연계된 중계사의 RBC 등록ID 지정(RBC 등록 ID는 해당 중계사에 직접 확인)\n","maxLength":20},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}},"required":["chatbotId","service","subTitle","subNum","inputField"]}}},"paths":{"/brand/{brandId}/bidirectional/chatbot":{"post":{"summary":"대화방(양방향)을 등록합니다.\n","description":"양방향ID를 이용한 대화방을 등록하거나 대화방에 다음과 같은 사항을 연결을 하고자 하는 경우 사용합니다.  \n  \n  + 양방향ID 대화방 등록  \n  + 발신번호 또는 양방향ID 대화방에 대화방 메뉴 등록  \n  + 발신번호 또는 양방향ID 대화방에 양방향 서비스 대행사 연결(자동응답메시지, 챗봇 사용)  \n\n대화방명 등록/변경 시 RBC 운영자 검수 승인 후 등록됩니다.    \n\n  + 발신번호를 이용한 양방향 대화방 전환 등록 시 대화방명이 변경된 경우  \n  + 사용자 입력 양방향ID를 이용한 신규 양방향 대화방 등록 시  \n\n  - **계정 권한 : 마스터, 매니저, 대행사**  \n  - **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"chatbot":{"$ref":"#/components/schemas/RegBiChatbot"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="대화방(양방향) 정보" %}

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

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="120">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>대화방 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="219">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="91">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center">10</td><td align="center"></td><td></td><td>대화방이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>chatbotId</code></strong></td><td>string</td><td align="center">15</td><td align="center">O</td><td></td><td>대화방(발신번호)ID, A2P의 경우 발신번호(mdn)과 동일합니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드ID</td></tr><tr><td><strong><code>subNum</code></strong></td><td>string</td><td align="center">40</td><td align="center"></td><td></td><td>회신번호 A2P의 경우 발신번호, 즉 chatbotId와 동일합니다.</td></tr><tr><td><strong><code>isMainNum</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td></td><td>대표번호 개념은 더 이상 유효하지 않습니다. 브랜드에 등록된 대화방 중 유효한 첫번째 대화방이 표시됩니다.</td></tr><tr><td><strong><code>subTitle</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>대화방명입니다.</td></tr><tr><td><strong><code>service</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>a2p</td><td><p>대화방 유형입니다.</p><ul><li>a2p : 발신번호를 이용한 대화방</li><li>chat : 양방향ID를 이용한 대화방</li></ul></td></tr><tr><td><strong><code>display</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>단말에서 대화방의 검색 및 RCS대화방 노출 여부를 설정합니다.<br>브랜드홈 전시로 설정되면 대화방은 RCS메시지 수신이 가능하게 되며, 반대로 브랜드홈 비전시 설정 시에는 RCS메시지 수신이 불가능합니다.</p><ul><li>'11' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 전시</li><li>'10' : 브랜드채널 노출 및 브랜드검색 허용 &#x26; 브랜드홈 비전시</li><li>'01' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 전시</li><li>'00' : 브랜드채널 노출 및 브랜드검색 불허 &#x26; 브랜드홈 비전시</li></ul></td></tr><tr><td><strong><code>inputField</code></strong></td><td>integer</td><td align="center"></td><td align="center"></td><td>1</td><td><p>단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.</p><ul><li>0 : 비활성화</li><li>1 : 활성화</li></ul></td></tr><tr><td><strong><code>subDescr</code></strong></td><td>string</td><td align="center">50</td><td align="center"></td><td></td><td>대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.</td></tr><tr><td><strong><code>botAgencyId</code></strong></td><td>string</td><td align="center">20</td><td align="center"></td><td></td><td>양방향 대화방 서비스 계약 관계에 있는 대행사ID(중계사)로 자동응답메시지 과금 및 챗봇 연동에 사용됩니다.</td></tr><tr><td><strong><code>saftyStatusYn</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td>Y</td><td><p>안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.</p><ul><li>Y : 안심마크 표시</li><li>N : 안심마크 미표시</li></ul></td></tr><tr><td><strong><code>psMenuUse</code></strong></td><td>boolean</td><td align="center"></td><td align="center"></td><td>false</td><td><p>대화방메뉴 사용 여부입니다.</p><ul><li>true : 사용</li><li>false : 미사용</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>대화방의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 대화방 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 대화방 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 대화방 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 대화방 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 대화방은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>검수완료(수정) : 승인된 대화방의 이름을 변경하였으나 이통3사 정보 등록이 완료되지 않은 상태입니다.<br>현재 상태에서는 이통사에 따라 단말 표시 대화방 이름이 다를 수 있습니다.</li></ul></td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>대화방 수정 계정 ID</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="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
}
```

{% endtab %}

{% tab title="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
}
```

{% endtab %}

{% tab title="401" %}

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

{% endtab %}

{% tab title="403" %}

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

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code.md#rcs-biz-center-response-body-error-code) 참조
{% endhint %}