템플릿 추가
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
| 이름 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
channelId | String | - | 카카오톡 채널 고유 아이디. 채널에 템플릿을 등록하고 싶을 경우 필수입니다. |
channelGroupId | String | - | 카카오톡 채널 템플릿 그룹 고유 아이디. 그룹에 템플릿을 등록하고 싶을 경우 필수입니다. |
name | String | O | 템플릿 이름. 중복 가능합니다. |
content | String | O | 템플릿 내용. 변수 포함 가능합니다. 변수 치환 후 1000자를 넘을 수 없습니다. |
categoryCode | String | O | 템플릿 카테고리. 템플릿 카테고리 목록 조회 API |
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 | - | 알림톡에 사용되는 이미지 고유 아이디. 이미지 타입이 `ATA`일 경우에만 사용 가능합니다. 이미지 관리 페이지 (로그인 필요) 이미지 관리 API |