자동응답 메시지 수정

Request

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

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

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

자동응답메시지에 등록 가능한 액션이 추가 되었습니다.

• 전화걸기
• 웹사이트(내부브라우져)
• 웹사이트(외부브라우져)
• 대화방연결(메시지작성)
• 캘린더(일정)
• 지도(좌표)
• 지도(키워드)
• 지도(현재위치)
• <신규>자동응답메시지연결
• <신규>챗봇연결

제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용하며 다음과 같이 처리 됩니다.

• 기본 말풍선(SCS00000), 텍스트 카드(SCL00000)는 기본 말풍선(SCS00000)으로 처리
• 세로형_Meduim(SCwThM00), 세로형_Tall(SCwThT00)은 세로형_Meduim(SCwThM00)으로 처리
• 슬라이드형_Medium, 슬라이드형_Small은 슬라이드형_Medium으로 처리
  • 슬라이드형 Medium ID: CCwMhM0200 ~ CCwMhM0600

따라서 지정된 messagebaseId에만 존재하는 필드가 전환되는 messagebaseId에 존재하지 않는 경우 무시됩니다.

예를 들어, 텍스트 카드로 등록 시 title을 입력하더라도 기본 말풍선은 title을 지원하지 않으므로 title이 적용되지 않습니다.

put

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

Authorizations

Path parameters

brandIdstring · max: 13required

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

autoReplyMsgIdstringrequired

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

Header parameters

X-RCS-Brandkeystring · max: 18

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

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

Body

autoReplyMsgNamestring · max: 100required

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

messagebaseIdstring · max: 40required

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

제공되는 productcode = chat 해당 messagebaseId를 지정하여 사용 가능하나 다음과 같이 처리됩니다.

• 기본 말풍선(SCS00000), 텍스트 카드(SCL00000)는 기본 말풍선(SCS00000)으로 처리
• 세로형_Meduim(SCwThM00), 세로형_Tall(SCwThT00)은 세로형_Meduim(SCwThM00)으로 처리
• 슬라이드형_Medium, 슬라이드형_Small은 슬라이드형_Medium으로 처리
  • 슬라이드형 Medium ID: CCwMhM0200 ~ CCwMhM0600

지정된 ID에만 존재하는 필드가 전환되는 ID에 존재하지 않는 경우 무시됩니다.

예를 들어, 텍스트 카드로 등록시 title을 입력하더라도 기본 말풍선은 title을 지원하지 않으므로 title이 적용되지 않습니다.

copyAllowedboolean · default: true

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

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

bodyobjectrequired

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

buttonsobject[]

자동응답메시지에 버튼을 등록합니다.

지원하는 action 유형은 다음과 같습니다.

• urlAction : 기본 브라우저에서 웹페이지 링크
• localBrowserAction : 채팅+ 내부 브라우저에서 웹페이지 표시
• mapAction : 지도 상의 특정 위치 표시 또는 현재 위치 공유
• calendarAction : 캘린더에 일정 공유
• clipboardAction : 클립보드로 복사
• composeAction : 지정 대화방에 메시지 작성
• dialerAction : 전화걸기
• reply : 다른 자동응답메시지 연결, 챗봇응답

다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.

chipListone of[]

자동응답메시지에 칩리스트를 지정합니다. 지원하는 action 유형은 다음과 같습니다.

• urlAction : 기본 브라우저에서 웹페이지 링크
• localBrowserAction : 채팅+ 내부 브라우저에서 웹페이지 표시
• mapAction : 지도 상의 특정 위치 표시 또는 현재 위치 공유
• calendarAction : 캘린더에 일정 공유
• clipboardAction : 클립보드로 복사
• composeAction : 지정 대화방에 메시지 작성
• dialerAction : 전화걸기
• reply : 다른 자동응답메시지 연결, 챗봇응답

다른 자동응답메시지 연결 시에는 reply JSON object 내에 autoReplyMsgId 필드에 자동응답메시지ID를 지정하며, postback.data는 자동할당 됩니다.

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api-qa.rcsbizcenter.com/api/1.1/brand/{brandId}/autoreplymsg/{autoReplyMsgId}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "autoReplyMsgName": "text",
    "messagebaseId": "text",
    "copyAllowed": true,
    "body": {},
    "buttons": [
      {
        "suggestions": [
          {
            "action": {
              "displayText": "text",
              "postback": {
                "data": "text"
              },
              "urlAction": {
                "openUrl": {
                  "url": "https://example.com"
                }
              }
            }
          }
        ]
      }
    ],
    "chipList": [
      {
        "action": {
          "displayText": "text",
          "postback": {
            "data": "text"
          },
          "urlAction": {
            "openUrl": {
              "url": "https://example.com"
            }
          }
        }
      }
    ]
  }'

❖ 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>		O		자동응답메시지 ID
code	string	5	O	20000000
status	integer	3	O	200
desc	string		O

result - array<object>

필드명	타입	길이	필수여부	기본값	설명
brandId	string	13	O		자동응메시지 상세 정보입니다.
autoReplyMsgId	string	40	O
autoReplyMsgName	string	100	O
messagebaseId	string	40	O
approvalResult	string				자동응답메시지 등록 상태입니다. 자동응답메시지는 운영자 검수 없이 자동 등록됩니다. 등록완료 : 이통3사에 자동응답메시지가 정상 등록된 상태입니다. 저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다. 처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.
registerDate	string				등록일시
updateDate	string				수정일시
registerId	string	20			등록 계정 ID
updateId	string	20			수정 계정 ID
copyAllowed	boolean			true
body	object		O
buttons	array<object>
chipList	array<object>

❖ response body sample

200-말풍선

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

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
}

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
}
```

400

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

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

401

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

403

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

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