자동응답 메시지 수정

Request

자동응답메시지의 정보를 업데이트합니다.

put

/brand/{brandId}/autoreplymsg/{autoReplyMsgId}

자동응답메시지의 정보를 업데이트합니다.

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

제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다. 2026.4.21 부터 모든 자동응답메시지는 통합RCS 규격으로만 사용이 가능합니다.

말풍선: TMCSA00001
(이미지가 없는) 카드: RPCSAXX001
(세로형 Tall 이미지) 카드: RPCSMTX001
(세로형 Medium 이미지) 카드: RPCSMMX001
슬라이드형 미제공

자동응답메시지에 등록 가능한 액션은 다음과 같습니다.

전화걸기
브랜드 소식 연결
URL연결
다른 대화방연결
캘린더 등록
지도 보여주기(좌표)
지도 보여주기(쿼리)
사용자 위치 공유
자동응답메시지 연결
챗봇연결

Authorizations

AuthorizationstringRequired

인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.

Path parameters

brandIdstring · max: 13Required

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

autoReplyMsgIdstringRequired

브랜드 내 자동응답메시지 정보 접근시 사용되는 자동응답메시지ID Path Parameter 입니다.

Header parameters

X-RCS-Brandkeystring · max: 18Optional

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

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

Body

자동응답메시지 등록/수정 시 필요한 정보입니다.

autoReplyMsgNamestring · max: 100Required

maxLength: 100 - 자동응답메시지 명을 지정합니다.

messagebaseIdstring · max: 40Required

maxLength: 40 - 메시지 상품코드 chat에 속하는 messagebase ID를 지정합니다.

copyAllowedbooleanOptional

단말에서 메시지 복사 가능 여부를 지정합니다.

true : 복사 가능
false : 복사 불가

Default: true

bodyobjectRequired

이통 발송규격 중 /message API의 body object와 동일한 방식으로 값을 지정합니다.

Responses

200

페이지 내 Response 섹션 참조

No content

put/brand/{brandId}/autoreplymsg/{autoReplyMsgId}

PUT /api/1.1/brand/{brandId}/autoreplymsg/{autoReplyMsgId} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 256

{
  "autoReplyMsgName": "text",
  "messagebaseId": "text",
  "copyAllowed": true,
  "body": {},
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "urlAction": {
              "openUrl": {
                "url": "https://example.com"
              }
            }
          }
        }
      ]
    }
  ],
  "chipList": [
    {
      "action": {
        "urlAction": {
          "openUrl": {
            "url": "https://example.com"
          }
        }
      }
    }
  ]
}

200

페이지 내 Response 섹션 참조

No content

❖ request body sample

{
    "autoReplyMsgName": "복권기금 안내",
    "messagebaseId": "SCS00000",
    "copyAllowed": true,
    "body": {
        "description": "이 복권은 복권 및 복권기금법 제4조에 의거 발행되며 조성된 자금은 동법 제23조에 따라 소외계층 지원사업등에 사용됩니다."
    }
}

{
    "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": "고객센터"
            }
        }
    ]
}

{
    "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"
                            }
                        }
                    }
                }
            ]
        }
    ]
}

Response

필드명

타입

길이

필수여부

기본값

설명

result

array<object>

자동응답메시지 ID

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

자동응메시지 상세 정보입니다.

autoReplyMsgId

string

autoReplyMsgName

string

100

messagebaseId

string

approvalResult

string

자동응답메시지 등록 상태입니다. 자동응답메시지는 운영자 검수 없이 자동 등록됩니다.

등록완료 : 이통3사에 자동응답메시지가 정상 등록된 상태입니다.
저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.
처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.

registerDate

string

등록일시

updateDate

string

수정일시

registerId

string

등록 계정 ID

updateId

string

수정 계정 ID

copyAllowed

boolean

true

body

object

buttons

array<object>

chipList

array<object>

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.61hBmMP164",
            "autoReplyMsgId": "ARMKLOTfB1h1Fne",
            "autoReplyMsgName": "복권기금 안내",
            "messagebaseId": "SCS00000",
            "approvalResult": "처리중",
            "registerDate": "2024-06-28T11:20:25.000+09",
            "updateDate": "2024-06-28T11:20:25.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "status": "APRV_MOD",
            "aprvRet": "INSPECTED",
            "autoReplyMsgType": "SCL",
            "autoReplyMsgTypeNm": "말풍선",
            "cardCount": 0,
            "copyAllowed": true,
            "body": {
                "description": "이 복권은 복권 및 복권기금법 제4조에 의거 발행되며 조성된 자금은 동법 제23조에 따라 소외계층 지원사업등에 사용됩니다."
            }
        }
    ],
    "status": 200
}

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.61hBmMP164",
            "autoReplyMsgId": "ARMKLOTfB1h1Fne",
            "autoReplyMsgName": "카드1장",
            "messagebaseId": "SCwThM00",
            "approvalResult": "처리중",
            "registerDate": "2024-06-28T11:38:37.000+09",
            "updateDate": "2024-06-28T11:38:37.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "buttons": [
                {
                    "suggestions": [
                        {
                            "action": {
                                "displayText": "RCS비즈센터",
                                "urlAction": {
                                    "openUrl": {
                                        "url": "https://www-qa.rcsbizcenter.com"
                                    }
                                },
                                "postback": {
                                    "data": "postbackId=PClYUNGU5mE4dn2;;"
                                }
                            }
                        }
                    ]
                }
            ],
            "chipList": [
                {
                    "action": {
                        "dialerAction": {
                            "dialPhoneNumber": {
                                "phoneNumber": "07082245288"
                            }
                        },
                        "displayText": "고객센터",
                        "postback": {
                            "data": "postbackId=PPagxG7V5cHdlsm;;"
                        }
                    }
                }
            ],
            "status": "APRV_MOD",
            "aprvRet": "INSPECTED",
            "autoReplyMsgType": "CARD",
            "autoReplyMsgTypeNm": "카드",
            "cardCount": 0,
            "copyAllowed": true,
            "body": {
                "title": "카드1장제목",
                "description": "카드1장내용",
                "media": "BR.61hBmMP164-ARME1M6dN9c3l"
            }
        }
    ],
    "status": 200
}

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.61hBmMP164",
            "autoReplyMsgId": "ARMKLOTfB1h1Fne",
            "autoReplyMsgName": "슬라이드",
            "messagebaseId": "CCwMhM0200",
            "approvalResult": "처리중",
            "registerDate": "2024-06-28T11:39:21.000+09",
            "updateDate": "2024-06-28T11:39:21.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75",
            "buttons": [
                {
                    "suggestions": [
                        {
                            "action": {
                                "dialerAction": {
                                    "dialPhoneNumber": {
                                        "phoneNumber": "119"
                                    }
                                },
                                "displayText": "긴급연락119",
                                "postback": {
                                    "data": "postbackId=Prr7V706hnDO694;;"
                                }
                            }
                        }
                    ]
                },
                {
                    "suggestions": [
                        {
                            "action": {
                                "displayText": "유튜브연결",
                                "urlAction": {
                                    "openUrl": {
                                        "url": "https://utube.com"
                                    }
                                },
                                "postback": {
                                    "data": "postbackId=P6vRpgNjRhENE9O;;"
                                }
                            }
                        }
                    ]
                }
            ],
            "status": "APRV_MOD",
            "aprvRet": "INSPECTED",
            "autoReplyMsgType": "SLIDER",
            "autoReplyMsgTypeNm": "슬라이드",
            "cardCount": 0,
            "copyAllowed": true,
            "body": {
                "title1": "슬라이드1",
                "description1": "슬라이드1",
                "media1": "BR.61hBmMP164-ARM6tE1T7nzwf",
                "title2": "슬라이드2",
                "description2": "슬라이드2",
                "media2": "BR.61hBmMP164-ARMsYgo2O538B"
            }
        }
    ],
    "status": 200
}
```

{
    "error": {
        "code": "64336",
        "message": "required value: [autoReplyMsgName]"
    },
    "status": 400
}

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

error code는 RCS Biz Center - Response body error code 참조

Previous자동응답 메시지 등록 Next자동응답 메시지 삭제

Last updated 2 months ago