> 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/autoreplymsg/post_autoreplymsg.md).
# 자동응답 메시지 등록
## Request
## 브랜드에 자동응답메시지를 등록합니다.
> 브랜드에 자동응답메시지를 등록합니다. \
> \
> \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\* \
> \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\* \
> \
> 제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다. \
> \*\*2026.4.21 부터 모든 자동응답메시지는 통합RCS 규격으로만 사용이 가능합니다.\*\* \
> \+ 말풍선: TMCSA00001\
> \+ (이미지가 없는) 카드: RPCSAXX001 \
> \+ (세로형 Tall 이미지) 카드: RPCSMTX001\
> \+ (세로형 Medium 이미지) 카드: RPCSMMX001 \
> \+ 슬라이드형 미제공 \
> \
> 자동응답메시지에 등록 가능한 액션은 다음과 같습니다. \
> \+ 전화걸기\
> \+ 브랜드 소식 연결\
> \+ URL연결 \
> \+ 다른 대화방연결\
> \+ 캘린더 등록\
> \+ 지도 보여주기(좌표)\
> \+ 지도 보여주기(쿼리)\
> \+ 사용자 위치 공유\
> \+ 자동응답메시지 연결\
> \+ 챗봇연결
```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":{"RegAutoReplyMsgInfo":{"required":["autoReplyMsgName","messagebaseId","body"],"description":"자동응답메시지 등록/수정 시 필요한 정보입니다.\n","type":"object","properties":{"autoReplyMsgName":{"type":"string","maxLength":100,"description":"maxLength: 100 - 자동응답메시지 명을 지정합니다.\n"},"messagebaseId":{"type":"string","maxLength":40,"description":"maxLength: 40 - 메시지 상품코드 chat에 속하는 messagebase ID를 지정합니다. \n"},"copyAllowed":{"type":"boolean","default":true,"description":"단말에서 메시지 복사 가능 여부를 지정합니다. \n\n + true : 복사 가능\n + false : 복사 불가\n"},"body":{"type":"object","description":"이통 발송규격 중 /message API의 body object와 동일한 방식으로 값을 지정합니다. \n"},"buttons":{"description":"자동응답메시지에 버튼을 등록합니다.\n\n지원하는 action 유형은 다음과 같습니다. \n\n + urlAction : URL 연결, 브랜드 소식 연결(브랜드 소식의 URL을 넣어주면 됩니다.) \n + mapAction : 지도 보여주기(좌표), 지도 보여주기(쿼리), 사용자 위치 공유 \n + calendarAction : 캘린더 등록 \n + composeAction : 지정 대화방에 메시지 작성 \n + dialerAction : 전화걸기 \n + reply : 챗봇연결, 자동응답메시지 연결(다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.)\n\n**clipboardAction, localBrowserAction 은 2026.04.21 부터 더 이상 지원하지 않습니다.** \n","type":"array","items":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/AutoReplyMsgActions"}}}}},"chipList":{"description":"자동응답메시지에 칩리스트를 지정합니다. \n\n지원하는 action 유형은 다음과 같습니다. \n\n + urlAction : URL 연결, 브랜드 소식 연결(브랜드 소식의 URL을 넣어주면 됩니다.) \n + mapAction : 지도 보여주기(좌표), 지도 보여주기(쿼리), 사용자 위치 공유 \n + calendarAction : 캘린더 등록 \n + composeAction : 지정 대화방에 메시지 작성 \n + dialerAction : 전화걸기 \n + reply : 챗봇연결, 자동응답메시지 연결(다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.)\n\n**clipboardAction, localBrowserAction 은 2026.04.21 부터 더 이상 지원하지 않습니다.** \n","type":"array","items":{"$ref":"#/components/schemas/AutoReplyMsgActions"}}}},"AutoReplyMsgActions":{"oneOf":[{"$ref":"#/components/schemas/ARMaction"},{"$ref":"#/components/schemas/CustomReply"}]},"ARMaction":{"description":"자동응답메시지용 Action","type":"object","properties":{"action":{"type":"object","oneOf":[{"$ref":"#/components/schemas/urlAction"},{"$ref":"#/components/schemas/dialerAction"},{"$ref":"#/components/schemas/mapAction"},{"$ref":"#/components/schemas/calendarAction"},{"$ref":"#/components/schemas/composeAction"}]}},"required":["action"]},"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"]},"mapAction":{"description":"Suggested actions for interacting with a location on a map.","properties":{"mapAction":{"type":"object","oneOf":[{"properties":{"showLocation":{"description":"Shows a given location on a map.","type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"label":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"}},"required":["latitude","longitude"]},"fallbackUrl":{"type":"string","format":"uri"}},"required":["location"]}},"required":["showLocation"]},{"properties":{"requestLocationPush":{"description":"One-time request to send a geo location push from UE to\nchatbot","type":"object","properties":{"currentLocation":{"description":"set true to send current location without location\nselection","type":"boolean"}}}},"required":["requestLocationPush"]}]}},"required":["mapAction"]},"calendarAction":{"description":"Suggested actions for interacting with a calendar event.","properties":{"calendarAction":{"type":"object","oneOf":[{"properties":{"createCalendarEvent":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"title":{"type":"string","minLength":1,"maxLength":100,"description":"maxLength: 100, minLength: 1\n"},"description":{"type":"string","minLength":1,"maxLength":500,"description":"maxLength: 500, minLength: 1\n"},"fallbackUrl":{"type":"string","format":"uri"}},"required":["startTime","endTime","title"]}},"required":["createCalendarEvent"]}]}},"required":["calendarAction"]},"composeAction":{"description":"Suggested actions for composing draft messages.","properties":{"composeAction":{"type":"object","oneOf":[{"properties":{"composeTextMessage":{"description":"Compose a draft text message.","type":"object","properties":{"phoneNumber":{"type":"string"},"text":{"type":"string","maxLength":100,"description":"maxLength: 100\n"}},"required":["phoneNumber","text"]}},"required":["composeTextMessage"]},{"properties":{"composeRecordingMessage":{"description":"Compose a draft message with a media recording.","type":"object","properties":{"phoneNumber":{"type":"string"},"type":{"type":"string","enum":["AUDIO","VIDEO"]}}}},"required":["composeRecordingMessage"]}]}},"required":["composeAction"]},"CustomReply":{"description":"자동응답메시지 reply 지정 필드 추가","type":"object","properties":{"reply":{"type":"object","properties":{"autoReplyMsgId":{"type":"string","maxLength":40,"description":"maxLength: 40 - 자동응답메시지ID 입니다.\n"},"displayText":{"type":"string","minLength":1,"maxLength":25,"description":"maxLength: 25, minLength: 1 - 버튼명(표시문자열)으로 표시되는 항목입니다.\n"},"postback":{"description":"등록 시 자동 설정\n","type":"object","properties":{"data":{"type":"string","maxLength":2048,"description":"maxLength: 2048\n"}},"required":["data"]}},"required":["autoReplyMsgId"]}},"required":["reply"]}}},"paths":{"/brand/{brandId}/autoreplymsg":{"post":{"summary":"브랜드에 자동응답메시지를 등록합니다.\n","description":"브랜드에 자동응답메시지를 등록합니다. \n\n + **계정 권한: 마스터, 매니저, 대행사** \n + **브랜드 권한: 브랜드 대표운영자, 운영자** \n\n제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다. \n**2026.4.21 부터 모든 자동응답메시지는 통합RCS 규격으로만 사용이 가능합니다.** \n + 말풍선: TMCSA00001\n + (이미지가 없는) 카드: RPCSAXX001 \n + (세로형 Tall 이미지) 카드: RPCSMTX001\n + (세로형 Medium 이미지) 카드: RPCSMMX001 \n + 슬라이드형 미제공 \n \n자동응답메시지에 등록 가능한 액션은 다음과 같습니다. \n + 전화걸기\n + 브랜드 소식 연결\n + URL연결 \n + 다른 대화방연결\n + 캘린더 등록\n + 지도 보여주기(좌표)\n + 지도 보여주기(쿼리)\n + 사용자 위치 공유\n + 자동응답메시지 연결\n + 챗봇연결\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"description":"자동응답메시지 등록 정보를 전송합니다.\n","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegAutoReplyMsgInfo"}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```
## Response
{% tabs %}
{% tab title="말풍선" %}
```
{
"autoReplyMsgName": "복권기금 안내",
"messagebaseId": "SCS00000",
"copyAllowed": true,
"body": {
"description": "이 복권은 복권 및 복권기금법 제4조에 의거 발행되며 조성된 자금은 동법 제23조에 따라 소외계층 지원사업등에 사용됩니다."
}
}
```
{% endtab %}
{% tab title="카드" %}
```
{
"autoReplyMsgName": "카드",
"messagebaseId": "SCwThM00",
"copyAllowed": true,
"body": {
"title": "카드제목",
"description": "카드내용",
"media": "BR.61hBmMP164-ARME1M6dN9c3l"
},
"buttons": [
{
"suggestions": [
{
"action": {
"displayText": "RCS비즈센터",
"urlAction": {
"openUrl": {
"url": "https://www-qa.rcsbizcenter.com"
}
}
}
}
]
}
],
"chipList": [
{
"action": {
"dialerAction": {
"dialPhoneNumber": {
"phoneNumber": "07082245288"
}
},
"displayText": "고객센터"
}
}
]
}
```
{% endtab %}
{% tab title="슬라이드" %}
```
{
"autoReplyMsgName": "슬라이드",
"messagebaseId": "CCwMhM0200",
"copyAllowed": true,
"body": {
"title1": "슬라이드1",
"description1": "슬라이드1",
"media1": "BR.61hBmMP164-ARM6tE1T7nzwf",
"title2": "슬라이드2",
"description2": "슬라이드2",
"media2": "BR.61hBmMP164-ARMsYgo2O538B"
},
"buttons": [
{
"suggestions": [
{
"action": {
"dialerAction": {
"dialPhoneNumber": {
"phoneNumber": "119"
}
},
"displayText": "긴급연락119"
}
}
]
},
{
"suggestions": [
{
"action": {
"displayText": "유튜브연결",
"urlAction": {
"openUrl": {
"url": "https://utube.com"
}
}
}
}
]
}
]
}
```
{% endtab %}
{% endtabs %}
## Response