---
title: "와이드형 브랜드 메시지 템플릿 등록"
method: POST
path: "/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/wide"
tags: ["Kakao"]
---

# 와이드형 브랜드 메시지 템플릿 등록

`POST /v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/wide`

와이드형 브랜드 메시지 템플릿을 등록합니다. 800x600 이미지와 짧은 문구, 버튼 구성을 저장하여 주요 프로모션을 돋보이게 합니다.

## Path parameters

- `sendProfileId` string, required

## Request body

- object — 와이드형 브랜드 메시지 템플릿 등록 본문입니다. 와이드 이미지 URL, 버튼, 대체문자 설정을 포함합니다.
  - `templateName` string, required — 템플릿의 이름입니다. 최대 50자로 관리용으로 활용합니다.
  - `content` string, required — 메시지 본문입니다. 최대 76자까지 작성할 수 있습니다. 와이드 이미지가 주요 콘텐츠이므로 매우 간결한 문구 사용 **변수 사용**: #{변수명} 형식 지원
  - `imageUrl` string, uri, required — 권장 크기가 800x190px이고 최대 용량이 500KB인 와이드 이미지 URL입니다.
  - `imageName` string — 접근성을 위한 이미지 대체 텍스트입니다.
  - `imageLink` string, uri — 이미지를 클릭했을 때 이동할 URL입니다.
  - `buttons` object[] — 와이드형 조건에 따라 최대 2개까지 등록하는 버튼 목록입니다.
    - `name` string, required — 버튼의 이름입니다.
    - `linkType` 'WL' | 'AL' | 'DS' | 'BK' | 'MD' | 'BT' | 'BC' | 'AC', required — 버튼 링크 타입입니다. - WL: 웹링크 - 외부 웹페이지로 이동 - AL: 앱링크 - 모바일 앱으로 이동 (딥링크) - DS: 배송조회 - 택배 배송 조회 페이지로 이동 - BK: 봇키워드 - 봇에게 특정 키워드 전송 - MD: 메시지전달 - 버튼 텍스트와 메시지 본문을 함께 전송 - BT: 봇전환 - 상담봇으로 전환 - BC: 상담톡전환 - 상담사와 1:1 채팅으로 전환 - AC: 채널추가 - 카카오톡 채널 친구 추가
    - `linkM` string — 모바일 환경에서 이동할 URL입니다.
    - `linkP` string — PC 환경에서 이동할 URL입니다.
    - `linkI` string — iOS 앱에서 사용할 스킴 URL입니다.
    - `linkA` string — Android 앱에서 사용할 스킴 URL입니다.
  - `coupon` object — 선택적으로 제공할 쿠폰 정보입니다.
    - `title` string, required — 쿠폰 제목입니다. 변수 사용 시 고정 변수명 사용: - #{할인금액}원 할인 쿠폰 (#{할인금액} 범위: 1 ~ 99,999,999) - #{할인율}% 할인 쿠폰 (#{할인율} 범위: 1 ~ 100) - 배송비 할인 쿠폰 - #{상품명} 무료 쿠폰 (#{상품명} 최대 7자) - #{상품명} UP 쿠폰 (#{상품명} 최대 7자) 고정 값 사용 시 변수 자리에 숫자 입력 (예: "10% 할인 쿠폰")
    - `description` string — 쿠폰을 설명하는 문장입니다.
    - `linkM` string — 모바일에서 쿠폰 사용 페이지로 이동할 URL입니다.
    - `linkP` string — PC에서 쿠폰 사용 페이지로 이동할 URL입니다.
    - `linkI` string — iOS 앱에서 쿠폰 사용 페이지로 이동할 딥링크입니다.
    - `linkA` string — Android 앱에서 쿠폰 사용 페이지로 이동할 딥링크입니다.
  - `fallback` object — 선택적으로 사용할 대체문자 설정입니다.
    - `senderNumber` string, required — 발신자 번호입니다.
    - `type` 'SMS' | 'LMS' | 'MMS', required — 대체 발송 타입입니다. - SMS: 단문 메시지 (90바이트) - LMS: 장문 메시지 (2000바이트) - MMS: 멀티미디어 메시지 (이미지 포함)
    - `message` string, nullable, required — 메시지 내용입니다.
    - `title` string, nullable — LMS 또는 MMS로 발송할 때 사용하는 메시지 제목입니다.
    - `images` string[], nullable — MMS로 전송할 때 사용할 이미지 URL 목록입니다.
    - `isAd` boolean — 대체문자를 광고로 발송할지 여부입니다.
    - `groupId` string, nullable — 대체 발송이 요청되었을 때 할당되는 그룹 ID입니다.

## Response `200`

등록 처리 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 여부는 본문의 code와 errorCode를 확인하세요.

- object — 등록 처리 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 여부는 본문의 code와 errorCode를 확인하세요.
  - `code` number — 응답 코드
  - `message` string — 응답 메시지
  - `data` object, required — 브랜드 메시지 템플릿을 식별하는 정보를 제공합니다.
    - `templateId` string, required — 템플릿의 ID입니다.
    - `templateCode` string, required — 템플릿의 코드입니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/revisions/525dedc81a05/schema)