Skip to main content
POST
알림톡은 카카오 승인을 받은 템플릿만 발송할 수 있습니다.

Base URL

Headers

string
required
제공받은 API key

Body (JSON)

number
required
제공받은 알림톡 서비스 번호
string
required
등록된 템플릿 코드 (BizCode)
string
required
그룹코드
string
required
등록된 템플릿 메시지
object[]
required
수신자 배열. 각 항목은 아래 필드로 구성됩니다.
  • key (number): unique key
  • hp (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 대체 발송이 진행됩니다.