K-OTP

메시지 템플릿과 서비스명

OTP 메시지의 두 가지 형태, 앱의 발송 서비스명을 설정하고 승인받는 방법, 추가 템플릿을 요청하는 방법을 설명합니다.

K-OTP는 사전 등록된 카카오 알림톡 템플릿으로 인증번호를 보내므로 메시지 문구는 고정입니다. 앱마다 달라질 수 있는 것은 [K-OTP] 바로 뒤에 표시되어 어느 서비스의 인증번호인지 알려 주는 서비스명뿐입니다.

두 가지 형태

기본 메시지에는 서비스명이 없습니다. 서비스명 메시지는 승인된 서비스명(아래 예시는 마이앱)을 접두어 뒤에 붙입니다.

목적기본 메시지서비스명 메시지
기본[K-OTP] 인증번호는 123456입니다. 3분 내에 입력해주세요.[K-OTP] 마이앱 인증번호는 123456입니다. 3분 내에 입력해주세요.
로그인(login)[K-OTP] 로그인 인증번호는 123456입니다. 3분 내에 입력해주세요.[K-OTP] 마이앱 로그인 인증번호는 123456입니다. 3분 내에 입력해주세요.
회원가입(signup)[K-OTP] 회원가입 인증번호는 123456입니다. 3분 내에 입력해주세요.[K-OTP] 마이앱 회원가입 인증번호는 123456입니다. 3분 내에 입력해주세요.
결제(payment)[K-OTP] 결제 인증번호는 123456입니다. 3분 내에 입력해주세요.[K-OTP] 마이앱 결제 인증번호는 123456입니다. 3분 내에 입력해주세요.

발송마다 바뀌는 값은 인증번호(위의 123456)뿐입니다. 현재 사용할 수 있는 템플릿은 채널과 SMS 대체 발송을 참고하세요.

K-OTP는 두 조건을 모두 만족할 때만 서비스명 메시지를 보냅니다. 앱에 승인된 서비스명이 있고, 서비스명 템플릿 자체도 카카오톡에서 승인되어 있어야 합니다. 그 밖의 경우에는 기본 메시지로 발송하므로, 심사 중이거나 반려된 이름 때문에 발송이 막히지 않습니다.

서비스명 설정하기

서비스명은 앱에 속하며, API 요청이 아니라 콘솔에서 설정합니다.

  1. 앱을 열고 설정 탭으로 이동합니다.
  2. 발송 서비스명에 이름을 입력합니다. 미리보기에서 네 가지 메시지를 확인할 수 있습니다.
  3. 검토를 요청합니다. 조직 소유자와 관리자만 바꿀 수 있습니다.

이름 규칙:

  • 1~12자. 한글, 영문, 숫자와 단어 사이 공백 한 칸만 쓸 수 있습니다.
  • 기호, 이모지, URL, 연락처는 쓸 수 없습니다.
  • 은행, 카드사, 통신사, 공공기관, 대형 플랫폼, 공식 안내로 오해할 수 있는 이름(예: "고객센터", "본인인증")은 등록할 수 없습니다. 본인의 브랜드라면 고객 지원에 문의해 주세요.

새로 등록하거나 바꾼 이름은 운영자가 검토한 뒤에 사용됩니다. 상태는 입력란 옆에 표시됩니다.

상태발송 방식
없음서비스명 없이 발송
심사 중서비스명 없이 발송
승인됨서비스명 포함(서비스명 템플릿이 제공되기 시작한 뒤부터)
반려서비스명 없이 발송(사유는 메모로 안내)

승인된 이름을 바꾸면 다시 검토를 받으며, 새 이름이 승인되기 전까지는 서비스명 없이 발송됩니다. 이름을 삭제하면 즉시 기본 메시지로 돌아갑니다. 승인된 이름은 약 1분 안에 API에 반영됩니다(API가 키 정보를 최대 60초 캐시합니다).

서비스명은 콘솔에서만 정해지므로 요청마다 지정하거나 덮어쓰거나 끼워 넣을 수 없습니다. templateVariables에도 해당 항목이 없습니다.

추가 템플릿

추가 템플릿(예: 다른 목적의 문구)은 셀프 서비스가 아니라 요청 기반으로 추가합니다. 사용 사례와 함께 고객 지원에 문의해 주세요. 템플릿은 다음 조건을 모두 만족해야 합니다.

  • OTP·인증번호 용도로만 사용합니다.
  • [K-OTP] 접두어를 유지합니다.
  • 변수는 인증번호와 승인된 서비스명뿐입니다.
  • 자유 문구, URL, 버튼은 넣을 수 없습니다.

카카오톡이 템플릿을 심사하며 보통 며칠이 걸립니다. 승인되기 전에는 사용할 수 없고, 요청한 템플릿이 승인된다는 보장은 없습니다.

고객 전용 카카오 채널

K-OTP의 발신 프로필이 아니라 고객의 카카오톡 발신 프로필로, 고객의 이름으로 발송하는 방식을 앞으로 제공할 수도 있습니다. 일정과 가격은 아직 정해진 것이 없습니다.

이 페이지의 내용