LetsBot 메뉴
시작하기 한국어 언어

Meta 비즈니스 파트너 영국 등록 법인

언어

무료 참고 자료

WhatsApp Business API 오류 코드 의미와 해결 방법 총정리

메시지 전송이 실패하거나 번호를 연결할 때 숫자가 표시되었나요? 여기서 검색하면 정확히 무슨 일이 있었는지, 직접 조치가 필요한지 아니면 다시 시도하면 해결되는지, 그리고 실제 해결 단계를 확인할 수 있습니다.

Meta 공식 문서 기준 확인일 2026-08-24 코드 85 · 상세 페이지 85 공식 출처
캠페인 보고서 Cloud API
  • Sara 배송 완료
  • Karl 실패 13104724시간 응답 창이 닫힘
  • Maya 읽음

권한 오류

6
0 조치 필요

WhatsApp이 더 이상 연결을 허용하지 않음

WhatsApp이 내 계정의 인증이 여전히 유효한지 확인하지 못해 작업이 실행되지 않았습니다. 보통 액세스 토큰이 만료되었거나 무효화되었거...

자세한 설명 및 해결 방법 →
3 조치 필요

WhatsApp 연결에 필요한 권한이 없음

기능 또는 권한 문제로 작업이 거부되었습니다. WhatsApp 연결에 이 작업에 필요한 기능이 없거나, 필요한 권한이 부여되지 않았습니다.

자세한 설명 및 해결 방법 →
10 조치 필요

권한이 부여된 적 없거나 이후 삭제됨

작업에 필요한 권한이 처음부터 부여되지 않았거나 이후 삭제되어 작업이 차단되었습니다. 사용하려는 기능에 대한 자격 요건을 계정이 충...

자세한 설명 및 해결 방법 →
190 조치 필요

WhatsApp 액세스 토큰이 만료됨

WhatsApp 연결을 인증하는 액세스 토큰이 만료되어 WhatsApp이 작업을 거부했습니다. 새 액세스 토큰을 발급받아야 합니다.

자세한 설명 및 해결 방법 →
200 조치 필요

WhatsApp에 액세스 토큰이 전송되지 않음

작업에 액세스 토큰이 전혀 포함되지 않아 WhatsApp이 거부하고 "Provide valid app ID"라고 응답했습니다. 토큰이 만료된 것이 아니라, 아...

자세한 설명 및 해결 방법 →
200-299 조치 필요

필수 권한이 없거나 취소됨

200–299 범위의 오류 코드는 WhatsApp 연결에 필요한 권한이 처음부터 부여되지 않았거나 이후 삭제되었다는 뜻입니다. 해당 권한이 복구될...

자세한 설명 및 해결 방법 →

계정 제한 오류

3

템플릿 생성 오류

7
2388039 일시적

지금은 템플릿 상태를 변경할 수 없음

템플릿이 아직 검토 중인 경우처럼 현재 템플릿 상태를 변경할 수 없어 이 메시지 템플릿 수정이 거부되었습니다. 이 상태에서는 새 템플릿...

자세한 설명 및 해결 방법 →
2388040 조치 필요

템플릿 필드가 글자 수 한도를 초과함

메시지 템플릿의 필드 하나가 허용된 최대 글자 수보다 길어 템플릿이 승인되지 않았습니다. 함께 표시되는 오류 메시지에 해당 필드와 적...

자세한 설명 및 해결 방법 →
2388047 조치 필요

템플릿 헤더 서식이 유효하지 않음

메시지 템플릿의 헤더에 WhatsApp이 허용하지 않는 서식이 포함되어 템플릿이 거부되었습니다. 이 오류는 본문이나 바닥글이 아니라 헤더만...

자세한 설명 및 해결 방법 →
2388072 조치 필요

템플릿 본문 서식이 유효하지 않음

메시지 템플릿의 본문, 즉 주요 텍스트에 WhatsApp이 허용하지 않는 서식이 포함되어 템플릿이 거부되었습니다. 이 오류는 헤더나 바닥글이...

자세한 설명 및 해결 방법 →
2388073 조치 필요

템플릿 바닥글 서식이 유효하지 않음

메시지 템플릿의 바닥글에 WhatsApp이 허용하지 않는 서식이 포함되어 템플릿이 거부되었습니다. 이 오류는 헤더나 본문이 아니라 바닥글만...

자세한 설명 및 해결 방법 →
2388293 조치 필요

템플릿 길이에 비해 변수가 너무 많음

템플릿 문구 길이에 비해 변수가 너무 많아 템플릿이 거부되었습니다. WhatsApp은 변수 개수를 메시지 길이와 비교하는데, 이 템플릿은 허...

자세한 설명 및 해결 방법 →
2388299 조치 필요

템플릿의 시작 또는 끝에 변수가 있음

텍스트의 맨 앞이나 맨 끝에 변수가 있어 템플릿이 거부되었습니다. WhatsApp은 변수로 시작하거나 끝나는 템플릿을 허용하지 않습니다.

자세한 설명 및 해결 방법 →

템플릿 발송 오류

1

전화번호 이전 오류

5

템플릿 인사이트 오류

3

WhatsApp Business 계정 오류

2

동기화 오류

2

속도 및 발송 한도 오류

7
4 일시적

발송 일시 중지 — 앱이 요청 한도에 도달함

내 계정을 WhatsApp에 연결하는 앱이 일정 기간 동안 보낼 수 있는 요청 수에 대해 Meta가 정한 한도에 도달해 메시지가 발송되지 않았습니...

자세한 설명 및 해결 방법 →
80007 일시적

WhatsApp Business 계정이 요청 한도에 도달함

WhatsApp Business 계정이 요청 한도에 도달해 메시지가 발송되지 않았습니다. 짧은 시간에 너무 많은 요청이 발생해 WhatsApp이 당분간 추...

자세한 설명 및 해결 방법 →
130429 일시적

Cloud API 허용 속도보다 빠르게 메시지를 보냄

메시지가 Cloud API가 한 번에 허용하는 속도보다 빠르게 발송되어, 즉 허용되는 최대 발송 속도에 도달해 메시지가 전달되지 않았습니다....

자세한 설명 및 해결 방법 →
131048 조치 필요

이 번호의 발송이 제한됨

이 번호에서 보낼 수 있는 메시지 수에 제한이 걸려 메시지가 발송되지 않았습니다. Meta에 따르면 이전 메시지가 너무 많이 차단되었거나...

자세한 설명 및 해결 방법 →
131056 일시적

같은 수신자에게 너무 많은 메시지를 보냄

짧은 시간 동안 내 번호에서 같은 수신자에게 너무 많은 메시지를 보내 메시지가 전달되지 않았습니다. 해당 번호로의 발송만 잠시 중지되...

자세한 설명 및 해결 방법 →
131064 조치 필요

템플릿 분류 위반으로 발송이 제한됨

템플릿 분류 위반으로 계정이 메시지 발송 한도에 도달했습니다. 이로 인해 고객에게 보내는 템플릿 메시지와 일반 메시지가 모두 중단됩니...

자세한 설명 및 해결 방법 →
133016 일시적

이 번호의 연결 시도 횟수 초과

짧은 시간에 너무 많이 시도해 비즈니스 번호의 연결 또는 연결 해제에 실패했습니다. 차단이 풀릴 때까지 이 번호는 추가 등록 시도가 차...

자세한 설명 및 해결 방법 →

발송 및 연결 오류

43
1 일시적

잘못된 요청 또는 WhatsApp 서버 오류

WhatsApp이 잘못된 요청 또는 서버 오류 가능성을 보고하여 메시지가 발송되지 않았습니다. Meta 상태 페이지에서 서비스 장애 여부를 확인...

자세한 설명 및 해결 방법 →
2 일시적

WhatsApp 서비스 중단 또는 과부하

해당 시점에 WhatsApp 서비스가 일시적으로 중단되었거나 과부하 상태여서 메시지가 발송되지 않았습니다. Meta는 이를 일시적인 상태로 설...

자세한 설명 및 해결 방법 →
33 조치 필요

발신 비즈니스 번호가 삭제됨

발송에 사용된 비즈니스 전화번호가 삭제되어 메시지가 발송되지 않았습니다.

자세한 설명 및 해결 방법 →
100 조치 필요

WhatsApp이 메시지의 값을 거부함

요청에 WhatsApp이 지원하지 않거나 철자가 잘못된 필드가 하나 이상 포함되어 메시지가 발송되지 않았습니다.

자세한 설명 및 해결 방법 →
130403 조치 필요

전달되지 않음 — 이 수신자를 차단한 상태입니다

이 수신자가 내 차단 목록에 있어 메시지가 전달되지 않았습니다. 차단이 유지되는 동안에는 무엇을 보내도 도달하지 않습니다.

자세한 설명 및 해결 방법 →
130472 일시적

실험의 일환으로 메시지가 발송되지 않음

WhatsApp이 실험의 일환으로 이 메시지를 발송하지 않았습니다. 이 코드에 대한 Meta의 설명에는 해당 실험이나 메시지에 관한 추가 정보가...

자세한 설명 및 해결 방법 →
131000 일시적

알 수 없는 오류로 메시지 발송 중단

발송 중 예기치 않은 WhatsApp 오류가 발생해 메시지가 나가지 않았습니다. WhatsApp은 실패에 대한 구체적인 이유를 제공하지 않았습니다.

자세한 설명 및 해결 방법 →
131005 조치 필요

권한이 부여되지 않았거나 삭제됨

이 작업에 필요한 권한이 처음부터 부여되지 않았거나 이후 삭제되어 작업이 완료되지 않았습니다. Meta가 안내하는 해결 방법은 내 계정...

자세한 설명 및 해결 방법 →
131008 조치 필요

메시지에 필수 필드가 누락됨

메시지에 필수 필드가 누락되어 WhatsApp이 발송을 거부했습니다. 모든 필수 필드를 채우기 전에는 메시지를 보낼 수 없습니다.

자세한 설명 및 해결 방법 →
131009 조치 필요

메시지 필드의 값이 잘못됨

메시지에 포함된 값 중 하나 이상이 유효하지 않아 WhatsApp이 발송하지 않았습니다. 이 코드에 대한 Meta의 안내에는 WhatsApp Business...

자세한 설명 및 해결 방법 →
131016 일시적

WhatsApp 서비스를 일시적으로 사용할 수 없음

WhatsApp 서비스 중 하나를 일시적으로 사용할 수 없어 메시지가 발송되지 않았습니다.

자세한 설명 및 해결 방법 →
131021 조치 필요

발신 번호와 수신 번호가 동일함

발신자 본인의 번호로는 메시지를 보낼 수 없습니다. 사용한 수신 번호가 내 비즈니스 번호와 같으며, WhatsApp은 이를 허용하지 않습니다.

자세한 설명 및 해결 방법 →
131026 조치 필요

이 번호로 메시지를 전달할 수 없음

전달 불가 — 해당 번호가 WhatsApp을 사용하지 않거나 이 메시지를 받을 수 없습니다. WhatsApp 번호가 아니거나, 번호 소유자가 새 서비스...

자세한 설명 및 해결 방법 →
131037 조치 필요

비즈니스 번호에 승인된 표시 이름이 없음

발송에 사용된 비즈니스 전화번호에 승인된 표시 이름이 없어 메시지가 발송되지 않았습니다. 표시 이름이 승인될 때까지 WhatsApp은 해당...

자세한 설명 및 해결 방법 →
131042 조치 필요

결제 수단 문제로 발송이 차단됨

결제 수단과 관련된 오류가 발생해 발송이 중단되었습니다. WhatsApp Business 계정의 결제 설정이 올바르게 될 때까지 발송이 차단됩니다.

자세한 설명 및 해결 방법 →
131045 조치 필요

전화번호 등록 오류

전화번호 등록 오류로 메시지 발송에 실패했습니다. Meta가 안내하는 해결 방법은 다시 시도하기 전에 전화번호를 등록하는 것입니다.

자세한 설명 및 해결 방법 →
131047 조치 필요

24시간 응답 창이 닫힘

수신자가 마지막으로 내 번호에 답장한 지 24시간이 넘어 일반 메시지가 허용되지 않았습니다. 이 고객에게 연락하려면 템플릿 메시지를 사...

자세한 설명 및 해결 방법 →
131049 일시적

건전한 참여 환경 유지를 위해 메시지가 전달되지 않음

WhatsApp이 건전한 생태계 참여를 유지하기 위해 이 메시지를 전달하지 않았습니다. Meta의 안내에 따르면 수신자별 마케팅 템플릿 메시지...

자세한 설명 및 해결 방법 →
131050 영구적

수신자가 마케팅 메시지 수신을 거부함

이 수신자가 내 비즈니스의 WhatsApp 마케팅 메시지를 더 이상 받지 않기로 선택해 메시지가 전달되지 않았습니다. Meta는 이 수신자에게...

자세한 설명 및 해결 방법 →
131051 조치 필요

지원되지 않는 메시지 유형

지원되지 않는 메시지 유형이어서 WhatsApp이 발송하지 않았습니다. 사용한 유형이 WhatsApp에서 허용하는 메시지 유형에 포함되지 않습니...

자세한 설명 및 해결 방법 →
131052 영구적

고객이 보낸 미디어를 다운로드할 수 없음

고객이 WhatsApp으로 이미지나 파일을 보냈지만 해당 미디어를 다운로드할 수 없어 파일을 확인할 수 없습니다.

자세한 설명 및 해결 방법 →
131053 조치 필요

메시지 미디어를 업로드할 수 없음

메시지에 사용된 미디어를 업로드할 수 없어 메시지가 발송되지 않았습니다. Meta는 지원되지 않는 미디어 유형을 가능한 원인 중 하나로...

자세한 설명 및 해결 방법 →
131057 일시적

WhatsApp Business 계정이 유지보수 모드 상태임

WhatsApp Business 계정이 유지보수 모드 상태여서 메시지가 발송되지 않았습니다. Meta가 밝힌 가능한 원인 중 하나는 계정의 처리량 업그...

자세한 설명 및 해결 방법 →
131063 조치 필요

Cloud API에서 마케팅 템플릿이 비활성화됨

보내려던 템플릿은 Marketing으로 분류되어 있는데, 현재 Cloud API에서 이 계정의 마케팅 템플릿이 꺼져 있습니다. WhatsApp Business 계...

자세한 설명 및 해결 방법 →
132000 조치 필요

템플릿 변수 개수가 템플릿과 일치하지 않음

보낸 템플릿 변수의 개수가 승인된 템플릿과 일치하지 않습니다. 템플릿에 정의된 모든 변수에는 정확히 하나의 값이 들어가야 하는데, 이...

자세한 설명 및 해결 방법 →
132001 조치 필요

해당 언어의 템플릿이 없거나 승인되지 않음

보낸 언어로 된 템플릿이 존재하지 않거나 아직 승인되지 않았습니다. WhatsApp은 정확히 그 이름과 언어로 존재하고 검토를 통과한 템플릿...

자세한 설명 및 해결 방법 →
132005 조치 필요

번역된 템플릿 텍스트가 너무 김

이 템플릿의 번역된 텍스트가 너무 길어 메시지가 발송되지 않았습니다. WhatsApp은 번역된 텍스트가 허용 길이를 넘는 템플릿을 받아들이...

자세한 설명 및 해결 방법 →
132007 조치 필요

템플릿 콘텐츠가 WhatsApp 정책을 위반함

템플릿이 WhatsApp 콘텐츠 정책을 위반해 WhatsApp이 발송하지 않습니다. 템플릿은 비즈니스가 보낼 수 있는 내용에 관한 WhatsApp 규정에...

자세한 설명 및 해결 방법 →
132012 조치 필요

템플릿 변수 형식이 올바르지 않음

템플릿 변수의 형식이 템플릿에서 요구하는 형식과 일치하지 않습니다. 보낸 값이 승인된 템플릿에 정의된 형식을 따르지 않아 WhatsApp이...

자세한 설명 및 해결 방법 →
132015 조치 필요

품질 저하로 템플릿이 일시 중지됨

템플릿이 일시 중지되어 지금은 사용할 수 없습니다. 품질이 너무 낮아져 WhatsApp이 일시 중지했으며, 중지 상태가 유지되는 동안에는 이...

자세한 설명 및 해결 방법 →
132016 영구적

반복된 일시 중지로 템플릿이 영구 비활성화됨

템플릿이 비활성화되었습니다. 낮은 품질로 너무 여러 번 일시 중지되어 WhatsApp이 영구적으로 비활성화했으며, 다시는 사용할 수 없습니...

자세한 설명 및 해결 방법 →
132068 조치 필요

메시지 발송 안 됨 — 플로우가 차단됨

메시지에 연결된 플로우가 차단 상태여서 메시지가 발송되지 않았습니다. 플로우가 차단된 동안에는 해당 플로우를 사용하는 메시지를 What...

자세한 설명 및 해결 방법 →
132069 조치 필요

플로우 발송 제한 — 이번 시간에 10건 발송됨

이 메시지에 연결된 플로우가 발송 제한 상태이며, 지난 한 시간 동안 해당 플로우를 사용한 메시지가 이미 10건 발송되어 이 메시지는 발...

자세한 설명 및 해결 방법 →
133000 조치 필요

이전 등록 해제 실패로 등록이 차단됨

이전에 번호 등록 해제를 시도했다가 실패해 번호를 등록할 수 없었습니다. 번호 등록 해제가 정상적으로 완료될 때까지는 다시 등록할 수...

자세한 설명 및 해결 방법 →
133004 일시적

WhatsApp 서버를 일시적으로 사용할 수 없음

해당 시점에 WhatsApp 서버를 일시적으로 사용할 수 없어 요청이 처리되지 않았습니다. 내 계정이나 메시지가 아닌 WhatsApp 측 문제입니다...

자세한 설명 및 해결 방법 →
133005 조치 필요

이중 인증 PIN이 올바르지 않음

제출한 이중 인증 PIN이 올바르지 않아 요청이 거부되었습니다. 이 번호에는 이중 인증이 켜져 있어 올바른 PIN이 있어야만 요청이 처리됩...

자세한 설명 및 해결 방법 →
133006 조치 필요

등록 전에 전화번호 인증이 필요함

번호가 아직 인증되지 않아 등록되지 않았습니다. WhatsApp은 전화번호를 등록하기 전에 인증을 요구하므로 등록이 거부되었습니다.

자세한 설명 및 해결 방법 →
133008 일시적

이중 인증 PIN 시도 횟수 초과

이 번호에 대해 잘못된 이중 인증 PIN이 너무 많이 입력되어, WhatsApp이 일정 시간 동안 추가 시도를 거부하고 있습니다. 대기해야 하는...

자세한 설명 및 해결 방법 →
133009 일시적

이중 인증 PIN을 너무 빠르게 입력함

이중 인증 PIN이 너무 빠르게 입력되어 WhatsApp이 받아들이지 않았습니다. 다시 시도하기 전에 확인할 사항은 오류 세부 정보에 나와 있습...

자세한 설명 및 해결 방법 →
133010 조치 필요

번호가 WhatsApp Business Platform에 등록되지 않음

이 전화번호가 WhatsApp Business Platform에 등록되어 있지 않아 발송이 처리되지 않았습니다. 발송에 사용하려면 먼저 번호를 등록해야...

자세한 설명 및 해결 방법 →
133015 일시적

최근 삭제된 번호 — 삭제 처리가 아직 끝나지 않음

등록하려는 번호가 최근에 삭제되었고, 삭제 처리가 아직 완료되지 않았습니다. 삭제가 끝날 때까지는 다시 등록할 수 없습니다.

자세한 설명 및 해결 방법 →
134011 조치 필요

WhatsApp Payments 약관에 아직 동의하지 않음

이 WhatsApp Business 계정의 WhatsApp Payments 서비스 약관 동의가 아직 대기 중이어서 메시지 발송에 실패했습니다. 오류 메시지에 약관...

자세한 설명 및 해결 방법 →
135000 일시적

알 수 없는 이유로 메시지가 거부됨

보낸 내용의 세부 정보에 알 수 없는 문제가 있어 WhatsApp이 메시지를 거부했으며, Meta는 어떤 항목이 원인인지 밝히지 않습니다.

자세한 설명 및 해결 방법 →

Marketing Messages API 오류

6
131055 조치 필요

이 채널에서는 마케팅 템플릿만 보낼 수 있음

이 발송 채널은 마케팅 템플릿 메시지만 지원하므로 메시지가 전달되지 않았습니다. 템플릿이 아닌 메시지를 보냈거나, 마케팅이 아닌 인증...

자세한 설명 및 해결 방법 →
132018 조치 필요

템플릿 값이 거부됨 — 메시지가 전송되지 않음

WhatsApp이 발송 전에 템플릿을 확인한 결과, 템플릿에 입력된 값에서 문제가 발견되었습니다. 입력하신 템플릿이 올바르게 구성되지 않아...

자세한 설명 및 해결 방법 →
134100 조치 필요

이 채널에서는 유틸리티·인증 템플릿을 사용할 수 없음

보내려던 템플릿이 유틸리티 또는 인증으로 분류되어 있습니다. 이 채널에서는 마케팅으로 분류된 템플릿만 보낼 수 있어 메시지가 거부되...

자세한 설명 및 해결 방법 →
134101 일시적

템플릿 동기화 중 — 잠시 후 다시 시도하세요

사용한 템플릿이 최근에 만들어져 아직 동기화가 끝나지 않았습니다. 동기화는 최대 10분이 걸릴 수 있으며, 완료되기 전에는 해당 템플릿...

자세한 설명 및 해결 방법 →
134102 조치 필요

템플릿을 사용할 수 없음 — 자격 요건을 확인하세요

보내려던 템플릿을 사용할 수 없습니다. 광고와의 동기화가 완료되지 않았거나, 비즈니스가 아직 이런 유형의 마케팅 메시지를 보낼 자격을...

자세한 설명 및 해결 방법 →
1752041 영구적

온보딩이 이미 요청됨 — 추가 조치 불필요

이 비즈니스에 대한 온보딩 요청이 이미 제출되었습니다. 온보딩 요청은 비즈니스 고객당 한 번으로 제한되며, 가장 먼저 요청을 제출한 파...

자세한 설명 및 해결 방법 →

자주 묻는 질문

WhatsApp 오류 코드는 무슨 뜻인가요?
메시지가 전송되지 않았거나 작업이 실패한 이유를 알려 주는 번호로, Meta의 WhatsApp Cloud API가 반환합니다. 코드마다 의미와 해결 방법이 다르니, 이 페이지 목록에서 해당 코드를 선택해 설명과 해결 단계를 확인하세요.
LetsBot에서 오류 코드는 어디서 확인하나요?
캠페인 보고서나 대화 기록에서 전달되지 않은 메시지 옆에 표시되며, 전송이 실패한 이유에 대한 짧은 설명도 함께 나타납니다.
오류가 나면 무조건 계정에 문제가 있는 건가요?
아닙니다. 일부 코드는 일시적이라 아무 조치 없이 다시 시도하면 성공하고, 일부는 계정이 아닌 수신자와 관련된 것이며, 일부는 결제 수단 업데이트나 템플릿 수정 같은 조치가 필요합니다. 각 코드 페이지에서 어떤 경우인지 알려 드립니다.
이 목록은 완전하고 최신인가요?
Meta의 공식 WhatsApp Cloud API 문서에 공개된 오류 코드를 다루며, 마지막으로 확인한 날짜는 페이지 상단에 표시됩니다. Meta가 새 코드를 추가하기도 하므로 목록을 주기적으로 검토합니다.

목록에 없는 코드이거나 해결 방법이 효과가 없나요?

코드와 스크린샷을 보내 주시면 함께 확인해 드립니다. LetsBot으로 보내는 경우 메시지 옆에 코드와 실패 이유가 표시됩니다.