메시지 발송
알림톡 발송
등록한 비즈니스 채널에 승인된 템플릿을 통한 알림톡을 전송합니다.
POST
알림톡은 카카오 승인을 받은 템플릿만 발송할 수 있습니다.
Base URL
Headers
제공받은 API key
Body (JSON)
제공받은 알림톡 서비스 번호
등록된 템플릿 코드 (BizCode)
그룹코드
등록된 템플릿 메시지
수신자 배열. 각 항목은 아래 필드로 구성됩니다.
key(number): unique keyhp(string): 수신자 핸드폰 번호name(string): 수신자 이름VAR1,VAR2, … (string): 템플릿에서 사용한 가변변수에 대입될 값 (N개)
타이틀 템플릿인 경우 필수. 템플릿 등록에 사용한 title
대체문자 발송 여부
대체문자 발송 시 발신번호 (
alter=true 시 필수).
사전에 등록된 발신번호만 사용 가능합니다.예제
응답 필드
| 필드 | 설명 |
|---|---|
version | API 버전 |
status | success / fail |
code | HTTP 상태 코드 |
datetime | 응답 시각 |
value[].uid | 수신자별 발송 식별자. 발송 결과 상세 조회에 사용 |
value[].date | 발송 시각 (epoch ms) |
value[].status | 수신자별 결과 코드. OK / KKO_* / ERR_* (에러코드 참조) |
count | 처리된 건수 |
total | 전체 요청 건수 |
참고
numbers배열의 각 항목은 개별 발송 단위입니다. 한 요청으로 다수에게 발송할 수 있습니다.- 템플릿의 가변변수(
#{VAR1},#{이름}등)와numbers[].VARn,numbers[].name필드가 매핑됩니다. - 발송 실패(
KKO_*) 시alter: true로 설정하면 자동으로 SMS 대체 발송이 진행됩니다.