# 대화방 메뉴 등록

## Request

## 대화방에 대화방메뉴를 등록합니다.<br>

> 대화방에 대화방메뉴를 등록합니다.\
> \
> 대화방 메뉴 개편으로 상위 메뉴, 하위 메뉴 구분 없이 최대 5개까지 메뉴를 지정할 수 있습니다.    \
> \
> 대화방 메뉴 등록 시 대화방메뉴 정보는 등록하지만 대화방에서의 사용여부를 미사용으로 설정할 수 있습니다.  \
> \
> ※  대표번호 문자서비스가 설정된 대화방에는 대화방메뉴를 등록할 수 없습니다. 즉, rcsReply 값이 1인 대화방에만 대화방메뉴를 설정할 수 있습니다.\
> \
> &#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"},"ChatbotId":{"name":"chatbotId","in":"path","description":"브랜드 내 대화방 정보 접근시 사용되는 대화방ID Path Parameter 입니다.\n","schema":{"type":"string"},"required":true}},"schemas":{"RegPersistentMenu":{"type":"object","properties":{"menu":{"type":"array","items":{"$ref":"#/components/schemas/RegPersistentMenu_L1"}}}},"RegPersistentMenu_L1":{"description":"대화방메뉴 버튼 정보입니다.","type":"object","properties":{"type":{"type":"string","description":"대화방 메뉴를 구성하는 메뉴 버튼의 유형입니다.\n\n  - reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)\n  - feed : 브랜드 소식 연결 버튼\n  - action : RCS 액션 지정 버튼 \n","enum":["reply","feed","action"]},"title":{"type":"string","description":"maxLength: 25 - 메뉴버튼에 표시되는 메뉴명입니다.\n","maxLength":25},"ordNo":{"type":"number","description":"메뉴버튼 순서 값입니다.\n"},"autoReplyMsgId":{"type":"string","description":"type이 'reply' 인 경우, 자동응답메시지 ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지 ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.\n"},"feedId":{"type":"string","description":"type이 'feed' 인 경우, 브랜드 소식 ID 지정 시 해당 소식이 연결됩니다.  \n"},"actionType":{"type":"string","description":"type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다.  \n\n  - dialerAction : 전화연결  \n  - urlAction : 웹사이트 연결\n","enum":["dialerAction","urlAction"]},"action":{"type":"object","oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"}]}},"required":["type","title","ordNo"]},"urlAction":{"description":"Suggested actions to interact a website or deep app link.","properties":{"urlAction":{"type":"object","oneOf":[{"properties":{"openUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}},"required":["openUrl"]}]}},"required":["urlAction"]},"dialerAction":{"description":"Suggested actions for interacting with a phone number.","properties":{"dialerAction":{"type":"object","oneOf":[{"properties":{"dialPhoneNumber":{"type":"object","properties":{"phoneNumber":{"type":"string"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["phoneNumber"]}},"required":["dialPhoneNumber"]}]}},"required":["dialerAction"]}}},"paths":{"/brand/{brandId}/bidirectional/chatbot/{chatbotId}/persistentmenu":{"post":{"summary":"대화방에 대화방메뉴를 등록합니다.\n","description":"대화방에 대화방메뉴를 등록합니다.\n\n대화방 메뉴 개편으로 상위 메뉴, 하위 메뉴 구분 없이 최대 5개까지 메뉴를 지정할 수 있습니다.    \n\n대화방 메뉴 등록 시 대화방메뉴 정보는 등록하지만 대화방에서의 사용여부를 미사용으로 설정할 수 있습니다.  \n\n※  대표번호 문자서비스가 설정된 대화방에는 대화방메뉴를 등록할 수 없습니다. 즉, rcsReply 값이 1인 대화방에만 대화방메뉴를 설정할 수 있습니다.\n\n  + **계정 권한 : 마스터, 매니저, 대행사**  \n  + **브랜드 권한 : 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/ChatbotId"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"psMenuUse":{"type":"boolean","description":"대화방메뉴 사용 여부입니다.  \n\n  + true : 사용  \n  + false : 미사용\n","default":true},"persistentMenu":{"$ref":"#/components/schemas/RegPersistentMenu"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="양방향대화방메뉴" %}

```
{
    "psMenuUse": false,
    "persistentMenu": {
        "menu": [
            {
                "type": "action",
                "title": "119연락",
                "ordNo": 0,
                "actionType": "dialerAction",
                "action": {
                    "dialerAction": {
                        "dialPhoneNumber": {
                            "phoneNumber": "119"
                        }
                    }
                }
            },
            {
                "ordNo": "1",
                "title": "API버튼1",
                "type": "feed",
                "feedId": "BR.vt0HGdJXG0.cUmR1s689n"
            }
        ]
    }
}
```

{% 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="192">필드명</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><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>대화방 메뉴를 구성하는 메뉴 버튼의 유형입니다.</p><ul><li>reply : 응답 메뉴 버튼(챗봇응답 or 자동메시지)</li><li>feed : 브랜드 소식 연결 버튼</li><li>action : RCS 액션 지정 버튼</li></ul></td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼에 표시되는 메뉴명입니다.</td></tr><tr><td><strong><code>ordNo</code></strong></td><td>number</td><td align="center"></td><td align="center">O</td><td></td><td>메뉴버튼 순서 값입니다.</td></tr><tr><td><strong><code>autoReplyMsgId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'reply' 인 경우, 자동응답메시지 ID 지정 시 자동응답메시지가 할당됩니다. 자동응답메시지 ID를 지정하지 않은 경우에는 챗봇응답으로 할당됩니다.</td></tr><tr><td><strong><code>feedId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>type이 'feed' 인 경우, 브랜드 소식 ID 지정 시 해당 소식이 연결됩니다.</td></tr><tr><td><strong><code>actionType</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>type이 'action'인 경우, 사용할 RCS 액션 유형을 지정합니다.</p><ul><li>dialerAction : 전화연결</li><li>urlAction : 웹사이트 연결</li></ul></td></tr><tr><td><strong><code>action</code></strong></td><td>object</td><td align="center"></td><td align="center"></td><td></td><td></td></tr></tbody></table>

{% hint style="info" %}
[**버튼 Action 목록 Link (2023.12.14)**](https://file.rcsbizcenter.com/231214143124234/TS-231214143124234-fVDQnA_1.xlsx)
{% endhint %}

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "postbackId": "P7r9Gr5W0XM6RyQ",
            "upPostbackId": "",
            "type": "action",
            "title": "119연락",
            "ordNo": "10",
            "autoReplyMsgId": "",
            "actionType": "dialerAction",
            "action": {
                "dialerAction": {
                    "dialPhoneNumber": {
                        "phoneNumber": "119"
                    }
                }
            },
            "chatbotId": "07082245290",
            "armIdName": null
        }, 
        {
            "postbackId": "PObF8R4XtopwoW2",
            "upPostbackId": "",
            "type": "feed",
            "title": "API버튼1",
            "ordNo": "20",
            "autoReplyMsgId": "",
            "actionType": "urlAction",
            "action": {
                "urlAction": {
                    "openUrl": {
                        "url": "https://biz-qa.chatplus.co.kr/brand/BR.vt0HGdJXG0/feed/BR.vt0HGdJXG0.cUmR1s689n"
                    }
                }
            },
            "chatbotId": "07082245290",
            "armIdName": null
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.rcsbizcenter.com/rbc-api/bidirect_chatbot/post_bidirect_chatbot_pmenu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.