---
title: "템플릿 수정"
method: POST
path: "/v2/messages/kakao/send-profiles/{sendProfileId}/templates/{templateId}/update"
tags: ["Kakao"]
---

# 템플릿 수정

`POST /v2/messages/kakao/send-profiles/{sendProfileId}/templates/{templateId}/update`

## Request

- Base URL: `https://api.sendon.io`
- URL: `https://api.sendon.io/v2/messages/kakao/send-profiles/{sendProfileId}/templates/{templateId}/update`
- Auth: HTTP basic

등록된 알림톡 템플릿의 내용을 수정합니다. 검수 완료된 템플릿은 수정할 수 없으며, 검수 대기 중이거나 반려된 템플릿만 수정할 수 있습니다.

## Path parameters

- `sendProfileId` string, required
- `templateId` string, required

## Request body

- UpdateTemplateRequestDto
  - `templateName` string: 수정할 템플릿의 이름입니다. 템플릿을 구분하기 위한 이름을 설정할 수 있습니다.
  - `templateContent` string: 수정할 알림톡 템플릿의 본문 내용입니다. **글자수 제약:** - 한/영 구분없이 최대 1,000자까지 입력 가능 - 모든 템플릿 타입에서 본문은 1,000자 제한 **변수 사용:** - 개인화된 텍스트 영역은 #{변수명} 형식으로 작성 가능 **템플릿 타입별 총 길이:** - 기본형(BA): 본문 1,000자 - 부가정보형(EX): 본문 1,000자 + 부가정보 500자 = 총 1,500자 - 채널추가형(AD): 본문 1,000자 + 채널추가 안내 80자 = 총 1,080자 - 복합형(MI): 본문 1,000자 + 부가정보 500자 + 채널추가 안내 80자 = 총 1,580자
  - `templateEmphasizeType` 'NONE' | 'TEXT' | 'IMAGE' | 'ITEM_LIST': 수정할 템플릿의 강조 표시 타입입니다. NONE(강조 없음), TEXT(텍스트 강조), IMAGE(이미지 강조), ITEM_LIST(아이템 리스트 강조) 중 선택합니다.
  - `templateExtra` string: 부가정보는 알림톡 메시지의 본문 하단에 노출되는 보조적인 정보입니다. **사용 목적:** - 고객에게 고정적인 부가 정보에 대한 안내가 지속적으로 필요한 경우 - 이용안내 등 보조적인 정보메시지 안내 **글자수 제약:** - 최대 500자 입력 가능 - 광고성 요소와 동시 사용 시 부가정보 + 광고성 문구 총 500자 제한 - 본문과 합쳐 총 1,000자를 넘을 수 없음 **변수 및 URL:** - 변수 사용 불가능 - URL 포함 가능 **표시 위치:** - 본문과 버튼 사이 Description 영역에 노출 - 본문 대비 사이즈 -1pt, 컬러차 자동 적용
  - `templateTitle` string: 강조표기형 템플릿의 제목입니다. **사용 목적:** - 중요한 정보를 강조하여 사용자의 주목을 끌기 위해 사용 - 본문 상단에 볼드체로 노출되어 시각적 강조 효과 제공 **글자수 제약:** - Android: 최대 23자 (24자부터 말줄임 처리) - iOS: 최대 28자 (29자부터 말줄임 처리) **변수 사용:** - 변수 등록 불가 **사용 조건:** - Subtitle과 함께 등록되어야 함 - 단독 노출 불가
  - `templateSubtitle` string: 강조표기형 템플릿의 부제목입니다. **사용 목적:** - 제목과 함께 사용하여 추가적인 정보를 제공 - 제목보다 더 구체적인 내용을 담아 메시지의 명확성 향상 **글자수 제약:** - Android: 최대 18자 (19자부터 말줄임 처리) - iOS: 최대 21자 (22자부터 말줄임 처리) **변수 사용:** - 변수 등록 불가 **사용 조건:** - Title과 함께 등록되어야 함 - 단독 노출 불가
  - `securityFlag` boolean: 수정할 템플릿의 보안 수준을 나타내는 플래그입니다. true인 경우 높은 보안이 적용된 템플릿임을 의미합니다.
  - `templateImageName` string: 수정할 템플릿에 포함된 이미지의 파일명입니다. 이미지 관리를 위해 사용됩니다.
  - `templateImageUrl` string: 수정할 템플릿에 포함된 이미지의 URL입니다. 업로드된 이미지에 접근하기 위한 웹 주소입니다.
  - `buttons` union[]: 수정할 템플릿에 포함될 버튼들의 목록입니다. 사용자 액션을 유도하는 다양한 버튼을 설정할 수 있습니다.
    - union
      - TemplateWebLinkButtonDto
        - `name` string, required: 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다.
        - `ordering` number: 템플릿 내에서 버튼이 표시될 순서입니다. 숫자가 작을수록 먼저 표시됩니다.
        - `type` 'WL', required
        - `urlMobile` string: 모바일 환경에서 웹링크 버튼 클릭 시 이동할 URL입니다. 모바일에 최적화된 페이지 링크를 설정합니다.
        - `urlPc` string: PC 환경에서 웹링크 버튼 클릭 시 이동할 URL입니다. 데스크톱 브라우저에서 열릴 링크를 설정합니다.
      - TemplateAppLinkButtonDto
        - `name` string, required: 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다.
        - `ordering` number: 템플릿 내에서 버튼이 표시될 순서입니다. 숫자가 작을수록 먼저 표시됩니다.
        - `type` 'AL', required
        - `urlMobile` string: 앱링크 버튼에서 모바일 환경 클릭 시 이동할 URL입니다. 앱이 미설치된 경우 대체 웹페이지로 이동합니다.
        - `urlPc` string: 앱링크 버튼에서 PC 환경 클릭 시 이동할 URL입니다. 데스크톱에서의 대체 웹페이지를 설정합니다.
        - `schemeAndroid` string: Android 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다.
        - `schemeIos` string: iOS 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다.
      - TemplateBasicButtonDto
        - `name` string, required: 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다.
        - `ordering` number: 템플릿 내에서 버튼이 표시될 순서입니다. 숫자가 작을수록 먼저 표시됩니다.
        - `type` 'BK' | 'MD' | 'DS' | 'AC', required

## Response `200`

템플릿 수정 요청의 처리 결과입니다. 성공 시 템플릿이 수정되며, 재검수가 필요할 수 있습니다.

- KakaoActionResponseDto
  - `code` number, required: HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required: API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공"이 반환됩니다.

## Changes

- **2026-11-03** `71dc377792d9`: 1 breaking, 6 info
  - request body became required
  - api operation id `updateTemplate` removed and replaced with `TemplateController_updateTemplate`
  - the endpoint scheme security `basic` was added to the API
  - the response property `code` became required for the status `200`
  - …3 more

[Operation history](https://skmtc.dev/sendon/apis/sendon-api/changes/v2/messages/kakao/send-profiles/:sendProfileId/templates/:templateId/update/post.md)

---

[API](https://skmtc.dev/sendon/apis/sendon-api.md) - [All operations](https://skmtc.dev/sendon/apis/sendon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sendon/apis/sendon-api/revisions/71dc377792d9?raw)