페이지 이동경로
  • 문서>
  • 카카오톡 채널>
  • 에러 코드

카카오톡 채널

에러 코드

이 문서는 카카오톡 채널 API 이용 중 발생할 수 있는 주요 에러와 해결 방법을 안내합니다. 이 외에 에러 코드는 공통 에러 코드를 참고합니다.

REST API

공통

도메인이 kapi.kakao.com인 카카오톡 채널 API를 호출할 때 발생하는 에러 목록입니다. (참고: 응답 형식)

에러 코드 상태 코드 원인 해결 방법
-541 400 존재하지 않는 카카오톡 채널인 경우 -
-544 400 카카오톡 채널이 제재 상태인 경우 -
-815 400 카카오톡 채널 API 내부 에러 -
-816 400 파일 ID가 잘못된 경우나 해당 파일 ID로 업로드된 카카오톡 채널 고객파일을 찾을 수 없는 경우 -
-817 400 이미 존재하는 파일명이나 허용되지 않는 파일명으로 고객파일 등록하는 경우 -
-818 400 등록한 고객파일이 최대 개수를 초과한 경우 (카카오톡 채널 관리자센터에 업로드한 파일 포함하여 최대 30개) -
-819 400 카카오톡 채널과 앱이 연결되지 않은 경우 앱에 카카오톡 채널 연결

SDK

카카오톡 채널 추가 에러

Kakao SDK를 통해 카카오톡 채널 추가 API 호출 시 발생하는 에러 목록입니다.

에러 코드 원인 해결 방법
KAE001 서버 내부에서 처리 중 에러가 발생한 경우 재시도
KAE003 잘못된 파라미터로 요청한 경우 요청 파라미터 확인
KAE004 유효 시간이 만료된 경우 사용자에게 에러 원인과 재시도 필요 안내
KAE005 조회가 불가능한 상태(잘못된 채널 프로필 ID 또는 요청 수행 불가)의 채널 정보로 요청한 경우 올바른 채널 정보로 재요청
KAE006 친구 추가가 불가능한 상태(비공개, 잠금 등)의 채널 정보로 요청한 경우 채널 상태 확인 후 올바른 정보로 재요청
KAE007 지원하지 않는 환경에서 요청한 경우 사용자에게 에러 원인 안내
KAE104 잘못된 앱 키로 요청한 경우 앱 관리 페이지의 [앱] > [일반] > [앱 키]에서 확인한 올바른 플랫폼의 앱 키로 재요청
KAE105 앱과 연결되지 않은 채널 정보로 요청한 경우 앱에 카카오톡 채널 연결 후 재요청
KAE108 카카오디벨로퍼스 앱 또는 개발자 계정이 제재된 경우 데브톡으로 문의합니다.
KAE201 유효하지 않은 액세스 토큰으로 요청한 경우 액세스 토큰 재발급 후 재요청
카카오톡 채널> 에러 코드