POPBill Developers
API Reference

카카오톡 상태코드

상태코드는 전송할 카카오톡의 접수 및 전송상태를 확인하는 "팝빌 상태코드(state)"와 카카오톡 전송결과(성공/실패)에 대한 상세설명을 확인할 수 있는 "통신사 결과코드(result)"로 구성됩니다.

카카오톡 상태코드와 결과코드는 '알림톡/친구톡 전송내역 확인(GetMessages) API'를 통하여 확인할 수 있습니다. [GetMessages-알림톡/친구톡 전송내역 확인]

팝빌 상태코드(state)

전송할 카카오톡의 접수부터 전송까지 팝빌이 직접 반환하는 상태코드로 "숫자 1자리"로 구성됩니다.

코드코드명설명
0 접수 발신자가 팝빌 시스템에 카카오톡 전송을 접수합니다.
1 대기중 통신사에 전송 요청하기 위해 대기중 입니다.
2 처리중 통신사를 통해 수신자에게 카카오톡 전송중 입니다.
3 완료 수신자에게 카카오톡 전송이 완료되어 결과코드 확인이 가능합니다.
4 취소 예약전송이 취소된 상태입니다.

통신사 결과코드(result)

카카오톡 전송결과에 대해 통신사가 직접 반환하는 결과코드로 "숫자 3자리"로 구성됩니다.

성공

코드코드명설명
100 성공 수신자에게 카카오톡 또는 대체문자 전송을 정상적으로 완료한 상태입니다.

카카오톡 실패코드

코드설명과금여부
602 메시지 길이제한 오류 (텍스트 타입 1,000자 / 이미지 타입 400자 초과) 미과금
608 발신 프로필 키가 유효하지 않음 미과금
610 발신 프로필을 찾을 수 없음 미과금
611 삭제된 발신프로필. (팝빌로 문의) 미과금
612 차단 상태의 발신프로필. (팝빌로 문의) 미과금
620 템플릿 일치 확인시 오류 발생 (내부 오류 발생) 미과금
622 메시지를 전송했으나 수신확인 안됨 (성공불확실 – 서버에는 암호화 되어 보관되며 30일 이내 수신 가능) 미과금
624 전화번호 오류 미과금
629 템플릿을 찾을 수 없음 미과금
630 메시지 내용이 템플릿과 일치하지 않음 미과금
631 메시지를 전송할 수 없음 (친구톡의 경우 친구가 아닐 경우 등) 미과금
634 메시지 전송가능한 시간이 아님 (친구톡은 08:00~20:00 까지 전송 가능) 미과금
657 전화번호 or app user id가 유효하지 않거나 미입력 요청 미과금
658 차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) 미과금
659 삭제된 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) 미과금
660 삭제대기 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) 미과금
661 메시지차단 상태의 카카오톡 채널 (카카오톡 채널 운영툴에서 확인) 미과금
663 변수 글자수 제한 초과 미과금
665 메시지 버튼/바로연결이 템플릿과 일치하지 않음 미과금

대체문자 실패코드

코드설명과금여부
201 문자 길이 오류 미과금
208 기타 메시지 형식 오류 미과금
209 컨텐츠 크기 초과 미과금
210 메시지 크기 초과 미과금
211 첨부파일 관련 오류 미과금
302 변작 신고 접수 발신 번호 미과금
303 발신번호 도용차단 서비스 가입 미과금
305 발신/착신 번호 에러 미과금
402 메시지 저장개수 초과 미과금
403 단말기 음영지역, 전원꺼짐 통신사 Time out 미과금
404 휴대폰 꺼짐 미과금
405 수신 불량지역에 위치 미과금
406 휴대폰 호 처리중 미과금
407 수신번호 서비스 중지 미과금
408 SMS 수신불가 단말 미과금
409 수신자가 발신번호 거부 미과금
410 기타 단말기 오류 미과금
411 착신 가입자 미등록 미과금
415 무응답 및 통화중 미과금
500 이동통신사 스팸 처리 미과금
502 문자 전송시간 초과 미과금
503 공정위(Nospam.go.kr) 등록 스팸번호 미과금
504 기타 이동통신사 오류 미과금
506 이동통신사 착신번호 스팸 미과금
507 수신거부 미과금
510 이동통신사 전화번호 세칙 미준수 발신번호 사용 미과금
511 이동통신사 사전 미등록 발신번호 사용 미과금
512 이동통신사 발신번호 변작으로 등록된 발신번호 사용 미과금
513 이동통신사 번호도용문자차단서비스에 가입된 발신번호 사용 미과금
800 080 수신거부 대상 미과금
801 광고 문자 080 수신거부 번호 미기재 미과금
802 통합 수신거부 대상 미과금
999 기타 오류 미과금