본문으로 건너뛰기

템플릿 추가

POST
/kakao/v2/templates

템플릿을 새롭게 등록합니다.

카카오톡 템플릿은 카카오톡에서 검수를 진행하고 있으며 보통 영업일 기준 1~3일 정도 소요됩니다. 카카오톡 템플릿 화이트리스트를 참고하시면 빠르고 확실하게 검수 승인을 받아보실 수 있습니다.

메시지 유형강조 유형에 따라 필수로 입력해야 하는 값들이 있습니다.

메시지 유형

타입이름필수 요구사항설명
BA
기본형
-
일반적인 템플릿으로 따로 추가할 수 있는 사항이 없습니다.
EX
부가정보형
extra 값 필수최대 80자변수 사용 불가URL 포함 가능
부가정보인 extra 값을 추가해야 합니다. 본문과 합쳐 총 1000자를 넘을 수 없습니다.
AD
채널추가형
첫번째 버튼에 무조건 채널추가 버튼 필요고정 문구 사용
채널 추가를 유도할 수 있는 문구와 채널추가 버튼이 추가됩니다.
MI
복합형
EX + AD 조건 모두 충족
부가정보형과 채널추가형의 기능을 모두 가지고 있는 유형입니다.

채널 추가를 유도할 수 있는 문구와 채널추가 버튼이 추가됩니다.
버튼의 경우 첫번째 버튼에 무조건 채널추가 버튼이 있어야 합니다.

채널 추가 문구의 경우 아래 문구로 고정입니다.
채널 추가하고 이 채널의 광고와 마케팅 메시지를 카카오톡으로 받기

강조 유형

타입이름필수 요구사항설명
NONE
선택안함
-
일반적인 템플릿으로 따로 추가할 수 있는 사항이 없습니다.
TEXT
강조표기형
강조표기문구, 강조표기보조문구 필수
강조표기문구와 강조표기보조문구를 필수로 넣어야합니다.
IMAGE
이미지형
이미지 업로드 필수 (타입: ATA, 권장: 800px*400px, 최대: 500KB)
이미지를 추가할 수 있습니다.
ITEM_LIST
아이템 리스트형
이미지/헤더/하이라이트/아이템리스트 중 최소 1개 필수
[이미지], [헤더], [하이라이트], [아이템 리스트] 중 하나를 꼭 입력해야합니다.

강조표기문구

  • 안드로이드: 최대 2줄 23자(24자부터 말줄임 처리)
  • iOS: 최대 2줄 27자(28자부터 말줄임 처리)

강조표기보조문구

  • 안드로이드: 최대 18자(19자부터 말줄임 처리)
  • iOS: 최대 21자(22자부터 말줄임 처리)

IMAGE (이미지형 상세)

항목요구사항설명
이미지 타입
ATA
고정값
권장 크기
800px * 400px
최적 해상도
크기 제한
가로 500px 이상, 비율 2:1~3:4
가로 500px 미만 또는 가로:세로 비율이 2:1 미만 또는 3:4 초과시 업로드 불가
용량 제한
최대 500KB
파일 크기 제한
파일 형식
JPG, PNG
지원 포맷

이미지는 아래 링크에서 업로드 가능합니다.
이미지 관리 페이지 (로그인 필요)
이미지 관리 API


ITEM_LIST (아이템 리스트형)

[이미지], [헤더], [하이라이트], [아이템 리스트] 중 하나를 꼭 입력해아합니다. 각 요소에 대한 자세한 설명은 아래 Body Params 참고 부탁드립니다.

Body Params

NameTypeRequiredDescription
channelId
string
-
카카오톡 채널 고유 아이디. 채널에 템플릿을 등록하고 싶을 경우 필수입니다.
channelGroupId
string
-
카카오톡 채널 템플릿 그룹 고유 아이디. 그룹에 템플릿을 등록하고 싶을 경우 필수입니다.
name
string
O
템플릿 이름. 중복 가능합니다.
content
string
O
템플릿 내용. 변수 포함 가능합니다. 변수 치환 후 1000자를 넘을 수 없습니다.
categoryCode
string
O
buttons
Array<Object>
-
템플릿에 들어가는 버튼 목록. 최대 5개까지 등록 가능합니다. 바로연결이 1개 이상 있을 경우 2개까지만 등록 가능합니다. 메시지 유형이 채널 추가형일 경우 채널추가 버튼이 반드시 있어야 하며 채널추가 버튼은 첫 번째 버튼이어야 합니다.
quickReplies
Array<Object>
-
바로 연결. 최대 10개까지 등록 가능합니다.
messageType
string
-
메시지 유형. 기본값: `BA`

• `BA`: 기본형
• `EX`: 부가정보형
• `AD`: 채널추가형
• `MI`: 복합형
emphasizeType
string
-
강조 유형. 기본값: `NONE`

• `NONE`: 선택안함
• `TEXT`: 강조표기형
• `IMAGE`: 이미지형
• `ITEM_LIST`: 아이템 리스트
header
string
-
알림톡 헤더. 강조 유형이 아이템 리스트일 때만 사용 가능합니다. 변수 포함 가능. 최대 16자
highlight
Object
-
알림톡 하이라이트. 강조 유형이 아이템 리스트일 때만 사용 가능합니다.
item
Object
-
알림톡 아이템. 목록과 요약이 있습니다. 강조 유형이 아이템 리스트일 때만 사용 가능합니다.
extra
string
-
부가정보. 변수 포함 불가능. 최대 500자
emphasizeTitle
string
-
강조 표기 문구. 변수가 들어갈 수 있습니다. 템플릿 강조유형이 강조표기형일 때만 사용할 수 있습니다. 최대 50자
emphasizeSubtitle
string
-
강조 표기 보조 문구. 변수가 들어갈 수 없습니다. 템플릿 강조유형이 강조표기형일 때만 사용할 수 있습니다. 최대 50자
securityFlag
boolean
-
보안 템플릿 여부. `true`일 경우 해당 템플릿을 PC에서는 확인할 수 없습니다. 기본값: `false`
imageId
string
-

Structures

{18 properties
"channelId": "string",
"channelGroupId": "string",
"name": "string",
"content": "string",
"categoryCode": "string",
"buttons":
[1 items...]
{8 properties...}
"buttonType": "string",
"buttonName": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string",
"chatExtra": "string",
"targetOut": "boolean"
}
]
,
"quickReplies": "string",
"messageType": "string",
"emphasizeType": "string",
"header": "string",
"highlight":
{3 properties...}
"title": "string",
"description": "string",
"imageId": "string"
}
,
"item":
{2 properties...}
"list":
[1 items...]
{2 properties...}
"title": "string",
"description": "string"
}
]
,
"summary":
{2 properties...}
"title": "string",
"description": "string"
}
}
,
"extra": "string",
"ad": "string",
"emphasizeTitle": "string",
"emphasizeSubtitle": "string",
"securityFlag": "string",
"imageId": "string"
}