FAQ

이 문서는 카카오톡 메시지에 대해 자주 묻는 질문과 답변을 제공합니다.

기능 사용

Q. 카카오톡 메시지 API를 사용하고 싶어요.

사용 방법을 참고해 추가 기능을 신청해 사용할 수 있습니다. 신청 시, 반려 없이 한 번에 승인을 받으려면 Q. 메시지 추가 기능 심사가 반려된 이유는 무엇인가요?를 참고합니다.

Q. 메시지는 어떻게 구성하나요?

메시지 템플릿을 참고합니다.

Q. 친구에게 카카오톡 메시지를 보내려고 하는데, 친구가 보이지 않아요.

서비스에 카카오 로그인을 통해 가입하고 [카카오 서비스 내 친구 목록]과 [카카오톡 메시지 전송] 동의항목에 동의한 사용자에게만 서비스 내에서 카카오톡 메시지를 보낼 수 있습니다.

원인	해결 방법
친구가 서비스에 미가입 사용자가 서비스에 카카오 로그인을 통해 연결되지 않은 경우	메시지를 보낼 대상이 카카오 로그인 기능으로 가입하거나 로그인 하도록 합니다.
동의항목 미동의 카카오 로그인 시 [카카오 서비스 내 친구 목록] 동의항목에 사용자가 동의하지 않은 경우	메시지를 보낼 대상이 해당 동의 항목에 동의했는지 확인합니다. 로그인 시 동의하지 않은 사용자를 위해 동의항목 추가 동의 요청을 이용할 수 있습니다.
앱 사용 권한 없음 앱이 카카오톡 친구 목록 API 사용 권한이 없는 경우	[앱] > [추가 기능 신청]에서 [카카오톡 친구 목록 / 메시지]의 심사 상태가 [심사 승인]인지 확인합니다. 아직 신청하지 않은 경우, 사용 방법을 참고해 추가 기능을 신청합니다. [심사 반려] 상태인 경우, Q. 메시지 추가 기능 심사가 반려된 이유는 무엇인가요?를 참고해 다시 신청합니다.
응답 캐시 친구 목록이 즉시 업데이트되지 않고, 이전 데이터가 일시적으로 남아있는 경우	카카오톡 친구 목록 조회 API 응답 캐시 만료 시간(최대 10분)이 지난 후, API를 다시 호출합니다.

Q. 메시지 발송이 실패해요.

원인

• 메시지 API 쿼터를 초과한 경우
• 기본 템플릿 사용 시, 메시지 구성 형식 올바르지 않은 경우
• 사용자 정의 템플릿 사용 시, 메시지 템플릿 ID가 유효하지 않은 경우
• 메시지 수신자로 지정한 UUID가 올바른 형태가 아니거나, 존재하지 않는 경우

해결 방법

• 쿼터를 참고해 카카오톡 메시지 발송 제한에 도달했는지 확인합니다.
• 기본 템플릿을 참고해 객체 구성 형식을 확인합니다.
• 사용자 정의 템플릿으로 메시지 발송 요청 시, 동일한 앱에서 만든 메시지 템플릿 ID를 사용했는지 확인합니다.
• 카카오톡 친구 목록 조회 API 또는 친구 피커로 전달 받은 수신자 UUID를, 메시지 발송 API 호출 시 정확히 사용했는지 확인합니다.

추가 기능 신청

Q. 메시지 추가 기능 심사가 반려된 이유는 무엇인가요?

반려 사유	조치 사항
기능 혼동 카카오톡 메시지 API와 알림톡의 목적을 혼동한 경우	주문, 배송 알림 정보와 같이 서비스에서 사용자에게 메시지를 보내는 목적이라면 카카오비즈니스에서 제공하는 알림톡 이용 서비스의 사용자끼리 서로 메시지를 보내는 소셜 기능이 목적이라면 카카오톡 메시지 API 이용
사이트 내 사업자 정보 불일치 또는 미노출 카카오디벨로퍼스 앱 정보와 사업자 정보가 불일치하거나, 사이트에 해당 정보를 확인할 수 없는 경우	사이트의 개인정보처리방침, 이용약관, 회사 소개, 푸터(Footer) 영역에 회사명, 사업자등록번호, 대표자, 주소 등과 같은 사업자 정보를 추가한 뒤 화면 캡처해 제출
시나리오 불명확 서비스 내에서 가입 → 로그인 → 메시지 발송 기능이 완전하지 않은 경우	카카오 로그인 후, 메시지 발송 기능의 동선을 상세히 묘사하여 제출
제출 자료와 실서비스 불일치 와이어프레임/샘플과 실제 서비스가 다른 경우	실제 서비스의 URL이나 화면을 캡처해 제출

Q. 운영 준비 중인 서비스입니다. 어떻게 심사 받나요?

개발 중이거나 앱스토어 출시 전인 네이티브 앱이라 추가 기능 신청 자료를 준비하기 어려운 경우, 아래 자료를 제출합니다.

• 기획안 또는 디자인 시안
• 개발된 화면 동선(가입 → 로그인 → 마이페이지/설정/탈퇴 등) 스크린샷 또는 동영상

Q. 비공개/인트라넷 서비스입니다. 어떻게 심사 받나요?

외부에서 접근이 불가한 서비스는 개발된 화면 동선 캡처를 첨부해 재심사를 요청합니다.

Q. 위탁받은 개발 대행사입니다. 왜 반려되었나요?

위탁업체(개발 대행사)가 카카오디벨로퍼스 앱을 생성 및 운영할 수는 있으나, 등록한 앱 기본 정보는 서비스 소유자(사업자)와 동일한 사업자 정보로 등록해야 합니다.

앱 기본 정보는 카카오 로그인 동의 화면, 카카오톡 메시지 하단의 출처 등 주요 화면에 노출됩니다. (참고: 앱 기본 정보 노출 위치) 따라서 앱의 정보를 서비스의 실제 정보가 아닌 개발 대행사의 정보로 등록한 경우, 추가 기능 신청 시 사업자 정보가 일치하지 않아 심사에서 반려됩니다.

Q. 서비스 특성상 푸터를 표시할 수 없거나 사업자 정보를 그대로 표시하기 어렵습니다.

이용약관 URL을 신청서에 기재하고, 카카오디벨로퍼스에 등록된 사업자와 서비스 간 관계를 증빙할 수 있는 자료(정책 문서, 소개 페이지 등)를 첨부합니다.