한국어로 번역이 아직 완료되지 않았습니다.
온프레미스 API에 대한 지원을 중단합니다. 자세한 내용과 차세대 클라우드 API로 마이그레이션하는 방법을 알아보려면 온프레미스 API 지원 중단 문서를 참조하세요.
WhatsApp Business API 클라이언트 오류 코드
| 오류 코드 | 설명 |
|---|---|
| 발신자로부터 미디어를 다운로드하지 못했습니다. |
| 결제 수단과 관련된 오류가 하나 이상 있어서 메시지 전송에 실패했습니다.
WhatsApp 관리자에서 결제 설정을 확인하고 다시 시도하세요. |
| 메시지의 대기 상태가 너무 오랫동안(즉, 1일 넘게) 지속되어 전송에 실패했습니다. WhatsApp Business API 클라이언트가 1일 넘게 중단되고 다시 시작될 경우에 발생할 수 있는 오류입니다. 메시지를 다시 보내세요. |
| TTL(잔여 수명) 기간에 메시지를 전송하지 못했습니다. |
|
|
| 인증서와 관련된 오류가 있어서 메시지 전송에 실패했습니다. WhatsApp 관리자에서 새 인증서를 다운로드하고 다시 등록하세요. |
| 인증서와 관련된 오류가 있어서 메시지 전송에 실패했습니다. WhatsApp 관리자에서 새 인증서를 다운로드하고 다시 등록하세요. |
| 이 오류는 비즈니스 클라이언트의 인증서가 클라이언트의 ID 키를 사용해 적절히 서명되지 않은 경우 메시지를 전송할 때 발생합니다. 클라이언트가 새 ID 키로 다시 등록했으나 전체적인 인증서 생성 플로를 거치지 않은 것일 가능성이 큽니다. |
| 고객이 마지막으로 이 번호에 회신한 지 24시간 이상 지났으므로 메시지 전송에 실패했습니다. 메시지 템플릿을 사용하여 응답하세요. |
| 이 전화번호에서 전송 가능한 메시지 수에 제한이 있으므로 메시지 전송에 실패했습니다. 이전에 메시지가 너무 많이 차단되었거나 스팸으로 플래그되었기 때문일 수 있습니다. WhatsApp 관리자에서 품질 상태를 확인하세요. 자세한 내용은 품질 기반 사용 제한 문서를 참조하세요. |
| 이 사용자의 전화번호는 실험에 포함되어 있기 때문에 메시지 전송에 실패했습니다. 이 사용자에 대한 메시지 전송을 건너뛰세요. |
| 이 전화번호를 사용하는 사용자가 변경되었을 수 있어 메시지 전송에 실패했습니다. |
| 알 수 없는 오류로 인해 메시지 전송에 실패했습니다. 나중에 다시 시도하세요. |
| 현재 캡션이 포함된 문서 메시지를 지원하지 않습니다. |
| |
| 메시지 길이가 4,096자를 초과합니다. |
| 올바른 수신자 유형:
|
| 미디어 업로드 요청에 대한 UUID 충돌이 발생했거나 이미 존재하는 UUID를 포함한 미디어일 수 있습니다. |
|
|
| 파일 또는 리소스를 찾을 수 없습니다. |
| 수신자가 허용 리스트에 없습니다. |
| 필수 매개변수가 누락되었습니다. 리스트 메시지를 전송하려고 시도할 때 단일 제품 메시지나 다중 제품 메시지를 전송하려고 시도할 때 |
| 매개변수에 입력한 값이 잘못된 유형이거나 다른 문제가 있습니다. 리스트 메시지를 전송하려고 시도할 때 각 행의 ID가 고유한지 확인하세요. 단일 제품 메시지를 전송하려고 시도할 때 잘못된 다중 제품 메시지를 전송하려고 시도할 때 섹션별로 |
| 필요하지 않은 매개변수가 포함되어 있습니다. |
| |
| |
|
|
| 클라이언트 측 사용 제한에 도달했습니다. |
| 시스템이 과부하 상태일 경우 시스템 부하를 복구하도록 이 오류가 반환됩니다. |
| 마스터 전용 요청(예: 설정, 설정 가져오기, 가져오기, 내보내기, 코드 요청, 등록 등)을 기본 마스터가 아닌 노드로 전송하면 이 오류가 발생합니다. WhatsApp Business API 클라이언트가 올바르게 설정되지 않았거나 내부 오류가 있을 경우 이 오류가 발생할 수 있습니다. 요청을 다시 시도하면 이 오류가 해결됩니다. 오류가 해결되지 않을 경우 고객 지원팀에 문의하세요. |
| 샤드 소유주가 아니거나 샤드 소유주가 되는 과정에 있는 Coreapp 노드에 요청을 전송하면 이 오류가 발생합니다. 다중 연결 설정에서 샤드 장애 조치를 수행하고 있는 경우 이 오류가 발생할 수 있습니다. 대부분의 경우 요청을 다시 시도하면 이 오류가 해결됩니다. 오류가 해결되지 않을 경우 고객 지원팀에 문의하세요. |
| 자신에게 메시지를 보내면 이 오류가 발생합니다. |
| REST API Webhooks 형식을 구성하지 않은 경우 이 오류가 발생합니다. |
| |
| 비밀번호를 변경해야 합니다. |
| 요청이 잘못되었습니다. |
| 메시지를 전달할 수 없습니다. 자세한 내용은 '왜 전달률이 100%가 아닌가요?' FAQ를 참조하세요. |
| 변경되었을 가능성이 있는 WhatsApp 사용자에게 메시지를 전송했습니다. |
| 무결성 정책 위반으로 인해 계정에서 메시지 전송이 잠겼습니다. 자세한 내용은 WhatsApp Business 플랫폼 정책 시행을 참조하세요. |
| 제공된 매개변수 개수가 예상 매개변수 개수와 일치하지 않습니다. |
| 템플릿이 비활성 상태이거나 언어와 로캘에 대한 템플릿이 존재하지 않습니다. |
| 수신자가 템플릿을 다운로드하지 못했습니다. |
| 특정 언어 및 로캘에 대한 템플릿이 존재하지 않습니다. |
| 매개변수 길이가 너무 깁니다. |
| 번역된 텍스트가 너무 깁니다. |
| 공백 정책을 위반했습니다. |
| 문자 형식 정책을 위반했습니다. |
| 사용된 미디어 형식을 지원하지 않습니다. |
| 템플릿의 필수 구성 요소가 누락되었습니다. |
| 버튼 구성 요소의 URL이 잘못되었습니다. |
| 버튼 구성 요소의 전화번호가 잘못되었습니다. |
| 매개변수 형식이 생성된 템플릿의 형식과 일치하지 않습니다. |
| 수신자 측에서 버튼을 지원하지 않습니다. |
| 템플릿 메시지 언어 팩이 아직 다운로드되지 않은 상태인 경우 이 오류가 발생합니다. |
| 메시지 요청에 최솟값 미만이거나 최댓값을 초과하는 섹션 개수가 포함되었습니다. 자세한 내용은
|
| 행 개수가 잘못되었습니다. 리스트 메시지의 경우 |
| 문자 형식 정책을 위반했습니다. |
| 섹션 개체에 제품이 없거나 총 제품 개수가 최대 허용 개수를 초과했습니다. |
| 제공한 카탈로그 ID가 존재하지 않거나 WhatsApp Business 계정(WABA)에 속하지 않습니다. |
| 제공한 카탈로그 ID가 메시지 전송에 사용하려는 전화번호와 연결되어 있지 않습니다. |
| 요청에서 제공한 일부 제품을 카탈로그에서 찾을 수 없습니다. |
| 제공한 카탈로그에서 제품을 찾을 수 없습니다. |
| 인도에서의 비즈니스에만 적용됩니다. 비즈니스가 이커머스 규정 준수 정보를 누락하여 불완전한 상태로 단일 제품 메시지를 전송한 경우 이 오류가 반환됩니다. |
| 인도에서의 비즈니스에만 적용됩니다. 비즈니스가 이커머스 규정 준수 정보를 누락하여 불완전한 상태로 다중 제품 메시지를 전송한 경우 이 오류가 반환됩니다. |
| 인도에서의 비즈니스에만 적용됩니다. 비즈니스가 잘못된 제품과 규정 준수 정보가 누락된 제품이 섞인 다중 제품 메시지를 전송한 경우 이 오류가 반환됩니다. |
|
|
| 인도에서의 비즈니스에만 적용됩니다. 비즈니스가 규정 준수 정보를 제공하지 않은 경우 이 오류가 반환됩니다. 비즈니스 규정 준수 엔드포인트를 참조하세요. |
| 템플릿 상태가 |
| 템플릿 상태가 |
| 템플릿 상태가 |
| 플로가 차단된 상태입니다. |
| 플로가 제한된 상태이고 지난 1시간 동안 이미 이 플로를 사용하는 메시지 10개가 전송되었습니다. |
인도 비즈니스에 적용되는 커머스 관리자 오류 코드는 비즈니스 지원 센터를 참조하세요.
HTTP 상태 코드
이 HTTP 상태 코드는 WhatsApp Business API 클라이언트에서 사용할 수 있습니다.
| HTTP 코드 | 설명 |
|---|---|
| 성공 |
| 성공(OK) |
| 성공적으로 생성됨(POST 요청) |
| 발견함 |
| 클라이언트 오류 |
| 잘못된 요청 |
| 권한 없음 |
| 금지됨 |
| 찾을 수 없음 |
| 허용되지 않는 메서드 |
| 필수 조건 실패 |
| 메시지에 사용 제한이 적용됨 |
| 요청이 너무 많음 |
| 서버 오류 |
| 내부 서버 오류 |
| 시간 초과 |