메시지 템플릿과 서비스명
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~12자. 한글, 영문, 숫자와 단어 사이 공백 한 칸만 쓸 수 있습니다.
- 기호, 이모지, URL, 연락처는 쓸 수 없습니다.
- 은행, 카드사, 통신사, 공공기관, 대형 플랫폼, 공식 안내로 오해할 수 있는 이름(예: "고객센터", "본인인증")은 등록할 수 없습니다. 본인의 브랜드라면 고객 지원에 문의해 주세요.
새로 등록하거나 바꾼 이름은 운영자가 검토한 뒤에 사용됩니다. 상태는 입력란 옆에 표시됩니다.
| 상태 | 발송 방식 |
|---|---|
| 없음 | 서비스명 없이 발송 |
| 심사 중 | 서비스명 없이 발송 |
| 승인됨 | 서비스명 포함(서비스명 템플릿이 제공되기 시작한 뒤부터) |
| 반려 | 서비스명 없이 발송(사유는 메모로 안내) |
승인된 이름을 바꾸면 다시 검토를 받으며, 새 이름이 승인되기 전까지는 서비스명 없이 발송됩니다. 이름을 삭제하면 즉시 기본 메시지로 돌아갑니다. 승인된 이름은 약 1분 안에 API에 반영됩니다(API가 키 정보를 최대 60초 캐시합니다).
서비스명은 콘솔에서만 정해지므로 요청마다 지정하거나 덮어쓰거나 끼워 넣을 수 없습니다. templateVariables에도 해당 항목이 없습니다.
추가 템플릿
추가 템플릿(예: 다른 목적의 문구)은 셀프 서비스가 아니라 요청 기반으로 추가합니다. 사용 사례와 함께 고객 지원에 문의해 주세요. 템플릿은 다음 조건을 모두 만족해야 합니다.
- OTP·인증번호 용도로만 사용합니다.
[K-OTP]접두어를 유지합니다.- 변수는 인증번호와 승인된 서비스명뿐입니다.
- 자유 문구, URL, 버튼은 넣을 수 없습니다.
카카오톡이 템플릿을 심사하며 보통 며칠이 걸립니다. 승인되기 전에는 사용할 수 없고, 요청한 템플릿이 승인된다는 보장은 없습니다.
고객 전용 카카오 채널
K-OTP의 발신 프로필이 아니라 고객의 카카오톡 발신 프로필로, 고객의 이름으로 발송하는 방식을 앞으로 제공할 수도 있습니다. 일정과 가격은 아직 정해진 것이 없습니다.