메시지 발송
알림톡 발송
등록한 비즈니스 채널에 승인된 템플릿을 통한 알림톡을 전송합니다.
POST
알림톡은 카카오 승인을 받은 템플릿만 발송할 수 있습니다.
Base URL
Headers
string
required
제공받은 API key
Body (JSON)
number
required
제공받은 알림톡 서비스 번호
string
required
등록된 템플릿 코드 (BizCode)
string
required
그룹코드
string
required
등록된 템플릿 메시지
object[]
required
수신자 배열. 각 항목은 아래 필드로 구성됩니다.
key(number): unique keyhp(string): 수신자 핸드폰 번호name(string): 수신자 이름VAR1,VAR2, … (string): 템플릿에서 사용한 가변변수에 대입될 값 (N개)
string
타이틀 템플릿인 경우 필수. 템플릿 등록에 사용한 title
boolean
default:"false"
대체문자 발송 여부
string
대체문자 발송 시 발신번호 (
alter=true 시 필수).
사전에 등록된 발신번호만 사용 가능합니다.예제
응답 필드
참고
numbers배열의 각 항목은 개별 발송 단위입니다. 한 요청으로 다수에게 발송할 수 있습니다.- 템플릿의 가변변수(
#{VAR1},#{이름}등)와numbers[].VARn,numbers[].name필드가 매핑됩니다. - 발송 실패(
KKO_*) 시alter: true로 설정하면 자동으로 SMS 대체 발송이 진행됩니다.