사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
FAQ
이 문서는 카카오톡 메시지에 대해 자주 묻는 질문과 답변을 제공합니다.
서비스에 메시지 기능을 도입하고 싶을 때, 아래 케이스에 따라 적합한 메시지 API 또는 제품을 선택할 수 있습니다.
| 케이스 | 제품 | 설명 |
|---|---|---|
| 회원가입, 주문/배송 내역, 결제 알림 등 정보를 사용자에게 자동 안내하고 싶은 경우 | 알림톡 | 서비스에서 고객에게 중요한 정보를 일방적으로 안내하려면, 서비스의 카카오톡 채널을 통해 발송하는 알림톡이 적합합니다. (예: "000님 회원가입이 완료되었습니다", "주문하신 상품이 배송 출발하였습니다") |
| 사용자 간(친구 간) 서로 자유롭게 메시지를 보내는 소셜 기능을 추가하고 싶은 경우 | 카카오톡 메시지 API | 앱 또는 웹 서비스 내에서 사용자 간 커뮤니케이션(예: 선물 보내기, 이벤트 참여 등) 기능을 구현할 때 사용합니다. 서비스의 사용자에게만 보낼 수 있습니다. |
| 서비스 페이지(글, 상품 등)를 카카오톡 친구에게 손쉽게 공유하고 싶은 경우 | 카카오톡 공유 API | 버튼 하나로 특정 콘텐츠(게시글, 상품, 지도 등)를 카카오톡 친구 또는 그룹채팅방에 바로 공유하고 싶을 때 카카오톡 공유(기본/커스텀)을 사용합니다. |
이 밖에 더 다양한 카카오톡 메시지 제품은 메시지 발송 기능 안내를 참고합니다.
사용 방법을 참고해 추가 기능을 신청해 사용할 수 있습니다. 신청 시, 반려 없이 한 번에 승인을 받으려면 Q. 메시지 추가 기능 심사가 반려된 이유는 무엇인가요?를 참고합니다.
메시지 템플릿을 참고합니다.
서비스에 카카오 로그인을 통해 가입하고 [카카오 서비스 내 친구 목록]과 [카카오톡 메시지 전송] 동의항목에 동의한 사용자에게만 서비스 내에서 카카오톡 메시지를 보낼 수 있습니다.
| 원인 | 해결 방법 |
|---|---|
| 친구가 서비스에 미가입 사용자가 서비스에 카카오 로그인을 통해 연결되지 않은 경우 | 메시지를 보낼 대상이 카카오 로그인 기능으로 가입하거나 로그인 하도록 합니다. |
| 동의항목 미동의 카카오 로그인 시 [카카오 서비스 내 친구 목록] 동의항목에 사용자가 동의하지 않은 경우 | 메시지를 보낼 대상이 해당 동의항목에 동의했는지 확인합니다. 로그인 시 동의하지 않은 사용자를 위해 동의항목 추가 동의 요청을 이용할 수 있습니다. |
| 앱 사용 권한 없음 앱이 카카오톡 친구 목록 API 사용 권한이 없는 경우 | [앱] > [추가 기능 신청]에서 [카카오톡 친구 목록 / 메시지]의 심사 상태가 [심사 승인]인지 확인합니다. 아직 신청하지 않은 경우, 사용 방법을 참고해 추가 기능을 신청합니다. [심사 반려] 상태인 경우, Q. 메시지 추가 기능 심사가 반려된 이유는 무엇인가요?를 참고해 다시 신청합니다. |
| 응답 캐시 친구 목록이 즉시 업데이트되지 않고, 이전 데이터가 일시적으로 남아있는 경우 | 카카오톡 친구 목록 조회 API 응답 캐시 만료 시간(최대 10분)이 지난 후, API를 다시 호출합니다. |
원인
- 메시지 API 쿼터를 초과한 경우
- 기본 템플릿 사용 시, 메시지 구성 형식 올바르지 않은 경우
- 사용자 정의 템플릿 사용 시, 메시지 템플릿 ID가 유효하지 않은 경우
- 메시지 수신자로 지정한 UUID가 올바른 형태가 아니거나, 존재하지 않는 경우
해결 방법
- 쿼터를 참고해 카카오톡 메시지 발송 제한에 도달했는지 확인합니다.
- 기본 템플릿을 참고해 객체 구성 형식을 확인합니다.
- 사용자 정의 템플릿으로 메시지 발송 요청 시, 동일한 앱에서 만든 메시지 템플릿 ID를 사용했는지 확인합니다.
- 카카오톡 친구 목록 조회 API 또는 친구 피커로 전달 받은 수신자 UUID를, 메시지 발송 API 호출 시 정확히 사용했는지 확인합니다.
| 반려 사유 | 조치 사항 |
|---|---|
| 기능 혼동 카카오톡 메시지 API와 알림톡의 목적을 혼동한 경우 | 주문, 배송 알림 정보와 같이 서비스에서 사용자에게 메시지를 보내는 목적이라면 카카오비즈니스에서 제공하는 알림톡 이용 서비스의 사용자끼리 서로 메시지를 보내는 소셜 기능이 목적이라면 카카오톡 메시지 API 이용 |
| 사이트 내 사업자 정보 불일치 또는 미노출 카카오디벨로퍼스 앱 정보와 사업자 정보가 불일치하거나, 사이트에 해당 정보를 확인할 수 없는 경우 | 사이트의 개인정보 처리방침, 이용약관, 회사 소개, 푸터(Footer) 영역에 회사명, 사업자등록번호, 대표자, 주소 등과 같은 사업자 정보를 추가한 뒤 화면 캡처해 제출 |
| 시나리오 불명확 서비스 내에서 가입 → 로그인 → 메시지 발송 기능이 완전하지 않은 경우 | 카카오 로그인 후, 메시지 발송 기능의 동선을 상세히 묘사하여 제출 |
| 제출 자료와 실서비스 불일치 와이어프레임/샘플과 실제 서비스가 다른 경우 | 실제 서비스의 URL이나 화면을 캡처해 제출 |
개발 중이거나 앱스토어 출시 전인 네이티브 앱이라 추가 기능 신청 자료를 준비하기 어려운 경우, 아래 자료를 제출합니다.
- 기획안 또는 디자인 시안
- 개발된 화면 동선(가입 → 로그인 → 마이페이지/설정/탈퇴 등) 스크린샷 또는 동영상
외부에서 접근이 불가한 서비스는 개발된 화면 동선 캡처를 첨부해 재심사를 요청합니다.
위탁업체(개발 대행사)가 카카오디벨로퍼스 앱을 생성 및 운영할 수는 있으나, 등록한 앱 기본 정보는 서비스 소유자(사업자)와 동일한 사업자 정보로 등록해야 합니다.
앱 기본 정보는 카카오 로그인 동의 화면, 카카오톡 메시지 하단의 출처 등 주요 화면에 노출됩니다. (참고: 앱 기본 정보 노출 위치) 따라서 앱의 정보를 서비스의 실제 정보가 아닌 개발 대행사의 정보로 등록한 경우, 추가 기능 신청 시 사업자 정보가 일치하지 않아 심사에서 반려됩니다.
이용약관 URL을 신청서에 기재하고, 카카오디벨로퍼스에 등록된 사업자와 서비스 간 관계를 증빙할 수 있는 자료(정책 문서, 소개 페이지 등)를 첨부합니다.