API STORE

| 회원가입

카카오 알림톡 API 템플릿 등록 가이드

카카오 알림톡은 템플릿을 등록하여 카카오측으로 부터 승인을 받은 템플릿 양식대로만 전송을 할 수 있는 서비스입니다.

카카오 알림톡 API 충전 후 발신프로필키를 발급받은 후 템플릿을 등록하세요.
템플릿 등록에 필요한 아래의 사항들을 먼저 꼼꼼히 확인하신 후 등록하시면 보다 빠르게 승인이 진행될 수 있습니다.

고객님이 등록한 템플릿에 대한 승인은 카카오측에서 직접하는 것이므로 API스토어와 직접적인 연관이 없으며 구체적인 안내가 어렵습니다.
반려된 경우 반려사유를 확인하여 아래 가이드를 다시 점검하여 등록 및 신청하시기 바랍니다.

1. 템플릿코드

  1. 1) 템플릿코드는 필수 입력값이며 고객사가 관리하는 대상임. (고객사가 템플릿별로 고유값을 정하여 입력해야함)
  2. 2) 영어, 숫자 3자~7자 이하로 입력.
  3. 3) 하나의 발신프로필에 동일한 템플릿코드를 중복하여 등록할 수 없음.

템플릿 코드 등록 화면 (입력 예시)

템플릿코드 등록

2. 템플릿명

  1. 1) 템플릿 구분용으로, 발송에 영향을 미치지 않으며, 메시지에 포함되지 않음.
    템플릿 관리를 위한 관리용으로 관리자가 자유롭게 지정함.(최대 200자)
  2. 2) 하나의 계정에 중복된 템플릿명을 등록할 수 없음.

템플릿명 등록 화면 (입력 예시)

템플릿명 등록

3. 템플릿내용(발송할 메시지 내용)

  1. 1) 한/영 구분없이 URL 포함 1,000자 까지 입력 가능함.
  2. 2) 변수에 들어갈 내용의 최대 길이를 감안하여 작성해야 함.
  3. 3) 변수를 #{변수} 형태로 입력함. (내용입력 예시: #{홍길동}님의 택배가 금일 #{09:50}에 배달될 예정입니다.)
  4. 4) 템플릿내용 예시는 활용사례 부분을 참고 바랍니다.

4. 버튼타입 등록

  1. 1) 버튼타입은 다섯가지 중에서 선택 가능함. (배송조회, 웹링크, 앱링크, 봇키워드, 메시지전달)
  2. 2) 버튼명은 최대 14자 까지 입력할 수 있음
  3. 3) 배송조회는 버튼명만 입력하면 됨. (버튼링크는 카카오에서 서비스하는 택배조회 페이지로 이동함.)
    • - 조회 가능한 택배사
      KG로지스 / 우체국택배 / 로젠택배 / CJ대한통운 / 일양로지스 / 현대택배 / GTX로지스 / FedEx / 한진택배 / 경동택배 / 합동택배 / 롯데택배
    • - 메시지 내용에서 택배사명 + 송장번호가 자동 파싱되어 해당 택배사 검색을 가능하게 함.
    • - 배송조회는 꼭 버튼명을 ‘배송조회’ 로 입력 해야 함.
  4. 4) 웹링크는 버튼명을 필수로 입력함.
    버튼링크는 모바일링크, PC링크 중 선택 입력 할 수 있으나 반드시 1개는 입력하여야 함.
  5. 5) 앱링크는 버튼명과 버튼링크 (android/iOS)를 모두 필수로 입력하여야 함. (링크 2개 필수)
  6. 6) 봇키워드는 카카오에서 서비스하는 내용이며, 봇 또는 상담원에게 유저의 액션을 전달할 때 사용할 수 있음. (상담톡연계 버튼)
  7. 7) 메시지전달은 카카오에서 서비스하는 내용이며, 봇 또는 상담원에게 유저가 수신한 알림톡과 함께 유저의 액션을 전달할 때 사용할 수 있음.
    (상담톡연계 버튼)

배송조회 버튼타입 등록 (입력 예시)

배송조회 버튼은 ‘버튼이름’이 ‘배송조회’로 기본적으로 적용되어 있음. 수정 및 변경시 발송되지 않으니 주의하세요!

배송조회 버튼타입 등록

웹링크 버튼타입 (입력 예시)

웹링크의 버튼링크 주소는 Mobile, pc 두 개 중 최소 1개 이상 입력필요 함.

웹링크 버튼타입

앱링크 버튼타입 (입력 예시)

앱링크의 버튼링크 주소는 안드로이드, iOS 모두 필수적으로 입력해야 함.

앱링크 버튼타입

봇키워드 버튼타입 등록 (입력 예시)

‘봇키워드’ 는 봇키워드 버튼이름이 그대로 상담원 또는 상대방에게 전달되는 기능임. 알림톡 메시진 내용이 함께 전달되지는 않음. (상담톡 연계버튼)

봇키워드 버튼타입 등록
(봇키워드 버튼 화면 적용 예시)
봇키워드 버튼 화면 적용 예시

메시지전달 버튼타입 등록 (입력 예시)

‘메시지전달’은 버튼이름과 함께 전달받은 알림톡 메시지 내용이 상담원 또는 상대방에게 전달되는 기능임. 사용자에게 알림톡 메시지 내용을 되묻는 번거로움을 줄일 수 있음. (상담톡 연계버튼)

메시지전달 버튼타입 등록
(메시지전달 버튼 화면 적용 예시)
메시지전달 버튼 화면 적용 예시

5. 템플릿 등록은 API스토어 로그인 이후 카카오 알림톡 API 구매완료 후 등록 할 수 있음.

6. 실 발송에 대한 API 규격은 API스토어 > 카카오 알림톡 API > 매뉴얼/유의사항 에 업로드 되어있는 규격서를 참고.
(본 페이지 상단에서도 다운로드 받으실 수 있습니다.)