# SMS 및 메신저 오류
이 페이지에는 SMS 또는 메신저 전송 시 [메시지 통계](/ko/product/statistics-and-analytics/messaging-statistics/sms-and-messenger-statistics/#errors-tab)의 **오류** 탭에 표시될 수 있는 오류와 각 오류에 대한 조치 방법이 나와 있습니다. **Phone Number Not Found** 또는 **Skip Push**처럼 모든 플랫폼에서 표시될 수 있는 오류는 [오류 탭 읽는 방법](/ko/product/statistics-and-analytics/messaging-statistics/how-to-read-the-errors-tab/#errors-on-every-platform)에서 확인하세요.
## 오류 탭에 SMS 및 메신저 오류가 표시되는 방식
**오류** 탭은 실패한 전송을 플랫폼별로 그룹화합니다. 각 행에는 오류 이름과 괄호 안의 코드가 표시됩니다(예: **Invalid To Phone Number (1001)**). 대부분의 오류는 SMS 공급자나 메신저에서 발생하며, Pushwoosh는 원인과 관계없이 이를 **제공업체 오류** 범주로 집계합니다. 각 범주의 의미는 [오류 범주](/ko/product/statistics-and-analytics/messaging-statistics/how-to-read-the-errors-tab/#error-categories)를 참조하세요.
Pushwoosh는 여러 단계에서 메시지를 확인하므로 같은 번호가 서로 다른 오류를 나타낼 수 있습니다. 예를 들어 **Skip Push (1011)**와 **Send Quota Exceeded (1011)**는 서로 다른 오류입니다. 오류는 이름과 코드를 함께 사용하여 찾으세요.
**오류** 탭에는 Pushwoosh가 메시지를 전송하는 시점에 반환된 오류만 표시됩니다. 공급자나 메신저가 메시지를 수락한 후 이동통신사 단계 등에서 나중에 실패한 경우, 해당 전송은 수락된 것으로 집계되며 오류로 표시되지 않습니다. 대부분의 네트워크 오류와 같은 일부 일시적인 실패는 재시도되므로 역시 표시되지 않습니다. WhatsApp에서는 네트워크 오류가 재시도되지 않으며 **Internal Service Error** (10006)로 표시됩니다.
[마케팅 동의](/ko/product/messaging-channels/sms-viber-marketing-consent/)를 하지 않아 제외된 구독자도 오류가 아닙니다. 이러한 구독자는 전송 전에 대상에서 제외됩니다.
## SMS 오류
이러한 오류는 SMS 공급자 또는 프로젝트의 SMS 설정에서 발생합니다. 표시되는 오류는 공급자에 따라 다릅니다. 예를 들어 Twilio는 수신 거부, 유효하지 않은 번호, 해당 국가에서 허용되지 않는 발신자를 아래의 더 구체적인 오류가 아닌 **Bad Request (1006)**로 보고합니다.
### 전화번호 문제
이러한 오류는 공급자 설정이 아니라 수신자의 전화번호로 인해 발생합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Invalid To Phone Number** (1001) | 전화번호를 읽을 수 없거나 국가 코드가 없습니다. Pushwoosh는 해당 번호의 SMS 구독을 취소합니다. | 전화번호를 국가 코드가 포함된 국제 형식(예: `+14155550100`)으로 저장하고 번호를 다시 등록하세요. |
| **Unsubscribed Recipient** (1002) | 수신자가 이동통신사를 통해 메시지 수신을 거부했거나, 번호가 공급자의 차단 목록에 있습니다. 이동통신사를 통한 수신 거부 후 Pushwoosh는 해당 번호의 SMS 구독을 취소하고 수신 거부를 기록합니다. | 이 번호로 마케팅 메시지를 보내지 마세요. [Pushwoosh가 자동으로 기록하는 수신 거부](/ko/product/messaging-channels/sms-viber-marketing-consent/#opt-outs-pushwoosh-records-automatically)를 참조하세요. 수신자가 수신을 거부하지 않았다면 공급자 대시보드에서 차단 목록을 확인하세요. |
### 공급자 계정 및 설정
이러한 오류는 계정, 자격 증명, 발신자 또는 메시지 때문에 SMS 공급자가 요청을 거부했음을 의미합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Bad Request** (1006) | 공급자가 요청을 거부했습니다. Twilio에서는 이동통신사를 통해 수신을 거부한 수신자, 유효하지 않거나 휴대전화가 아닌 번호, 수신자 국가에서 허용되지 않는 발신자도 이 오류에 포함됩니다. | 공급자 대시보드에서 수신자 번호와 해당 국가의 발신자를 확인하세요. 수신자가 수신을 거부했다면 해당 수신자에게 전송을 중단하세요. |
| **No Permission For Region** (1003) | 이 프로젝트 또는 공급자에서 수신자 국가가 허용되지 않거나, SMS 구성에 공급자 자격 증명 또는 발신자가 설정되어 있지 않습니다. | [SMS 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/sms-configuration/)에서 공급자 자격 증명과 발신자 번호를 확인하세요. 올바르게 설정되어 있다면 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하여 프로젝트에서 SMS를 보낼 수 있는 국가를 확인하세요. |
| **Invalid To From Combination** (1012) | 발신자 ID가 수신자 국가로 전송하도록 허용되지 않았거나, SMS 구성에 발신자 ID가 설정되어 있지 않습니다. | 공급자 대시보드에서 해당 국가에 사용할 발신자를 확인하세요. |
| **Permission Denied** (1015) | 공급자가 자격 증명을 수락하지 않았습니다. | [SMS 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/sms-configuration/)의 자격 증명을 공급자 대시보드와 비교하여 확인하세요. |
| **Forbidden** (1007) | 잘못된 자격 증명 등의 이유로 공급자가 요청 또는 연결을 거부했거나, SMS 연결이 설정되어 있지 않습니다. | [SMS 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/sms-configuration/)의 자격 증명을 공급자 대시보드와 비교하여 확인하세요. |
| **Account Is Inactive** (1014) | SMS 공급자의 계정이 정지되었습니다. | 공급자를 통해 계정을 복구하세요. |
| **Not Found** (1008) | 공급자가 요청에 포함된 계정 또는 발신자를 찾을 수 없습니다. | 공급자 대시보드에서 계정 및 발신자 설정을 확인하세요. |
| **Invalid MMS Attachment** (1016) | 공급자가 형식 또는 크기 때문에 첨부 파일을 거부했습니다. | 공급자가 지원하는 형식의 더 작은 파일을 첨부하세요. |
| **Internal Service Error** (10006) | SMS에서는 계정에 SMS 전송이 활성화되어 있지 않다는 의미일 수도 있습니다. | [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
### 전송 한도
이 오류는 메시지 자체의 문제가 아니라 전송이 SMS 수 한도에 도달했음을 의미합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Send Quota Exceeded** (1011) | 프로젝트가 일일 SMS 한도에 도달했거나 공급자가 전송을 제한했습니다. 일일 SMS 한도는 프로젝트에 SMS를 구성할 때 Pushwoosh가 설정합니다. | 일일 SMS 한도에 대해 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. 대량 전송은 며칠에 걸쳐 나누어 보내세요. |
### 공급자 장애
이러한 오류는 공급자가 메시지를 처리하지 못했거나 Pushwoosh가 읽을 수 없는 응답을 반환했음을 의미합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Unknown Error** (1000), **Converting Error** (1004), **Provider Unknown Error** (1009), **Provider Internal Error** (1010) | 공급자가 Pushwoosh가 인식하지 못하는 오류를 반환했거나 공급자 측에서 장애가 발생했습니다. **Converting Error**는 SMS 구성의 공급자 설정이 완전하지 않다는 의미일 수도 있습니다. | 이러한 오류의 수를 비슷한 규모의 이전 전송과 비교하세요. 오류가 늘어나거나 전송할 때마다 반복되면 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
## Viber 오류
[모든 플랫폼에서 표시될 수 있는 오류](/ko/product/statistics-and-analytics/messaging-statistics/how-to-read-the-errors-tab/#errors-on-every-platform) 외에도 Viber 전송에서는 다음 두 가지 오류가 표시될 수 있습니다. Pushwoosh는 SMS 구성의 MStat 자격 증명을 사용하여 MStat을 통해 Viber 메시지를 보냅니다.
구독자에게 프로젝트의 Viber 연락처가 전혀 없으면 [모든 플랫폼에서 표시될 수 있는 오류](/ko/product/statistics-and-analytics/messaging-statistics/how-to-read-the-errors-tab/#errors-on-every-platform) 중 하나인 **Push Token Not Found** (1007)로 전송이 실패합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **No Device For Push Token** (10002) | 구독자의 Viber 연락처가 전화번호 없이 저장되어 있습니다. | 구독자의 번호를 Viber에 다시 등록하세요. [Viber 연락처 등록](/ko/product/messaging-channels/viber/register-viber-contacts/)을 참조하세요. |
| **Internal Service Error** (10006) | MStat 자격 증명 또는 계정 ID가 없거나, 메시지 콘텐츠가 유효하지 않거나, MStat이 메시지를 거부했습니다. **오류** 탭에는 이 중 어느 것인지 표시되지 않습니다. | [SMS 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/sms-configuration/)에 MStat이 유효한 자격 증명으로 설정되어 있는지 확인하고 메시지 콘텐츠를 확인하세요. 둘 다 올바르다면 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
## WhatsApp 오류
대부분의 WhatsApp 오류는 Meta에서 발생합니다. Meta는 메시지를 먼저 수락한 후 나중에 거부하는 경우가 많습니다. 예를 들어 번호가 WhatsApp에 없거나 Meta가 해당 사용자에 대한 마케팅 메시지를 제한하는 경우입니다. 이러한 전송은 퍼널에서 **게이트웨이 수락**로 집계되며, 전달 확인을 받지 못하고 **오류** 탭에도 표시되지 않습니다.
### 24시간 창 밖의 메시지
승인된 템플릿 없이 보내는 자유 형식 메시지는 수신자가 비즈니스 번호로 마지막 메시지를 보낸 후 24시간 이내에만 전달됩니다. 이 창을 벗어나면 다음 오류 중 하나로 전송이 실패합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Re Engagement Message** (1030) | 수신자가 지난 24시간 동안 비즈니스 번호로 메시지를 보내지 않았습니다. | 자유 형식 텍스트 대신 승인된 템플릿을 보내세요. |
| **Processing Error** (1035) | 24시간 창이 이미 닫혔기 때문에 Pushwoosh가 자유 형식 메시지를 건너뛰었습니다. | 자유 형식 텍스트 대신 승인된 템플릿을 보내세요. |
### 수신자 오류
이러한 오류는 수신자 또는 메시지 발송 빈도로 인해 발생합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Recipient Invalid Phone Number** (1011) | 수신자 번호가 비즈니스 번호와 같습니다. | 대상에서 자신의 비즈니스 번호를 제거하세요. |
| **Accounts Pair Rate Limit Hit** (1059) | 짧은 시간에 같은 사용자에게 너무 많은 메시지를 보냈습니다. | 같은 사용자에게 보내는 메시지 사이에 간격을 두세요. |
### 템플릿 및 콘텐츠 오류
이러한 오류는 Meta가 템플릿 또는 메시지 콘텐츠를 거부했음을 의미합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Template Does Not Exist** (1037) | 선택한 언어로 된 템플릿이 없거나 템플릿이 아직 승인되지 않았습니다. | WhatsApp Manager에서 템플릿과 해당 언어를 확인한 후 프리셋에서 승인된 템플릿을 선택하세요. |
| **Template Param Count Mismatch** (1036) | 변수 값의 수가 템플릿의 변수 수와 일치하지 않습니다. | 프리셋에서 템플릿의 모든 변수를 채우세요. |
| **Template Parameter Format Mismatch** (1040) | 변수 값의 형식이 잘못되었습니다. | WhatsApp Manager에서 템플릿과 비교하여 변수 값을 확인하세요. |
| **Template Hydrated Text Too Long** (1038) | 변수를 채운 후 텍스트가 너무 깁니다. | 변수 값이나 템플릿 텍스트를 줄이세요. |
| **Template Format Character Policy Violated** (1039) | 템플릿 콘텐츠가 WhatsApp 정책을 위반합니다. | WhatsApp Manager에서 템플릿을 수정하고 다시 승인을 요청하세요. |
| **Template Is Paused** (1041) | 품질이 낮아 Meta가 템플릿을 일시 중지했습니다. | 승인된 다른 템플릿을 사용하거나 WhatsApp Manager에서 이 템플릿을 개선하세요. |
| **Template Is Disabled** (1042) | Meta가 템플릿을 여러 번 일시 중지한 후 영구적으로 비활성화했습니다. | 새 템플릿을 만들어 프리셋에서 사용하세요. |
| **Request Invalid Parameter** (1010), **Request Missing Required Parameter** (1009), **Parameter Value Is Not Valid** (1020), **Generic User Error** (1053) | 메시지의 값이 없거나 유효하지 않습니다. | 프리셋의 템플릿, 변수, 버튼, 첨부 파일을 확인하세요. |
| **Unsupported Message Type** (1032) | WhatsApp에서 이 유형의 메시지를 지원하지 않습니다. | 프리셋에서 콘텐츠 유형을 변경하세요. |
| **Media Upload Error** (1034) | Meta가 첨부된 미디어를 불러오지 못했습니다. | WhatsApp에서 지원하는 형식의 파일을 공개 `https` URL로 사용하세요. |
### 계정 및 품질 오류
이러한 오류는 Meta가 WhatsApp Business Account 또는 비즈니스 번호를 제한했음을 의미합니다. [제한되거나 차단된 발신자를 해결하는 방법](/ko/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/#how-to-fix-a-blocked-or-limited-sender)에 설명된 대로 WhatsApp Manager에서 해결하세요.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Temporarily Blocked For Policies Violations** (1005) | 정책 위반으로 Meta가 계정을 차단했습니다. | WhatsApp Manager에서 계정 상태를 확인하세요. |
| **Account Has Been Locked** (1017) | 정책 위반으로 Meta가 계정을 잠갔거나, 요청의 데이터를 확인할 수 없었습니다. | WhatsApp Manager에서 계정 상태를 확인하세요. |
| **Account Is Restricted From Messaging In This Country** (1016) | 이 계정은 이 국가의 사용자에게 메시지를 보낼 수 없습니다. | WhatsApp Manager에서 계정 제한 사항을 확인하세요. |
| **Spam Rate Limit Hit** (1008) | 이전 메시지 중 다수가 차단되거나 스팸으로 신고되어 Meta가 이 번호의 전송량을 제한합니다. | 최근 메시지의 콘텐츠와 대상을 검토한 후 전송량을 줄이세요. |
| **Business Eligibility Payment Issue** (1028) | 계정의 결제 수단에 문제가 있습니다. | WhatsApp Manager에서 결제 수단을 확인하세요. |
| **Provided Number Needs Display Name Approval** (1027) | 비즈니스 번호의 표시 이름이 아직 승인되지 않았습니다. | 승인을 기다리거나 WhatsApp Manager에서 표시 이름을 업데이트하세요. |
| **Business Phone Number Is Deleted** (1024) | 비즈니스 번호가 삭제되었습니다. | [WhatsApp 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/)에서 활성 번호를 연결하세요. |
| **Account In Maintenance Mode** (1035) | 계정이 유지 관리 모드입니다. 이 오류는 [24시간 창 밖의 메시지](#messages-outside-the-24-hour-window)의 **Processing Error** (1035)와 다른 오류입니다. | 나중에 다시 시도하세요. |
### 설정 및 권한 오류
이러한 오류는 Pushwoosh와 WhatsApp Business Account 간의 연결이 작동하지 않음을 의미합니다. [WhatsApp 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/)에 설명된 대로 **Settings > Configure Platforms > WhatsApp**에서 WhatsApp Business Account를 다시 연결하세요.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Access Token Expired** (1003) | 연결의 액세스 토큰이 만료되었습니다. | 계정을 다시 연결하세요. |
| **Authentication Failed** (1002), **Permission Denied** (1013), **API Permission** (1014), **API Method** (1015), **Access Denied** (1023) | Meta가 연결을 수락하지 않았거나 권한이 누락되었습니다. | 계정을 다시 연결하고 요청된 모든 권한을 부여하세요. |
| **Incorrect Certificate** (1029) | 비즈니스 번호가 올바르게 등록되지 않았습니다. | WhatsApp Manager에서 비즈니스 번호를 확인한 후 계정을 다시 연결하세요. |
| **Internal Service Error** (10006) | WhatsApp 설정에 비즈니스 번호 또는 액세스 토큰이 없거나, Pushwoosh가 Meta에 연결하지 못했거나 Meta의 응답을 읽지 못했습니다. | WhatsApp 설정을 확인하고 필요하면 계정을 다시 연결하세요. 오류가 반복되면 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
### 전송 속도 제한
이러한 오류는 앱 또는 계정에 대해 Meta가 허용하는 속도보다 빠르게 전송했음을 의미합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Rate Limit Hit** (1058) | 번호의 메시지 처리량 한도에 도달했습니다. | 전송 속도를 낮추거나 전송을 더 작은 배치로 나누세요. |
| **API Too Many Calls** (1056), **Rate Limit Issues** (1057) | 앱 또는 계정이 요청 한도에 도달했습니다. | 전송 속도를 낮추거나 전송을 더 작은 배치로 나누세요. |
### 일시적인 Meta 오류
이러한 오류는 Meta 측에서 장애가 발생했거나 Meta가 Pushwoosh가 인식하지 못하는 응답을 반환했음을 의미합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **API Unknown** (1018), **API Service** (1019), **Something Went Wrong** (1022), **Service Unavailable** (1025), **Server Temporary Unavailable** (1046) | Meta 측의 일시적인 오류입니다. | 나중에 메시지를 다시 보내세요. 오류가 반복되면 메시지 날짜와 **메시지 코드**를 포함하여 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
| **Unknown Error** (1000), **Cannot Process Sending** (1012) | Meta가 Pushwoosh가 인식하지 못하는 오류나 읽을 수 없는 응답을 반환했습니다. | 오류가 반복되면 메시지 날짜와 **메시지 코드**를 포함하여 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
## Telegram 오류
Telegram 전송에서는 Telegram 고유의 오류 두 가지가 표시됩니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Chat Unavailable** (410007) | 사용자가 봇을 차단 또는 삭제했거나, 채팅을 찾을 수 없거나, Telegram 계정이 비활성화되었습니다. Pushwoosh는 해당 사용자의 Telegram 구독을 취소합니다. | 수정할 사항이 없습니다. 해당 사용자는 봇에서 메시지를 받을 수 없습니다. |
| **Invalid Authentication Info** (401002) | 봇 토큰이 없거나 유효하지 않습니다. 구독자의 Telegram 채팅 ID가 유효하지 않은 경우(이때 Pushwoosh는 해당 구독자의 구독을 취소합니다) 또는 Pushwoosh가 토큰을 확인하기 위해 Telegram에 연결하지 못한 경우에도 표시됩니다. | [Telegram 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/telegram-configuration/)에서 봇 토큰을 확인하세요. |
## Facebook Messenger 오류
이러한 오류는 Pushwoosh가 Facebook 페이지에서 메시지를 보낼 때 Meta에서 발생합니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Outside Allowed Window** (403004) | 사용자가 지난 24시간 동안 페이지에 메시지를 보내지 않았으며, 메시지에 메시지 태그가 없습니다. Pushwoosh는 이러한 사용자를 대상에서 걸러내지 않으므로 이러한 전송은 모두 이 오류로 실패합니다. | 24시간 창 밖에서는 메시지 태그를 사용하여 보내세요. [24시간 창 밖에서 메시지 태그 사용](/ko/product/messaging-channels/facebook-messenger/send-facebook-messenger-messages/#use-a-message-tag-outside-the-24-hour-window)을 참조하세요. |
| **Recipient Unavailable** (410005) | 사용자가 페이지에서 메시지를 받을 수 없습니다. Pushwoosh는 해당 사용자의 Facebook Messenger 구독을 취소합니다. | 수정할 사항이 없습니다. |
| **Invalid Authentication Info** (401002) | Page ID 또는 Page Access Token이 없거나 Meta가 토큰을 수락하지 않았습니다. | [Facebook Messenger 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/facebook-messenger-configuration/)에 유효한 **Page ID**와 **Page Access Token**을 입력하세요. |
| **No Permission** (403003) | Meta App에 이 전송에 필요한 권한이 없습니다. | Meta App 대시보드에서 Meta App의 Messenger 권한을 확인하세요. |
| **Invalid Request Parameter** (400001) | 메시지가 비어 있거나 유효하지 않은 값이 포함되어 있습니다. | 메시지 콘텐츠를 확인하세요. |
| **Internal Server Error** (5009999) | Meta가 Pushwoosh가 인식하지 못하는 오류를 반환했습니다. | 오류가 반복되면 메시지 날짜와 **메시지 코드**를 포함하여 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
## Kakao 오류
대부분의 Kakao 오류는 KakaoTalk 메시징 서비스에서 발생합니다. Pushwoosh는 각 오류를 고유한 이름으로 표시하며, 아래에서는 확인할 항목별로 그룹화했습니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Missing User Code** (4001200), **Missing Secret Key** (4001201) | KakaoTalk 자격 증명이 입력되지 않았습니다. | [Kakao 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/kakao-configuration/)에 **USER CODE**와 **SECRET KEY**를 입력하세요. |
| **Invalid Authentication Info** (401002), **Invalid Token** (401005), **Token Expired** (401006), **Missing Authorization Header** (401004), **No Permission** (403003), **Unregistered Account** (4001100) | 서비스가 액세스 토큰 또는 계정을 수락하지 않았습니다. | [Kakao 구성](/ko/product/first-steps/start-with-your-project/configure-platforms/kakao-configuration/)에서 **USER CODE**와 **SECRET KEY**를 확인하세요. 올바르게 입력되어 있다면 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
| **Unauthorized IP Address** (4031101) | 서비스가 Pushwoosh의 전송 주소에서 오는 요청을 수락하지 않습니다. | [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
| **Insufficient Balance** (4001102) | KakaoTalk 메시징 계정의 잔액이 없습니다. | KakaoTalk 메시징 계정의 잔액을 충전하세요. |
| **Unit Price Not Found** (5001103) | 서비스에 계정의 이 메시지에 대한 단가가 없습니다. | [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
| **Unauthorized Sender Key** (4001104), **Missing Sender Key** (4001301), **Missing Sender Number** (4001208), **Invalid Sender Number Not Registered** (400667), **Invalid Sender Number Policy Violation** (400668) | 발신 프로필 또는 발신 번호가 등록되지 않았거나 허용되지 않습니다. | KakaoTalk 메시징 계정에서 발신 프로필과 발신 번호를 확인하세요. |
| **Template Code Not Found** (4001105), **Missing Template Code** (4001303) | 메시지의 템플릿 코드가 없거나 등록된 템플릿과 일치하지 않습니다. | 메시지가 승인된 [Kakao 템플릿](/ko/product/content/kakao-presets/)을 사용하는지 확인하세요. |
| **Recipient Opted Out** (400090) | 사용자가 KakaoTalk 메시지 수신을 거부했습니다. | 이 사용자에게 마케팅 메시지를 보내지 마세요. |
| **Missing Recipient Number** (4001202), **Invalid Recipient Number Format** (4001204), **Recipient Number Too Long** (4001203), **Missing Country Code** (4001210), **Invalid Country Code Format** (4001212) | 수신자의 전화번호가 없거나 형식이 잘못되었습니다. | 전화번호를 국가 코드가 포함된 국제 형식으로 저장하고 번호를 다시 등록하세요. |
| **Missing Message Body** (4001206), **Message Body Too Long** (4001207), **Title Too Long** (4001205), **Header Too Long** (4001306), **Invalid Request Parameter** (400001), 그리고 이름이 **… Too Long** 또는 **Invalid …**인 기타 오류 | 메시지의 일부가 없거나, 너무 길거나, 값이 유효하지 않습니다. | KakaoTalk 프리셋 또는 메시지에서 오류에 표시된 필드를 수정하세요. |
| **Internal Server Error** (5009999) | 서비스 측에서 장애가 발생했거나 Pushwoosh가 인식하지 못하는 오류를 반환했습니다. | 오류가 반복되면 메시지 날짜와 **메시지 코드**를 포함하여 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
## LINE 오류
대부분의 LINE 오류는 LINE Messaging API가 반환한 HTTP 상태를 따릅니다.
| 오류 | 설명 | 조치 방법 |
| --- | --- | --- |
| **Unable To Get Channel ID** (1011), **Unable To Get Channel Secret** (1012) | **Channel ID** 또는 **Channel secret**이 입력되지 않았습니다. | [LINE 구성](/ko/developer/first-steps/connect-messaging-services/line-configuration/)에 둘 다 입력하세요. |
| **Authentication Failed** (1003) | 채널 시크릿이 변경된 경우 등의 이유로 LINE이 채널의 액세스 토큰을 수락하지 않았습니다. | LINE Developers Console과 비교하여 **Channel ID**와 **Channel secret**을 확인하세요. |
| **Duplicate Post** (1006) | 중복 요청이거나 채널이 Messaging API의 해당 기능을 사용할 수 없어 LINE이 요청을 거부했습니다. | LINE Official Account의 요금제와 권한을 확인하세요. 올바르게 설정되어 있다면 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |
| **Profile Not Found** (1005), **Access Not Available** (1007) | 수신자 또는 요청한 리소스를 LINE에서 더 이상 사용할 수 없습니다. | 이 수신자에 대해서는 수정할 사항이 없습니다. |
| **Bad Request** (1002) | LINE이 요청을 거부했습니다. | 메시지 콘텐츠와 LINE 프리셋을 확인하세요. |
| **Payload Too Large** (1008) | 메시지가 LINE에서 허용하는 크기보다 큽니다. | 메시지 또는 미디어의 크기를 줄이세요. |
| **Unsupported Media Type** (1009) | LINE에서 첨부 파일의 유형을 지원하지 않습니다. | LINE에서 지원하는 형식의 파일을 첨부하세요. |
| **Too Many Requests** (1010) | 채널이 LINE 요청 속도 제한 또는 월간 메시지 한도에 도달했습니다. | 전송 속도를 낮추거나 LINE Official Account 요금제의 메시지 한도를 확인하세요. |
| **Internal Server Error** (1001), **Unknown Error** (1000) | LINE 측에서 장애가 발생했거나 Pushwoosh가 인식하지 못하는 오류를 반환했습니다. | 나중에 메시지를 다시 보내세요. 오류가 반복되면 [Pushwoosh 지원팀](https://help.pushwoosh.com/hc/en-us/requests/new)에 문의하세요. |