문제 해결 및 FAQ
이 페이지에서는 WhatsApp, Instagram, Facebook 메시징 채널의 문제를 빠르게 진단하고 해결할 수 있습니다. 전체 오류 코드 목록과 각 코드의 의미, 권장 조치를 확인할 수 있으며, 자주 묻는 질문 섹션에서 흔한 문제를 해결하고 메시징 설정을 최적화하는 데 도움을 받을 수 있습니다.
자주 묻는 질문
MonoChat과 어떤 커뮤니케이션 채널을 연결할 수 있나요?
MonoChat은 WhatsApp, Instagram, Facebook Messenger, Telegram, 라이브 채팅, SIP 채널 등 다양한 커뮤니케이션 채널을 지원합니다. 따라서 모든 대화를 하나의 통합 받은 편지함에서 관리할 수 있습니다.
얼마나 빨리 시작할 수 있나요?
몇 분 안에 시작할 수 있습니다. 가입하고, 원하는 채널을 연결하고, 팀을 초대한 다음, MonoChat의 직관적인 설정 과정으로 워크플로를 만들면 됩니다. 긴 온보딩 과정은 필요하지 않습니다.
AI 어시스턴트를 만들려면 기술 지식이 필요한가요?
아니요, 기술 지식은 전혀 필요하지 않습니다. MonoChat은 코딩 없이 단 몇 분 만에 AI 어시스턴트를 만들고 맞춤 설정할 수 있는 간단하고 사용자 친화적인 인터페이스를 제공합니다. 직관적인 설정으로 어시스턴트의 성격, 어조, 업무를 쉽게 조정할 수 있습니다. 어시스턴트가 무엇을 해야 하는지에만 집중할 수 있도록 모든 것이 설계되어 있으며, 기술적인 부분은 MonoChat이 처리합니다.
MonoChat에서 제 데이터는 안전한가요?
네, MonoChat은 데이터 보안을 매우 중요하게 생각합니다. 모든 데이터는 전송 중과 저장 시 모두 암호화됩니다. 업계 표준 보안 관행을 따라 고객의 정보를 보호합니다.
청구는 어떻게 이루어지나요?
청구는 간단하고 유연합니다. 월간 또는 연간 구독 요금제 중에서 선택할 수 있으며, 필요하면 추가 패키지를 더할 수 있습니다. 선택한 요금제와 사용량에 따라 청구서가 발행됩니다.
어떤 결제 수단을 사용할 수 있나요?
MonoChat 플랫폼에서 신용카드 또는 체크카드로 바로 간편하게 결제할 수 있습니다. 모든 결제 옵션은 계정의 청구 섹션에서 이용할 수 있어 결제 수단을 쉽게 관리하고 업데이트할 수 있습니다.
구독을 변경하거나 취소할 수 있나요?
네, 계정에서 직접 언제든지 구독을 업그레이드, 다운그레이드 또는 취소할 수 있습니다. 변경 사항은 요금제에 따라 즉시 또는 다음 청구 주기에 적용됩니다.
무료 체험이 있나요?
네, MonoChat은 유료 요금제를 결정하기 전에 플랫폼을 체험해 볼 수 있는 무료 체험을 제공합니다. 체험에는 채널 1개, 사용자 1명, 최대 1,000건의 메시지가 포함됩니다.
문제가 생기거나 설정, 연동에 도움이 필요하면 어디서 도움을 받을 수 있나요?
MonoChat은 필요에 맞는 다양한 지원 패키지를 제공하며, WhatsApp 지원 채널은 모든 사용자가 이용할 수 있습니다. 설정 중 안내가 필요하든, 연동에 도움이 필요하든, 문제 해결이 필요하든 저희 팀이 도와드립니다.
앱을 설치한 후 어시스턴트가 답변하지 않습니다. 왜 그런가요?
고객에게 응답하는 앱은 봇 플로우가 꺼진 상태로 설치되므로, 아직 설정되지 않은 어시스턴트가 고객과 대화하는 일은 없습니다. 앱의 설정 단계(시작하기 패널 또는 앱 자체 화면)를 마친 다음, 앱 화면에서 어시스턴트를 켜거나 설정 › 자동화 › 플로우에서 해당 플로우를 활성화하세요. 이후 앱을 업데이트해도 선택한 켜짐/꺼짐 상태는 유지됩니다. MonoStore를 참고하세요.
쿠폰을 사용할 수 없습니다.
오류 메시지에 사유가 표시됩니다. 쿠폰은 한 번만 사용할 수 있고, 만료될 수 있으며, 특정 워크스페이스로 제한될 수 있습니다. 예를 들어 최근 며칠 안에 만들어진 워크스페이스만, 최근 몇 달 안에 최소 금액을 충전한 워크스페이스만, 또는 최근에 다른 쿠폰을 사용하지 않은 워크스페이스만 사용할 수 있습니다. 조건을 충족하지 못한 경우 쿠폰은 소진되지 않으므로 조건을 충족한 후 다시 시도할 수 있습니다. 워크스페이스에서 청구 권한도 있어야 합니다. 쿠폰을 참고하세요.
이전 WhatsApp 대화는 어디에 있나요?
채널을 연결하면 해당 채널의 과거 메시지가 이전 대화로 들어옵니다. 오래된 메시지가 한꺼번에 쏟아져 새 메시지가 묻히지 않도록 이 대화는 대화 목록에서 제외됩니다. 이전 대화가 있으면 목록 상단의 회색 바에 이전 대화가 있습니다라고 표시됩니다. 표시를 클릭하고 확인하면 목록이 해당 대화만 보이도록 필터링되며, X 버튼을 누르면 페이지를 새로고침할 때까지 바가 숨겨집니다.
인터페이스 언어가 잘못 표시됩니다.
MonoChat은 브라우저의 언어로 시작합니다. 언어를 변경하려면 탐색 바 하단의 계정 버튼을 열고 기본 언어에서 언어를 선택한 뒤 저장하세요. 로그인 페이지에서는 하단의 언어 선택기를 사용합니다. 선택한 언어는 브라우저별로 기억됩니다. 워크스페이스에 관한 이메일(청구, 주간 요약)은 설정 › CRM › 언어에서 지정한 워크스페이스 기본 언어로 발송됩니다. 인터페이스 언어를 참고하세요.
결제할 때 요금제 가격보다 적은 금액을 결제하라고 나오는 이유는 무엇인가요?
요금제를 변경하거나 패키지를 구매할 때 잔액이 부족하면 MonoChat은 가격과 잔액의 차액만 청구합니다. 잔액이 마이너스라면 그 금액이 더해집니다. 잔액으로 가격을 충당할 수 있다면 결제 창이 아예 열리지 않습니다. 요금제 또는 패키지 직접 결제를 참고하세요.
시작하기 패널이 사라졌어요.
시작하기 탭은 모든 단계를 마칠 때까지 남은 단계 수와 함께 탐색 바에 표시되며, 모두 완료하면 저절로 사라집니다. 숨기기는 패널이 자동으로 열리는 것만 중지합니다. 탐색 바 투어를 다시 보려면 시작하기를 열고 둘러보기를 클릭하세요. 시작하기 패널을 참고하세요.
오류 코드 – WhatsApp, Instagram, Facebook
각 메시징 채널에서 가장 흔히 발생하는 오류 코드와 그 설명, 권장 조치는 다음과 같습니다.
WhatsApp (Cloud API) 오류 코드
이 오류 코드는 WhatsApp Business API에서 반환됩니다. 이 목록을 사용해 WhatsApp 메시징에 영향을 주는 전달 문제, 설정 문제, 속도 제한, 권한 관련 오류를 파악하세요.
| 오류 코드 | 세부 정보 | 가능한 원인과 해결 방법 |
|---|---|---|
| 368 - 정책 위반으로 일시적으로 차단됨 | 정책 위반과 해결 방법은 Policy Enforcement 문서를 참고하세요. 플랫폼 정책을 위반하여 제한되었거나 비활성화되었습니다. | 페이로드 형식과 필수 필드를 확인하세요. |
| 130497 - 비즈니스 계정이 이 국가의 사용자에게 메시지를 보내는 것이 제한되어 있습니다. | WhatsApp Business 계정이 특정 국가의 사용자에게 메시지를 보내는 것이 제한되어 있습니다. | 비즈니스 카테고리에서 메시지를 보낼 수 있는 국가는 WhatsApp Business Messaging Policy를 참고하세요. |
| 2388019 - 메시지 템플릿 한도 초과 | 이 WhatsApp 비즈니스 계정에서 보유할 수 있는 메시지 템플릿의 최대 개수를 초과했습니다. | WhatsApp Business 계정은 메시지 템플릿을 최대 250개까지 가질 수 있습니다. Template limits를 참고하세요. |
| 1 - API 알 수 없음 | 잘못된 요청이거나 서버 오류일 수 있습니다. | WhatsApp Business Platform Status 페이지에서 API 상태 정보를 확인하세요. 서버 장애가 없다면 엔드포인트 레퍼런스를 확인하고 요청이 올바른 형식이며 모든 엔드포인트 요구 사항을 충족하는지 확인하세요. |
| 2 - API 서비스 | 다운타임 또는 과부하로 인한 일시적 문제입니다. | 다시 시도하기 전에 WhatsApp Business Platform Status 페이지에서 API 상태 정보를 확인하세요. |
| 33 - 매개변수 값이 유효하지 않음 | 비즈니스 전화번호가 삭제되었습니다. | 비즈니스 전화번호가 올바른지 확인하세요. |
| 100 - 잘못된 매개변수 | 요청에 지원되지 않거나 철자가 잘못된 매개변수가 하나 이상 포함되어 있습니다. | 엔드포인트 레퍼런스에서 지원되는 매개변수와 올바른 철자를 확인하세요. |
| 130472 - 사용자 번호가 실험에 포함됨 | 실험의 일부로 메시지가 전송되지 않았습니다. | Marketing Message Experiment를 참고하세요. |
| 131000 - 문제가 발생했습니다 | 알 수 없는 오류로 메시지 전송에 실패했습니다. | 다시 시도하세요. 오류가 계속되면 Direct Support 티켓을 여세요. |
| 131005 - 접근 거부됨 | 권한이 부여되지 않았거나 삭제되었습니다. | 액세스 토큰 디버거를 사용해 앱에 엔드포인트에 필요한 권한이 부여되었는지 확인하세요. Authentication and authorization errors를 참고하세요. |
| 131008 - 필수 매개변수가 없음 | 요청에 필수 매개변수가 없습니다. | 엔드포인트 레퍼런스에서 어떤 매개변수가 필수인지 확인하세요. |
| 131009 - 매개변수 값이 유효하지 않음 | 하나 이상의 매개변수 값이 유효하지 않습니다. | 엔드포인트 레퍼런스에서 각 매개변수에 지원되는 값을 확인하고, WhatsApp Business 계정에 전화번호를 추가하는 방법은 Phone Numbers를 참고하세요. |
| 131016 - 서비스를 사용할 수 없음 | 서비스를 일시적으로 사용할 수 없습니다. | 다시 시도하기 전에 WhatsApp Business Platform Status 페이지에서 API 상태 정보를 확인하세요. |
| 131021 - 수신자가 발신자일 수 없음 | 발신자와 수신자의 전화번호가 같습니다. | 발신자와 다른 전화번호로 메시지를 보내세요. |
| 131026 - 메시지 전달 불가 | 메시지를 전달할 수 없습니다. 원인은 다음과 같을 수 있습니다. 수신자 전화번호가 WhatsApp 전화번호가 아닙니다. 수신자가 새 서비스 약관 및 개인정보 처리방침에 동의하지 않았습니다. 수신자가 오래된 WhatsApp 버전을 사용 중이며, 다음 WhatsApp 버전 이상을 사용해야 합니다. Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6 | WhatsApp이 아닌 다른 소통 수단으로 WhatsApp 사용자에게 다음을 요청하세요. 실제로 WhatsApp 비즈니스 전화번호로 메시지를 보낼 수 있는지 확인하기. 최신 서비스 약관에 동의했는지 확인하기(아직 동의하지 않았다면 설정 > 도움말 또는 설정 > 애플리케이션 정보에서 최신 약관/정책에 동의하라는 안내가 표시됩니다). 최신 버전의 WhatsApp 클라이언트로 업데이트하기. |
| 131037 - 메시지를 보내려면 WhatsApp에서 제공한 번호의 표시 이름 승인이 필요합니다. | 요청을 보내는 데 사용한 555 비즈니스 전화번호에 승인된 표시 이름이 없습니다. | 555 비즈니스 전화번호의 표시 이름을 변경하세요. How to change your WhatsApp Business display name 도움말 센터 문서도 참고하세요. |
| 131042 - 비즈니스 자격 결제 문제 | 결제 수단과 관련된 오류가 발생했습니다. | About Billing For Your WhatsApp Business Account를 참고하여 결제가 올바르게 설정되었는지 확인하세요. 흔한 문제: 결제 계정이 WhatsApp Business 계정에 연결되지 않음 / 신용 한도 초과 / 신용 한도(결제 계정)가 설정되지 않았거나 활성화되지 않음 / WhatsApp Business 계정이 삭제됨 / WhatsApp Business 계정이 정지됨 / 시간대가 설정되지 않음 / 통화가 설정되지 않음 / MessagingFor 요청(On Behalf Of)이 보류 중이거나 거부됨 |
| 131045 - 잘못된 인증서 | 전화번호 등록 오류로 메시지 전송에 실패했습니다. | 다시 시도하기 전에 전화번호를 등록하세요. |
| 131047 - 재참여 메시지 | 수신자가 발신 번호에 마지막으로 답장한 후 24시간이 지났습니다. | 대신 수신자에게 템플릿 메시지를 보내세요. |
| 131049 - Meta가 전달하지 않기로 결정했습니다. | 건강한 생태계 참여를 유지하기 위해 이 메시지가 전달되지 않았습니다. | 이 오류 코드를 받았고 한도 때문인 것으로 의심되면 템플릿 메시지를 다시 보내기 전에 최소 24시간을 기다리세요. 한도가 적용되는 기간은 서로 다를 수 있으므로 그 전에 다시 보내면 또 오류 응답만 받게 됩니다. |
| 131050 - 사용자가 마케팅 메시지 수신을 중단했습니다. | 메시지를 전달할 수 없습니다. 이 수신자는 WhatsApp에서 비즈니스의 마케팅 메시지를 더 이상 받지 않기로 했습니다. | 메시지가 수신되지 않으므로 이 사용자에게 다시 보내지 마세요. WhatsApp 사용자가 비즈니스의 마케팅 템플릿 메시지 수신을 중단하거나 재개할 때마다 알림을 받으려면 user_preferences 웹훅을 구독하세요. |
| 131051 - 지원되지 않는 메시지 유형 | 지원되지 않는 메시지 유형입니다. | 지원되는 메시지 유형은 Messages를 참고한 후 지원되는 메시지 유형으로 다시 시도하세요. |
| 131052 - 미디어 다운로드 오류 | 사용자가 보낸 미디어를 다운로드할 수 없습니다. | WhatsApp 사용자의 메시지에 포함된 미디어를 다운로드할 수 없었습니다. 자세한 내용은 이 메시지를 수신할 때 트리거된 messages 웹훅의 error.error_data.details 값을 참고하세요. WhatsApp 사용자에게 WhatsApp이 아닌 다른 방법으로 미디어 파일을 보내 달라고 요청하세요. |
| 131057 - 계정이 유지 보수 모드임 | 비즈니스 계정이 유지 보수 모드입니다 | WhatsApp Business 계정이 유지 보수 모드입니다. 계정에서 처리량 업그레이드가 진행 중일 수 있습니다. |
| 132000 - 템플릿 매개변수 개수 불일치 | 요청에 포함된 변수 매개변수 값의 개수가 템플릿에 정의된 변수 매개변수의 개수와 일치하지 않았습니다. | 매개변수에 관한 내용은 Templates 문서를 참고하고, 요청에 템플릿에 필요한 모든 매개변수의 값이 포함되어 있는지 확인하세요. |
| 132001 - 템플릿이 존재하지 않음 | 지정한 언어로 된 템플릿이 없거나 템플릿이 승인되지 않았습니다. | 템플릿이 승인되었는지, 템플릿 이름과 언어 로캘이 올바른지 확인하세요. 템플릿에 대한 자세한 내용은 Templates 문서를 참고하세요. |
| 132005 - 템플릿 변환 텍스트가 너무 김 | 변환된 텍스트가 너무 깁니다. | WhatsApp Manager에서 템플릿이 번역되었는지 확인하세요. 템플릿 상태를 확인하는 방법은 Template quality 문서를 참고하세요. |
| 132007 - 템플릿 형식 문자 정책 위반 | 템플릿 내용이 WhatsApp 정책을 위반합니다. | 위반 가능성이 있는 이유는 Template review 문서를 참고하세요. |
| 132012 - 템플릿 매개변수 형식 불일치 | 변수 매개변수 값의 형식이 잘못되었습니다. | 요청에 포함된 변수 매개변수 값이 템플릿에 지정된 형식을 사용하지 않습니다. 템플릿 매개변수와 형식에 대한 자세한 내용은 Templates 문서를 참고하세요. |
| 132015 - 템플릿이 일시 중지됨 | 품질이 낮아 템플릿이 일시 중지되어 템플릿 메시지로 보낼 수 없습니다. | 템플릿을 수정하여 품질을 개선하고 승인된 후 다시 시도하세요. |
| 132016 - 템플릿이 비활성화됨 | 낮은 품질로 템플릿이 너무 여러 번 일시 중지되어 영구적으로 비활성화되었습니다. | 다른 내용으로 새 템플릿을 만드세요. |
| 132068 - Flow가 차단됨 | Flow가 차단된 상태입니다. | Flow를 수정하세요 |
| 132069 - Flow가 제한됨 | Flow가 제한된 상태이며 지난 1시간 동안 이 Flow를 사용한 메시지가 이미 10건 전송되었습니다. | Flow를 수정하세요 |
| 133000 - 등록 해제 미완료 | 이전 등록 해제 시도가 실패했습니다. | 등록하기 전에 번호를 다시 등록 해제하세요. |
| 133004 - 서버를 일시적으로 사용할 수 없음 | 서버를 일시적으로 사용할 수 없습니다. | 다시 시도하기 전에 WhatsApp Business Platform Status 페이지에서 API 상태 정보를 확인하고 응답 세부 정보 값을 확인하세요. |
| 133005 - 2단계 인증 PIN 불일치 | 2단계 인증 PIN이 올바르지 않습니다. | 요청에 포함된 2단계 인증 PIN이 올바른지 확인하세요. PIN을 재설정하려면 2단계 인증을 비활성화한 다음 새 PIN을 설정하세요. Two-step verification을 참고하세요. |
| 133006 - 전화번호 재인증 필요 | 등록하기 전에 전화번호를 인증해야 합니다. | 전화번호를 인증하고 등록하세요. |
| 133010 - 전화번호가 등록되지 않음 | WhatsApp Business Platform에 전화번호가 등록되어 있지 않습니다. | 다시 시도하기 전에 전화번호를 등록하세요. |
| 135000 - 일반 사용자 오류 | 요청 매개변수에 알 수 없는 오류가 있어 메시지 전송에 실패했습니다. | 엔드포인트 레퍼런스에서 올바른 구문으로 엔드포인트를 호출하고 있는지 확인하세요. 이 오류 코드가 계속 응답으로 오면 고객 지원팀에 문의하세요. |
Instagram Messaging API 오류 코드
이 오류는 Messenger Platform에서 발생합니다. 사용자 권한, 페이지 설정, API 제한, 속도 제한, 메시지 전달 제한과 관련된 문제를 진단하는 데 도움이 됩니다.
| 오류 코드 | 사용자 메시지 | 권장 해결 방법 |
|---|---|---|
| 2207003 | 미디어를 다운로드하는 데 시간이 너무 오래 걸립니다. | 미디어를 다운로드하는 동안 시간 초과가 발생했습니다. 다시 시도하세요. |
| 2207020 | 액세스하려는 미디어가 만료되었습니다. 다시 업로드해 주세요. | 새 컨테이너 ID를 생성하여 다시 시도하세요. |
| 2207001 | Instagram 서버 오류입니다. 다시 시도하세요. | Instagram 서버 오류입니다. 다시 시도하세요. |
| 2207032 | 미디어 생성에 실패했습니다. 미디어를 다시 생성해 주세요 | 미디어 컨테이너를 생성하지 못했습니다. 다시 시도하세요. |
| 2207053 | 알 수 없는 업로드 오류 | 업로드 중 알 수 없는 오류가 발생했습니다. 새 컨테이너를 생성하여 다시 시도하세요. 이 오류는 동영상 업로드에만 영향을 줍니다. |
| 2207057 | 썸네일 오프셋은 0 이상이고 동영상 길이({video-length}) 미만이어야 합니다. | 썸네일 오프셋이 범위를 벗어났습니다. 유효한 오프셋을 밀리초 단위로 입력하세요. |
| 2207051 | 커뮤니티를 보호하기 위해 특정 활동을 제한합니다. 오류라고 생각되면 알려 주세요. | 게시 작업이 스팸으로 의심됩니다. 잘못된 경우 의견을 제출하고 반복적인 작업을 줄이세요. |
| 2207042 | Content Publishing API로 게시할 수 있는 최대 게시물 수에 도달했습니다. | 일일 게시 한도에 도달했습니다. 내일 다시 시도하세요. |
| 2207006 | {media-id} 미디어를 찾을 수 없습니다 | 권한이 없거나 토큰이 만료되었을 수 있습니다. 새 컨테이너를 생성하여 다시 시도하세요. |
| 2207008 | 생성 ID {creation-id}의 미디어 빌더가 존재하지 않거나 만료되었습니다. | 일시적인 오류입니다. 30~120초 동안 재시도하세요. 계속 실패하면 새 컨테이너를 만드세요. |
| 2207050 | Instagram 계정이 제한되었습니다. | Instagram 프로페셔널 계정이 비활성 상태이거나 제한되었습니다. Instagram에 로그인하여 필요한 조치를 완료하세요. |
| 2207023 | 미디어 유형 {media-type}을(를) 알 수 없습니다. | 잘못된 미디어 유형입니다. 지원되는 미디어 유형을 사용하세요. |
| 2207028 | 이 게시물은 캐러셀로 작동하지 않습니다. 캐러셀에는 사진/동영상이 최소 2개, 최대 10개 필요합니다. | 항목을 사진/동영상 2~10개로 조정하세요. |
| 2207035 | 동영상 미디어에는 제품 태그 위치를 지정할 수 없습니다. | 동영상은 X/Y 좌표를 지원하지 않습니다. 좌표를 제거하세요. |
| 2207036 | 사진 미디어에는 제품 태그 위치가 필요합니다. | 이미지 태그에는 X/Y 좌표가 필요합니다. 좌표를 추가하세요. |
| 2207037 | 제품 태그를 모두 추가하지 못했습니다. 제품 ID가 잘못되었거나 삭제되었거나 권한이 없을 수 있습니다. | 카탈로그를 새로 고치고 사용 가능한 제품 ID만 사용하세요. |
| 2207040 | 생성된 미디어당 {max-tag-count}개를 초과하는 태그를 사용할 수 없습니다. | 태그는 최대 20개까지 허용됩니다. 태그 수를 줄이세요. |
| 2207026 | 지원되지 않는 동영상 형식입니다. 지원되는 {video} 형식은 사양을 확인해 주세요. | 지원되지 않는 형식입니다. MP4 또는 MOV를 사용하세요. |
| 2207052 | 이 URI에서 미디어를 가져올 수 없습니다: {uri} | URI가 잘못되었거나 접근할 수 없습니다. 공개되어 있고 접근 가능한지 확인하세요. |
| 2207027 | 미디어를 게시할 준비가 되지 않았습니다. 잠시 기다려 주세요 | 컨테이너 상태가 FINISHED일 때만 게시하세요. |
| 2207004 | 이미지가 너무 커서 다운로드할 수 없습니다. {size} 미만이어야 합니다. | 최대 8MiB까지 허용됩니다. 더 작은 이미지를 업로드하세요. |
| 2207005 | 이미지 형식 {current-image-format}은(는) 지원되지 않습니다. 지원되는 형식: {format}. | 지원되지 않는 이미지 형식이거나 토큰이 만료되었습니다. 컨테이너를 다시 만드세요. |
| 2207009 | 제출한 이미지의 가로세로 비율 {submitted-ratio}은(는) 게시할 수 없습니다. 유효한 가로세로 비율의 이미지를 제출해 주세요. | 4:5에서 1.91:1 사이여야 합니다. 유효한 비율로 업로드하세요. |
| 2207010 | 제출한 이미지의 캡션이 {submitted-caption-length}자입니다. 최대 길이는 {maximum-caption-length}자입니다. | 최대: 2200자, 해시태그 30개, @태그 20개. 더 짧은 캡션을 사용하세요. |
Facebook Messenger 오류 코드
이 코드는 Instagram Messaging API에 해당합니다. 계정 연결, 사용자 권한, 메시지 유형, Instagram 전용 플랫폼 규칙과 관련된 문제를 파악할 때 이 목록을 참고하세요.
| 오류 코드 | 설명 | 세부 정보 / 가능한 원인 |
|---|---|---|
| 1 – 99 | 알 수 없는 오류 발생 | 권한 누락, 앱에 Advanced Access, 비즈니스 인증 또는 추가 권한이 필요할 수 있음 |
| 1 – 1357046 | 잘못된 JSON 응답 | 시스템 지연 또는 잘못된 형식의 메시지 일괄 응답 |
| 2 | 예기치 않은 오류, 나중에 다시 시도 | Meta 플랫폼 장애 또는 고객이 비즈니스를 차단함 |
| 2 – 2018344 | 서비스를 일시적으로 사용할 수 없음 | 받은 편지함 라벨 API를 사용하려면 페이지 관리자가 개인정보 처리 약관에 동의해야 함 |
| 4 | 속도 제한 도달 | 요청이 너무 많음, 발송을 일시 중지하세요 |
| 4 – 2018354 | 마케팅 메시지 빈도가 너무 높음 | 두 알림 사이의 최소 지연 시간을 지키지 않음 |
| 9 – 2018352 | 사용자가 너무 많은 작업을 수행함 | 마케팅 메시지 수신 동의 한도 초과 |
| 10 | 이 작업에 대한 권한 없음 | Instant Games에서는 User Profile API를 사용할 수 없음 |
| 10 – 1404170 | 앱에 권한이 없음 | 마케팅 메시지 수신 동의에 대해 페이지가 일시적으로 제한됨 |
| 10 – 1893015 | 사용자가 알림 메시지를 중단함 | 사용자가 “이 메시지 받지 않기”를 클릭함 |
| 10 – 2018336 | 사용자 스레드 영향 | 스레드가 영향을 받음, User Level Menu API를 확인하세요 |
| 10 – 2534022 | 허용된 기간 밖의 메시지 | 24시간 이내에 메시지를 보내야 함 |
| 10 – 2534077 | IG–FB 연결 문제 | IG와 페이지가 연결되지 않았거나 2단계 인증이 없음 |
| 10 – 2018278 | 허용된 기간 밖의 메시지 | 업데이트된 Meta 정책을 참고하세요 |
| 10 – 2018065 | 허용된 기간 밖이며 News Messaging 권한이 필요함 | News Messaging 승인이 필요함 |
| 10 – 2018108 | 수신자가 메시지를 받을 수 없음 | 사용자가 비즈니스의 메시지를 수신하지 않음 |
| 100 | 잘못된 매개변수 | 잘못된 FBID, 잘못되었거나 만료된 알림 토큰 |
| 100 – 33 | 지원되지 않는 GET 요청 | 권한 누락, 객체가 존재하지 않음 |
| 100 – 2018001 | 일치하는 사용자를 찾을 수 없음 | 사용자 식별자가 잘못되었거나 없음 |
| 100 – 2018008 | 파일을 가져오지 못함 | URL, SSL, 크기 또는 시간 초과 문제 |
| 100 – 2018014 | 메시지와 상태를 함께 보낼 수 없음 | 충돌하는 필드 중 하나를 제거하세요 |
| 100 – 2018047 | 첨부 파일 업로드 실패 | 미디어 유형 불일치 |
| 100 – 2018074 | 잘못되었거나 승인되지 않은 첨부 파일 | 첨부 파일의 소유자가 아니거나 잘못됨 |
| 100 – 2018109 | 첨부 파일 크기가 너무 큼 | 파일 크기를 줄이세요 |
| 100 – 2018164 | 잘못된 앱 ID | 앱 ID가 유효하지 않음 |
| 100 – 2018294 | 동영상 업로드 시간 초과 또는 손상 | 75초 내에 가져올 수 없음 |
| 100 – 2018320 | 잘못된 제품 ID | 제품이 존재하지 않거나 권한이 없음 |
| 100 – 2018328 | 제품 템플릿 미지원 | API 버전 8 이상을 사용해야 함 |
| 100 – 2534013 | 페이지가 IG에 연결되지 않음 | FB 페이지를 IG 프로페셔널 계정에 연결하세요 |
| 100 – 2534014 | 일치하는 IG 사용자 없음 | 잘못된 Instagram 범위 ID |
| 100 – 2534015 | 잘못된 메시지 데이터 | 이 메시지 유형에 허용되지 않는 콘텐츠 |
| 100 – 2534025 | 비공개 답장에 사용할 수 없는 댓글 | 비공개 답장에 허용되지 않는 데이터 |
| 100 – 2534029 | 비즈니스가 IG Messaging API에서 차단됨 | 정책 위반을 해결해야 함 |
| 100 – 2534037 | 스레드 소유자가 아님 | 대화에 대한 권한 누락 |
| 190 | 잘못된 OAuth 액세스 토큰 | 토큰이 만료되었거나 유효하지 않음 |
| 200 | 권한 오류 | pages_messaging 권한 필요 |
| 200 – 1545041 | 사용자가 이용할 수 없음 | 사용자가 현재 이용할 수 없음 |
| 200 – 2018021 | 전화번호 매칭 요금 필요 | 전화번호 매칭 액세스 요금이 필요함 |
| 200 – 2018027 | 메시징 제한됨 | pages_messaging_phone_number 권한 없음 |
| 200 – 2018028 | 메시징 제한됨 | pages_messaging 권한 없음 |
| 200 – 2534041 | IG 다이렉트 메시지 비활성화됨 | 소유자가 API 액세스를 비활성화함 |
| 551 | 사용자가 비즈니스를 차단함 | 사용자가 메시지를 받지 못함 |
| 551 – 1545041 | 사용자가 이용할 수 없음 | 위와 동일 |
| 613 – 1893016 | 수신 동의 요청 중복 | 같은 주제에 대해 여러 수신 동의 요청 |
| 613 – 2018338 | 경고: 악용 행위 | 메시지 발송 속도를 줄이세요 |
| 613 – 2534040 | 속도 제한 초과 | API 호출을 일시 중지하세요 |
| 2022 | 커머스 메시징 비활성화됨 | 정책 위반으로 인함 |
| 10303 | 잘못된 계정 연결 토큰 | 토큰이 올바르지 않거나 만료됨 |
| 24001 | 사용자가 결제 플로우를 취소함 | 결제 취소됨 |
| 24002 | 개인정보 처리방침 URL 없음 | 결제를 위해 개인정보 처리방침 URL을 제공하세요 |
| 24005 | 사용자 ID를 가져오지 못함 | 사용자 식별 문제 |
| 36103 | IG 계정이 API 사용 대상이 아님 | 단계적 출시의 일부 |
| 2018144 | Instant Game 한도 | 10일간 알림 5건만 가능 |
| 2018154 | Messenger Extensions 오류 | 예기치 않은 SDK 오류 |
| 2018163 | 공유 매개변수 검증 오류 | 잘못된 공유 매개변수 |
| 2018166 | 잘못된 SDK 권한 | 권한 누락 |
| 2018171 | 기본/보조 수신자 전용 | 액세스 제한됨 |
| 2018218 | 사용 가능한 프로필 없음 | 전화번호로 생성된 사용자 |
| 2018234 | 가시성 거부됨 | 보조 수신자 격리 |
| 2018247 | 프로필 권한 부족 | User Profile 권한 누락 |
| 2018300 | 다른 앱이 스레드를 제어함 | 핸드오프 이벤트 활성 상태 |
| 2018321 | 자동 Q&A 플로우 활성 상태 | 플로우가 끝날 때까지 기다리세요 |
| 2071010 | 지원되지 않는 SDK 메서드 | Messenger 클라이언트를 업데이트하세요 |
| 2071011 | Messenger Extensions 비활성화됨 | 도메인이 허용 목록에 없거나 클라이언트가 오래됨 |
| 2071014–1025 | 잘못된 메시지 콘텐츠 필드 | 잘못된 제목, URL, 첨부 파일, 템플릿 |
| 9000001 | 메시지 삭제됨 | 삭제된 콘텐츠를 가져올 수 없음 |
| OAuthException | 인증 문제 | 일반 OAuth 오류 |
| 2018389 | 페이지가 허용 목록에 없음 | 페이지가 허용 목록에 있어야 함 |
| 2018390 | 잘못된 통화 ID | 통화 ID 불일치 |
| 2018391 | 잘못된 연결 매개변수 | 비워 둘 수 없음 |
| 2018392 | 잘못된 SDP 매개변수 | JSON dict 사양을 따라야 함 |
| 2018393 | 잘못된 통화 참가자 | 페이지가 통화에 참여하지 않음 |
| 2018394 | 통화 참여 권한 부족 | 페이지에 권한이 없음 |
| 2018395 | 실패한 통화에 참여할 수 없음 | 콜백을 기다리세요 |
| 2018396 | 종료된 통화에 참여할 수 없음 | 통화가 이미 종료됨 |
| TBD | 통화 속도 제한 초과 | 통화 빈도를 줄이세요 |