Biz Message 문제

Simple & Easy Notification Service를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

카카오톡 채널 등록 오류

카카오톡 채널이 콘솔에 등록되지 않습니다.
"요청하신 채널 및 템플릿 기능을 처리할 수 있는 상태가 아닙니다. 상태 확인 후 재시도 부탁 드립니다." 오류 메시지가 표시됩니다.
"카카오톡 채널 상태를 확인해 주세요" 오류 메시지가 표시됩니다.

원인

카카오톡 채널 설정이 잘못된 경우, 해당 오류가 발생할 수 있습니다.
기존에 생성한 검색용 아이디와 새로 생성한 검색용 아이디가 동일한 경우, 해당 오류가 발생할 수 있습니다.
이전에 사용하던 벤더와 Simple & Easy Notification Service의 내부 중계사가 같은 경우 발생할 수 있습니다.

해결 방법

카카오톡 채널 설정이 잘못된 경우
카카오 채널 관리자 센터에서 다음을 확인해 주십시오.

• 검색용 채널 아이디 정보가 정확한지 확인해 주십시오.
• 채널이 공개 상태인지 확인해 주십시오.
• 비즈니스 채널로 등록했는지 확인해 주십시오.
• 채널의 고객 센터 정보가 입력되었는지 확인해 주십시오.
  • 고객 센터 정보 입력 참조
• 다른 계정에서 등록하여 사용하고 있는 채널이 아닌지 확인해 주십시오.

검색용 아이디가 동일한 경우
이전에 Simple & Easy Notification Service에 등록했던 검색용 아이디를 가지는 채널인지 확인해 주십시오. 검색용 아이디가 중복되지 않도록 변경해 주십시오.

이전에 사용했던 벤더와 내부 중계사가 같은 경우
이전에 이용했던 벤더사 이름과 채널명을 고객 지원으로 전달해 주십시오. 중계사를 통해 이중 등록 가능 여부를 확인한 후 프로젝트를 수동으로 등록할 수 있습니다. 수동 등록 시 영업일 기준 3일~4일 소요될 수 있습니다.
단, 상황에 따라 채널 등록이 불가하거나, 채널을 이관을 해야할 수 있습니다. 또한 이전 벤더사에서 이용 중인 템플릿 코드를 재사용할 수 없을 수 있으며, 템플릿 이관은 불가합니다.

고객 센터 정보 입력

채널 개설 시 "등록하려는 발신 프로필 채널의 고객 센터 정보 입력이 필요합니다." 오류 메시지가 표시됩니다.
"요청하신 채널 작업을 수행할 수 없습니다." 오류 메시지가 표시됩니다.
고객 센터 정보를 입력하는 위치를 찾을 수 없습니다.

원인

2023년 6월 22일부터 KISA 가이드에 따라 신규 발신 프로필(채널) 등록 시 고객 센터 정보 입력이 의무화되었습니다. 채널 생성 및 등록 전에 고객 센터 정보를 입력해야 합니다.

해결 방법

고객 센터 정보를 입력하는 방법은 다음과 같습니다.

1. 카카오톡의 채널 관리자 센터에 접속해 주십시오.
2. 프로필 > 채널홈 설정을 클릭해 주십시오.
3. 기본 정보 항목의 고객센터 입력 필드에 고객센터 정보를 입력해 주십시오.

채널 등록 불가

채널이 등록되지 않습니다.
채널 삭제 이력이 있어 등록이 불가하다는 메시지가 표시됩니다.

원인

이전에 채널로 등록했다가 삭제한 카카오톡 채널은 복원할 수 없습니다. 또한 다른 계정으로도 Simple & Easy Notification Service에 재등록할 수 없습니다.

해결 방법

해당 현상은 시스템의 정상적인 동작으로, 삭제된 카카오톡 채널은 복원이 불가능하며 동일한 채널을 다시 등록하는 것도 지원되지 않습니다. 이에 따라 현재 상태에서는 동일 채널을 다시 등록할 수 없습니다. 자세한 내용은 카카오톡 채널 삭제를 참조해 주십시오.

채널 삭제 지연

채널 삭제가 지연되고 있습니다.

원인

채널 삭제 시 검수가 필요하므로 즉시 삭제되지 않습니다.

해결 방법

채널 삭제는 중계사의 정산 처리 등의 이유로 한 달까지 소요될 수 있습니다. 삭제가 완료될 때까지 대기 부탁드리며 삭제 요청 중인 채널은 삭제 취소가 불가합니다.

• 카카오톡 채널 삭제
• 카카오톡 채널 이관 동일 계정

알림톡 수신 실패

알림톡 발송 요청은 성공했으나 수신 상태가 실패로 표시됩니다.
API 응답 결과에는 "COMPLETED" 상태로 표시되나 알림이 발송되지 않았습니다.

원인

서비스 이용 환경에 따라 다양한 원인이 있을 수 있습니다.

• 수신자의 알림 설정에 문제가 있을 경우
• 수신자의 정보가 잘못 설정되었을 경우
• 템플릿에 문제가 있거나 발송 내용에 멀티바이트 이모지가 포함되어 있을 경우

해결 방법

다음 항목을 확인해 주십시오.

알림 설정 확인

• 수신자의 카카오톡 수신 설정을 확인해 주십시오.
• 수신자가 알림톡 수신을 허용하고 있는지 확인해 주십시오.
• 알림톡 차단 여부를 확인해 주십시오.

수신자 정보 확인

• 수신자의 전화번호가 올바른 국제 전화 형식(예: +82-10-1234-5678)으로 입력되었는지 확인해 주십시오.
• 발송에 사용된 플러스친구 ID가 정확한지, 해당 플러스친구 계정이 올바르게 등록되어 있는지 확인해 주십시오.
• 수신자가 카카오톡에 등록된 번호와 실제 전화번호가 일치하는지, 번호가 활성 상태인지 확인해 주십시오.

템플릿 및 콘텐츠 확인

• 사용된 템플릿 코드가 정확한지 템플릿이 올바르게 설정되었는지 확인해 주십시오.
• SMS(subject, content)의 경우, 인코딩은 EUC-KR 기준으로 발송됩니다. 지원하지 않는 이모지 문자가 포함되어 있는지 확인해 주십시오. 알림톡 발송 시, failoverConfig.content를 통해 내용을 변경할 수 있습니다.

템플릿에 연결된 채널 변경

템플릿을 승인 받을 채널을 잘못 설정했습니다.
채널을 여러 개 운영 중인데, 승인 받은 템플릿에 연결된 채널을 변경하고 싶습니다.

원인

템플릿에 연결된 채널은 변경할 수 없습니다.

해결 방법

템플릿을 새로 등록하여 다시 승인 요청해 주십시오.

알림톡 템플릿 등록 시 프로젝트 페이지로 이동

알림톡 템플릿 등록 시 프로젝트 페이지로 이동합니다.

원인

알림톡 서비스를 이용하려면 Biz Message 서비스가 포함된 프로젝트가 있어야 합니다.

해결 방법

Biz Message 서비스가 포함된 프로젝트를 생성해 주십시오.

템플릿 승인 지연

템플릿 검수를 요청했는데 아직 진행 중입니다.
템플릿 승인이 완료되지 않습니다.

원인

템플릿 검수 및 승인은 카카오 측에서 진행합니다. 네이버 클라우드 플랫폼에서는 템플릿 승인 처리를 진행하지 않습니다.

해결 방법

템플릿 검수 및 승인은 카카오에서 진행하므로 네이버 클라우드 플랫폼에서는 처리 지연에 대하여 도움을 드릴 수 없습니다.

"템플릿 버튼 형식이 유효하지 않음" 오류 메시지

"템플릿 버튼 형식이 유효하지 않음" 오류 메시지가 표시됩니다.
기존에 등록된 템플릿과 동일하게 적용했음에도 오류가 발생합니다.

원인

동일한 카카오톡 채널 내에서 템플릿 코드와 템플릿명이 중복될 수 없습니다.

해결 방법

템플릿 코드와 템플릿명이 중복되지 않도록 수정한 후 다시 등록해 주십시오.
자세한 내용은 알림톡 템플릿 등록을 참조해 주십시오.

메시지 미리보기 불가

보안 템플릿으로 등록하지 않았는데도 메시지 수신 시 메시지 미리보기가 되지 않습니다.

원인

템플릿에 다음 정보가 포함되어 있을 경우, 템플릿 검수 시 보안 템플릿으로 분류될 수 있습니다.

• OTP
• 인증 번호
• 비밀번호 (재설정, 임시 비밀번호 등)
• 신용 정보 변경 (신용 등급 변경)

해결 방법

보안 템플릿으로 분류되면 메시지 미리보기가 불가합니다. 원인에서 설명한 바와 같이 특정 정보가 포함된 경우 보안 템플릿으로 분류되므로, 템플릿에 포함된 정보를 확인해 주십시오.

채널명에 한글 입력 시 오류

API 파라미터에 채널명을 한글로 입력했을 때 401 인증 오류가 발생합니다.

원인

한글 인코딩 문제로 인해 발생하는 오류입니다.

해결 방법

채널명 호출 시 encodeURI와 같은 라이브러리를 사용하여 호출해 주십시오.

String requestUrl = "/alimtalk/v2/services/{serviceid}/templates?channelId=@" + URLEncoder.encode("네이버클라우드플랫폼", StandardCharsets.UTF_8);

알림톡 수정 및 삭제 불가

등록된 알림톡을 수정하거나 삭제하려고 하는데 해당 버튼이 비활성화되어 있습니다

원인

검수가 완료되어 발송에 사용된 적이 있는 알림톡의 템플릿을 수정하거나 삭제하는 것은 불가합니다.

해결 방법

• 검수 중인 템플릿의 상태가 대기중, 처리중, 반려인 경우, 검수 요청을 취소하여 검수 대기 상태로 변경한 후 템플릿을 수정할 수 있습니다.
• 검수 완료되었으나 발송에 사용된 적이 없는 템플릿인 경우, 승인 취소하여 검수 대기 상태로 변경한 후 템플릿을 수정할 수 있습니다.
• 검수가 완료되어 발송에 사용된 적이 있는 템플릿은 수정 및 삭제가 불가하므로, 필요한 경우 새로운 템플릿을 등록해 주십시오.

3016 오류 코드, "메시지 내용이 템플릿과 일치하지 않음" 오류 메시지

3016 오류 코드가 표시됩니다.
"메시지 내용이 템플릿과 일치하지 않음" 오류 메시지가 표시됩니다.
요청은 성공했는데 수신이 실패로 표시됩니다.

원인

메시지 내용이 템플릿과 일치하지 않는 경우 발생합니다.

해결 방법

Request Body 및 사용한 템플릿 내용과 설정한 내용이 일치하는지 확인해 주십시오. 버튼 순서가 등록된 순서와 일치해야 합니다.
알림톡 오류 코드에 대한 자세한 설명은 알림톡 오류 코드를 참조해 주십시오.

3018 오류 코드, "메시지를 전송할 수 없음" 오류 메시지

3018 오류 코드가 표시됩니다.
"메시지를 전송할 수 없음" 오류 메시지가 표시됩니다.

원인

3018 오류 코드는 수신자 측에 문제가 있을 경우 발생합니다.

• 카카오 가입자가 아닌 경우
• 카카오톡 채널을 차단한 경우
• 유심 번호가 불일치한 경우

해결 방법

3018 오류 코드는 수신자의 문제로, 발신자인 네이버 클라우드 플랫폼에서 원인을 확인하고 조치할 수 없습니다. 수신자가 카카오 또는 통신사를 통해 원인을 확인해 주십시오.