---
title: "Biz Message 문제"
slug: "sens-troubleshoot-bizmessage"
updated: 2026-05-21T09:01:25Z
published: 2026-05-21T09:03:05Z
canonical: "guide-gov.ncloud-docs.com/sens-troubleshoot-bizmessage"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Biz Message 문제

Classic/VPC 환경에서 이용 가능합니다.

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

## 카카오톡 채널 등록 오류

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

#### 원인

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

#### 해결 방법

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

- 검색용 채널 아이디 정보가 정확한지 확인해 주십시오.
- 채널이 공개 상태인지 확인해 주십시오.
- 비즈니스 채널로 등록했는지 확인해 주십시오.
- 채널의 고객 센터 정보가 입력되었는지 확인해 주십시오.
  - [고객 센터 정보 입력](/docs/sens-troubleshoot-bizmessage#%EA%B3%A0%EA%B0%9D%EC%84%BC%ED%84%B0%EC%A0%95%EB%B3%B4%EC%9E%85%EB%A0%A5) 참조
- 다른 계정에서 등록하여 사용하고 있는 채널이 아닌지 확인해 주십시오.

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

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

## 고객 센터 정보 입력

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

#### 원인

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

#### 해결 방법

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

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

참고

자세한 설명은 [카카오톡 채널 관리자 센터](https://kakaobusiness.gitbook.io/main/channel/run)를 참조해 주십시오.

## 채널 등록 불가

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

#### 원인

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

#### 해결 방법

해당 현상은 시스템의 정상적인 동작으로, 삭제된 카카오톡 채널은 복원이 불가능하며 동일한 채널을 다시 등록하는 것도 지원되지 않습니다. 이에 따라 현재 상태에서는 동일 채널을 다시 등록할 수 없습니다. 자세한 내용은 [카카오톡 채널 삭제](/docs/sens-ktchannel#%EC%B9%B4%EC%B9%B4%EC%98%A4%ED%86%A1%EC%B1%84%EB%84%90%EC%82%AD%EC%A0%9C)를 참조해 주십시오.

## 채널 삭제 지연

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

#### 원인

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

#### 해결 방법

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

- [카카오톡 채널 삭제](/docs/sens-ktchannel#%EC%B9%B4%EC%B9%B4%EC%98%A4%ED%86%A1%EC%B1%84%EB%84%90%EC%82%AD%EC%A0%9C)
- [카카오톡 채널 이관 동일 계정](/docs/sens-ktchannel#%EC%B9%B4%EC%B9%B4%EC%98%A4%ED%86%A1%EC%B1%84%EB%84%90%EC%9D%B4%EA%B4%80%EB%8F%99%EC%9D%BC%EA%B3%84%EC%A0%95)

참고

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

## 알림톡 수신 실패

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

#### 원인

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

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

#### 해결 방법

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

**알림 설정 확인**

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

**수신자 정보 확인**

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

**템플릿 및 콘텐츠 확인**

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

## 템플릿에 연결된 채널 변경

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

#### 원인

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

#### 해결 방법

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

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

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

#### 원인

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

#### 해결 방법

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

## 템플릿 승인 지연

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

#### 원인

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

#### 해결 방법

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

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

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

#### 원인

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

#### 해결 방법

템플릿 코드와 템플릿명이 중복되지 않도록 수정한 후 다시 등록해 주십시오. 자세한 내용은 [알림톡 템플릿 등록](/docs/sens-attemplate#%EC%95%8C%EB%A6%BC%ED%86%A1%ED%85%9C%ED%94%8C%EB%A6%BF%EB%93%B1%EB%A1%9D)을 참조해 주십시오.

## 메시지 미리보기 불가

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

#### 원인

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

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

#### 해결 방법

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

## 채널명에 한글 입력 시 오류

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

#### 원인

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

#### 해결 방법

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

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

## 알림톡 수정 및 삭제 불가

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

#### 원인

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

#### 해결 방법

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

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

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

#### 원인

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

#### 해결 방법

Request Body 및 사용한 템플릿 내용과 설정한 내용이 일치하는지 확인해 주십시오. 버튼 순서가 등록된 순서와 일치해야 합니다. 알림톡 오류 코드에 대한 자세한 설명은 [알림톡 수신 결과 코드](https://api-gov.ncloud-docs.com/docs/sens-alimtalk-get#%EC%88%98%EC%8B%A0-%EA%B2%B0%EA%B3%BC-%EC%BD%94%EB%93%9C)를 참조해 주십시오.

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

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

#### 원인

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

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

#### 해결 방법

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

참고

이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.