# 양방향 대화방 수정

## 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.12"},"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"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}},"schemas":{"ModBiChatbot":{"description":"양방향 대화방 정보 객체입니다.\n","type":"object","properties":{"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  + '11' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 전시  \n  + '10' : 브랜드채널 노출 및 브랜드검색 허용 & 브랜드홈 비전시  \n  + '01' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 전시  \n  + '00' : 브랜드채널 노출 및 브랜드검색 불허 & 브랜드홈 비전시\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이미 양방향 대화방으로 전환된 발신번호의 경우, botAgencyId를 빈값으로 설정하면 일반 발신번호로 전환됩니다.(DELETE /brand/{brandId}/bidirectional/chatbot/{chatbotId}과\n동일)\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"}}}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}":{"put":{"summary":"대화방(양방향) 정보를 수정 합니다.\n","description":"대화방(양방향) 정보를 수정 합니다.  \n양방향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"},{"$ref":"#/components/parameters/ChatbotId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"chatbot":{"$ref":"#/components/schemas/ModBiChatbot"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

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

```
{
    "chatbot": {
        "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>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": [
        {
            "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
}
```

{% endtab %}

{% tab title="400" %}

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

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "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](https://apidocs.rcsbizcenter.com/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}