RCS Biz Center

템플릿 수정_V2

Request

이미 등록된 템플릿의 내용을 수정합니다.

put

이미 등록된 템플릿의 내용을 수정합니다. messagebase의 ID를 유지하면서 내용을 변경하고자 하는 경우 사용이 가능합니다.

수정 등록된 템플릿은 RCS Biz Center 운영자의 승인이 필요합니다.

  • 계정 권한: 마스터, 매니저, 대행사

  • 브랜드 권한: 브랜드 대표운영자, 운영자

  • 지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿

Authorizations
Path parameters
brandIdstring · max: 13Required

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

messagebaseIdstringRequired

messagebase ID Path parameter 입니다.

Header parameters
X-RCS-Brandkeystring · max: 18Optional

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

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

Body

템플릿 수정 시 사용되는 Object 입니다.

brandIdstring · max: 13Required

maxLength: 13 - 브랜드ID

messagebaseformIdstring · max: 10Optional

maxLength: 10 - 템플릿 양식 ID

tmpltNamestring · max: 40Required

maxLength: 40 - 템플릿명

agencyIdstring · max: 20Optional

maxLength: 20 - 대행사ID

put
PUT /api/1.1/brand/{brandId}/v2/messagebase/{messagebaseId} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 399

{
  "brandId": "text",
  "messagebaseformId": "text",
  "tmpltName": "text",
  "agencyId": "text",
  "body": [
    {
      "param": "text",
      "value": "text",
      "setViewAll": true,
      "viewAll": 150,
      "decoration": {
        "textSize": "text",
        "textAlignment": "textStart",
        "textStyle": "bold",
        "textColor": "text"
      }
    }
  ],
  "buttons": [
    {
      "suggestions": [
        {
          "action": {
            "displayText": "text",
            "postback": {
              "data": "text"
            },
            "urlAction": {
              "openUrl": {
                "url": "https://example.com"
              }
            }
          }
        }
      ]
    }
  ]
}

❖ request body sample

{
  "brandId": "BR.u720xwadx0",
  "messagebaseformId": "TATA001C",
  "tmpltName": "타이틀자유형-스타일",
  "agencyId": "",
  "body": [
    {
      "param": "title1",
      "value": "제목1",
      "decoration": {
        "textStyle": "bold",
        "textSize": "18dp",
        "textAlignment": "textStart",
        "textColor": "#232329"
      }
    }, 
    {
        "param": "title2",
        "value": "{{2}}",
        "decoration": {
            "textStyle": "bold",
            "textSize": "18dp",
            "textAlignment": "textStart",
            "textColor": "#232329"
        }
    },
    {
      "param": "cell1",
      "value": "{{1}}"
    },
    {
      "param": "cell2",
      "value": "{{2}}"
    },
    {
      "param": "cell3",
      "value": "{{3}}"
    },
    {
      "param": "cell4",
      "value": "{{4}}"
    },      
    {
      "lineIndex": 2
    }
  ],
  "buttons": [
    {
      "click": [
        {
          "action": {
            "dialerAction": {
              "dialPhoneNumber": {
                "phoneNumber": "1522{{지점번호}}"
              }
            },
            "displayText": "고객센터"
          }
        },
        {}
      ]
    }
  ]  
}

Response

필드명
타입
길이
필수여부
기본값
설명

result

array<object>

O

등록된 템플릿ID(= messagebaseId)

code

string

5

O

20000000

status

integer

3

O

200

desc

string

O

result - array<object>

필드명
타입
길이
필수여부
기본값
설명

messagebaseId

string

O

등록된 템플릿ID(= messagebaseId)

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "messagebaseId": "UBR.u720xwadx0-test202406182"
        }
    ],
    "status": 200
}

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

Previous템플릿 등록_V2Next템플릿 이미지 상세 조회_V2

Last updated

Was this helpful?