عیب‌یابی و پرسش‌های متداول
از این صفحه برای تشخیص و رفع سریع مشکلات در کانال‌های پیام‌رسانی WhatsApp، Instagram و Facebook استفاده کنید. در اینجا فهرست کامل کدهای خطا، معنی آن‌ها و اقدامات پیشنهادی را همراه با بخش پرسش‌های متداول می‌یابید که به شما کمک می‌کند مشکلات رایج را پشت سر بگذارید و راه‌اندازی پیام‌رسانی خود را بهینه کنید.
پرسش‌های متداول
با MonoChat چه کانال‌های ارتباطی را می‌توانم متصل کنم؟
MonoChat از کانال‌های ارتباطی متعددی از جمله WhatsApp، Instagram، Facebook Messenger، Telegram، چت زنده و کانال‌های SIP پشتیبانی می‌کند. این به شما امکان می‌دهد همه مکالمه‌ها را از یک صندوق ورودی یکپارچه مدیریت کنید.
چقدر سریع می‌توانم شروع کنم؟
می‌توانید ظرف چند دقیقه شروع کنید. کافی است ثبت‌نام کنید، کانال‌های موردنظر خود را متصل کنید، تیم خود را دعوت کنید و با فرایند راه‌اندازی ساده MonoChat گردش‌کار خود را بسازید. به هیچ آشنایی‌سازی طولانی نیازی نیست.
آیا برای ساخت دستیار هوش مصنوعی خود به دانش فنی نیاز دارم؟
خیر، به هیچ دانش فنی نیاز ندارید. MonoChat رابطی ساده و کاربرپسند ارائه می‌دهد که به شما امکان می‌دهد دستیار هوش مصنوعی خود را تنها در چند دقیقه بسازید و سفارشی کنید—بدون نیاز به کدنویسی. می‌توانید شخصیت، لحن و وظایف دستیار را با تنظیمات بصری به‌راحتی تغییر دهید. همه چیز طوری طراحی شده است که شما روی کاری که دستیار باید انجام دهد تمرکز کنید و MonoChat بخش فنی را برعهده بگیرد.
آیا داده‌های من در MonoChat امن است؟
بله، MonoChat امنیت داده‌ها را جدی می‌گیرد. همه داده‌ها هم در حین انتقال و هم در حالت ذخیره‌شده رمزگذاری می‌شوند. ما از روش‌های امنیتی استاندارد صنعت پیروی می‌کنیم تا از اطلاعات شما محافظت شود.
صورتحساب چگونه کار می‌کند؟
صورتحساب ساده و انعطاف‌پذیر است. می‌توانید میان طرح‌های اشتراک ماهانه یا سالانه یکی را انتخاب کنید و در صورت نیاز بسته‌های اضافی هم اضافه کنید. صورتحساب شما بر اساس طرح انتخابی و میزان استفاده صادر می‌شود.
چه روش‌های پرداختی را می‌پذیرید؟
می‌توانید به‌راحتی و مستقیماً از طریق پلتفرم MonoChat با کارت‌های اعتباری یا نقدی خود پرداخت کنید. همه گزینه‌های پرداخت از بخش صورتحساب در حساب شما در دسترس هستند و مدیریت و به‌روزرسانی روش‌های پرداخت را ساده می‌کنند.
آیا می‌توانم اشتراک خود را تغییر دهم یا لغو کنم؟
بله، می‌توانید هر زمان مستقیماً از حساب خود اشتراک را ارتقا دهید، تنزل دهید یا لغو کنید. بسته به طرح شما، تغییرات بلافاصله یا در چرخه صورتحساب بعدی اعمال می‌شوند.
آیا دوره آزمایشی رایگان وجود دارد؟
بله، MonoChat یک دوره آزمایشی رایگان ارائه می‌دهد که به شما امکان می‌دهد پیش از انتخاب طرح پولی، پلتفرم را بررسی کنید. دوره آزمایشی شامل ۱ کانال، ۱ کاربر و حداکثر ۱٬۰۰۰ پیام است.
اگر مشکلی داشته باشم یا برای راه‌اندازی یا یکپارچه‌سازی‌ها به کمک نیاز داشته باشم، از کجا کمک بگیرم؟
MonoChat بسته‌های پشتیبانی متنوعی متناسب با نیاز شما ارائه می‌دهد و کانال پشتیبانی WhatsApp ما برای همه کاربران در دسترس است. چه در حین راه‌اندازی به راهنمایی نیاز داشته باشید، چه برای یکپارچه‌سازی‌ها یا عیب‌یابی به کمک احتیاج داشته باشید، تیم ما آماده کمک به شماست.
پس از نصب یک برنامه، دستیار من پاسخ نمی‌دهد. چرا؟
برنامه‌هایی که به مشتریان پاسخ می‌دهند با جریان ربات خاموش نصب می‌شوند تا دستیاری که هنوز راه‌اندازی نشده هرگز با مشتریان شما صحبت نکند. مراحل راه‌اندازی برنامه را کامل کنید (در پنل شروع کنید یا صفحه خود برنامه)، سپس دستیار را از صفحه برنامه روشن کنید یا جریان آن را در تنظیمات › اتوماسیون › جریان‌ها فعال کنید. به‌روزرسانی بعدی برنامه، وضعیت روشن/خاموشی را که انتخاب کرده‌اید حفظ می‌کند. MonoStore را ببینید.
نمی‌توانم کوپن را استفاده کنم.
پیام خطا دلیل را به شما می‌گوید. یک کوپن فقط یک‌بار قابل استفاده است، ممکن است منقضی شود و ممکن است به فضاهای کاری خاصی محدود باشد: برای مثال فقط فضاهای کاری ساخته‌شده در چند روز اخیر، فقط فضاهای کاری که در ماه‌های اخیر حداقل مبلغی واریز کرده‌اند، یا فقط فضاهای کاری که اخیراً کوپن دیگری استفاده نکرده‌اند. وقتی شرطی برقرار نباشد، کوپن مصرف نمی‌شود و می‌توانید پس از واجد شرایط شدن دوباره تلاش کنید. همچنین در فضای کاری به دسترسی‌های صورتحساب نیاز دارید. کوپن‌ها را ببینید.
گفتگوهای قدیمی WhatsApp من کجا هستند؟
وقتی کانالی را متصل می‌کنید، پیام‌های گذشته آن به‌صورت گفتگوهای تاریخچه می‌رسند. این گفتگوها از فهرست مکالمه‌ها کنار گذاشته می‌شوند تا سیل پیام‌های قدیمی پیام‌های جدید را زیر خود نگیرد. اگر چنین گفتگوهایی داشته باشید، یک نوار خاکستری بالای فهرست می‌نویسد شما گفتگوهای تاریخچه دارید. روی نمایش کلیک کنید و تأیید کنید تا فهرست روی آن‌ها فیلتر شود؛ علامت ضربدر نوار را تا بارگذاری دوباره صفحه پنهان می‌کند.
رابط کاربری به زبان اشتباه است.
MonoChat با زبان مرورگر شما شروع می‌شود. برای تغییر آن، دکمه حساب را در پایین نوار پیمایش باز کنید، زیر زبان پیش‌فرض یک زبان انتخاب کنید و ذخیره کنید؛ در صفحه ورود از انتخابگر زبان پایین صفحه استفاده کنید. این انتخاب برای هر مرورگر به‌طور جداگانه به خاطر سپرده می‌شود. ایمیل‌های مربوط به فضای کاری (صورتحساب، خلاصه هفتگی) از زبان پیش‌فرض فضای کاری استفاده می‌کنند که در تنظیمات › CRM › زبان‌ها تعیین می‌شود. زبان‌های رابط کاربری را ببینید.
چرا هنگام پرداخت از من مبلغی کمتر از قیمت طرح خواسته شد؟
وقتی طرحی را تغییر می‌دهید یا بسته‌ای می‌خرید و موجودی شما آن را پوشش نمی‌دهد، MonoChat فقط تفاوت میان قیمت و موجودی شما را دریافت می‌کند. اگر موجودی منفی باشد، مبلغ بدهی شما اضافه می‌شود. اگر موجودی شما قیمت را پوشش دهد، اصلاً صفحه پرداختی باز نمی‌شود. پرداخت مستقیم برای یک طرح یا بسته را ببینید.
پنل شروع کنید کجا رفت؟
زبانه شروع کنید تا زمانی که همه مراحل انجام نشده باشند، همراه با تعداد مراحل باز در نوار پیمایش می‌ماند؛ سپس خودبه‌خود ناپدید می‌شود. پنهان کردن این بخش فقط مانع باز شدن خودکار آن می‌شود. برای دیدن دوباره تور نوار پیمایش، شروع کنید را باز کنید و روی راهنمایی کن کلیک کنید. پنل شروع کنید را ببینید.
کدهای خطا – WhatsApp، Instagram، Facebook
در ادامه رایج‌ترین کدهای خطا برای هر کانال پیام‌رسانی، همراه با توضیح و اقدامات پیشنهادی آمده است.
کدهای خطای WhatsApp (Cloud API)
این کدهای خطا را WhatsApp Business API برمی‌گرداند. از این فهرست برای شناسایی مشکلات تحویل، مشکلات پیکربندی، محدودیت‌های نرخ یا خطاهای مربوط به دسترسی که پیام‌رسانی WhatsApp شما را تحت تأثیر قرار می‌دهند استفاده کنید.
| کد خطا | جزئیات | دلایل ممکن و راه‌حل‌ها |
|---|---|---|
| 368 - Temporarily blocked for policies violations | برای آشنایی با نقض سیاست‌ها و نحوه رفع آن‌ها، سند Policy Enforcement را ببینید. به‌دلیل نقض سیاست پلتفرم محدود یا غیرفعال شده است. | قالب‌بندی payload و فیلدهای الزامی را بررسی کنید. |
| 130497 - Business account is restricted from messaging users in this country. | حساب WhatsApp Business از ارسال پیام به کاربران در برخی کشورها محدود شده است. | برای جزئیات کشورهای مجاز برای پیام‌رسانی در دسته‌بندی کسب‌وکار خود، WhatsApp Business Messaging Policy را ببینید. |
| 2388019 - Message Template Limit Exceeded | از حداکثر تعداد الگوهای پیامی که می‌توانید برای این حساب WhatsApp Business داشته باشید فراتر رفته‌اید. | یک حساب WhatsApp Business می‌تواند تا ۲۵۰ الگوی پیام داشته باشد. Template limits را ببینید. |
| 1 - API Unknown | درخواست نامعتبر یا خطای احتمالی سرور. | صفحه WhatsApp Business Platform Status را برای مشاهده وضعیت API بررسی کنید. اگر قطعی سروری وجود ندارد، مرجع endpoint را ببینید و بررسی کنید درخواست شما درست قالب‌بندی شده و همه الزامات endpoint را برآورده می‌کند. |
| 2 - API Service | موقت، به‌دلیل قطعی یا بار بیش از حد. | پیش از تلاش دوباره، صفحه WhatsApp Business Platform Status را برای مشاهده وضعیت API بررسی کنید. |
| 33 - Parameter value is not valid | شماره تلفن کسب‌وکار حذف شده است. | بررسی کنید شماره تلفن کسب‌وکار درست باشد. |
| 100 - Invalid parameter | درخواست شامل یک یا چند پارامتر پشتیبانی‌نشده یا با املای نادرست بود. | مرجع endpoint را ببینید تا بدانید کدام پارامترها پشتیبانی می‌شوند و املای آن‌ها چیست. |
| 130472 - User’s number is part of an experiment | پیام به‌عنوان بخشی از یک آزمایش ارسال نشد. | Marketing Message Experiment را ببینید. |
| 131000 - Something went wrong | ارسال پیام به‌دلیل یک خطای ناشناخته ناموفق بود. | دوباره تلاش کنید. اگر خطا ادامه داشت، یک تیکت Direct Support باز کنید. |
| 131005 - Access denied | دسترسی یا داده نشده یا برداشته شده است. | از access token debugger برای بررسی اینکه برنامه شما دسترسی‌های موردنیاز endpoint را دارد استفاده کنید. Authentication and authorization errors را ببینید. |
| 131008 - Required parameter is missing | یک پارامتر الزامی در درخواست وجود ندارد. | مرجع endpoint را ببینید تا بدانید کدام پارامترها الزامی هستند. |
| 131009 - Parameter value is not valid | یک یا چند مقدار پارامتر نامعتبر است. | مرجع endpoint را ببینید تا بدانید برای هر پارامتر چه مقادیری پشتیبانی می‌شود، و Phone Numbers را ببینید تا بدانید چگونه شماره تلفن را به یک حساب WhatsApp Business اضافه کنید. |
| 131016 - Service unavailable | یک سرویس موقتاً در دسترس نیست. | پیش از تلاش دوباره، صفحه WhatsApp Business Platform Status را برای مشاهده وضعیت API بررسی کنید. |
| 131021 - Recipient cannot be sender | شماره تلفن فرستنده و گیرنده یکسان است. | پیام را به شماره‌ای متفاوت از فرستنده ارسال کنید. |
| 131026 - Message Undeliverable | پیام قابل تحویل نیست. دلایل می‌تواند شامل این موارد باشد: شماره تلفن گیرنده یک شماره 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 کسب‌وکار شما پیام بفرستد. تأیید کند که آخرین شرایط خدمات ما را پذیرفته است (اگر هنوز نپذیرفته باشد، Settings > Help یا Settings > Application information از او می‌خواهد آخرین شرایط/سیاست‌ها را بپذیرد). به آخرین نسخه کلاینت WhatsApp به‌روزرسانی کند. |
| 131037 - WhatsApp provided number needs display name approval before message can be sent. | شماره تلفن کسب‌وکار 555 که برای ارسال درخواست استفاده شده، نام نمایشی تأییدشده ندارد. | نام نمایشی شماره تلفن کسب‌وکار 555 را تغییر دهید. مقاله Help Center با عنوان How to change your WhatsApp Business display name را نیز ببینید. |
| 131042 - Business eligibility payment issue | خطایی مربوط به روش پرداخت شما رخ داده است. | About Billing For Your WhatsApp Business Account را ببینید و بررسی کنید صورتحساب را درست راه‌اندازی کرده‌اید. مشکلات رایج: حساب پرداخت به یک حساب WhatsApp Business متصل نیست / خط اعتباری از سقف فراتر رفته است / خط اعتباری (حساب پرداخت) تنظیم یا فعال نیست / حساب WhatsApp Business حذف شده است / حساب WhatsApp Business معلق شده است / منطقه زمانی تنظیم نشده است / ارز تنظیم نشده است / درخواست MessagingFor (On Behalf Of) در انتظار است یا رد شده است |
| 131045 - Incorrect certificate | ارسال پیام به‌دلیل خطای ثبت شماره تلفن ناموفق بود. | پیش از تلاش دوباره، شماره تلفن را ثبت کنید. |
| 131047 - Re-engagement message | بیش از ۲۴ ساعت از آخرین پاسخ گیرنده به شماره فرستنده گذشته است. | به‌جای آن، یک پیام الگو برای گیرنده ارسال کنید. |
| 131049 - Meta chose not to deliver. | این پیام برای حفظ تعامل سالم در اکوسیستم تحویل داده نشد. | اگر این کد خطا را دریافت کردید و گمان می‌کنید به‌دلیل این محدودیت است، پیش از ارسال دوباره پیام الگو دست‌کم ۲۴ ساعت صبر کنید. در غیر این صورت فقط پاسخ خطای دیگری دریافت می‌کنید، زیرا ممکن است محدودیت برای بازه‌های زمانی متفاوتی برقرار باشد. |
| 131050 - User has stopped receipt of marketing messages. | پیام قابل تحویل نیست. این گیرنده تصمیم گرفته است پیام‌های بازاریابی کسب‌وکار شما را در WhatsApp دریافت نکند. | ارسال پیام به این کاربر را دوباره تلاش نکنید، زیرا دریافت نخواهد شد. برای اینکه هر زمان کاربر WhatsApp دریافت پیام‌های الگوی بازاریابی کسب‌وکار شما را متوقف یا از سر بگیرد مطلع شوید، در webhook مربوط به user_preferences مشترک شوید. |
| 131051 - Unsupported message type | نوع پیام پشتیبانی نمی‌شود. | پیش از تلاش دوباره با نوع پیام پشتیبانی‌شده، Messages را برای انواع پیام پشتیبانی‌شده ببینید. |
| 131052 - Media download error | امکان دانلود رسانه ارسال‌شده توسط کاربر وجود نداشت. | نتوانستیم رسانه گنجانده‌شده در پیام کاربر WhatsApp را دانلود کنیم. برای اطلاعات بیشتر، به مقدار error.error_data.details در هر webhook پیام‌ها که هنگام دریافت این پیام فعال شده است مراجعه کنید. از کاربر WhatsApp بخواهید فایل رسانه را با روشی غیر از WhatsApp برای شما ارسال کند. |
| 131057 - Account in maintenance mode | حساب کسب‌وکار در حالت تعمیر و نگهداری است | حساب WhatsApp Business در حالت تعمیر و نگهداری است. یکی از دلایل این می‌تواند ارتقای throughput حساب باشد. |
| 132000 - Template Param Count Mismatch | تعداد مقادیر پارامترهای متغیر گنجانده‌شده در درخواست با تعداد پارامترهای متغیر تعریف‌شده در الگو مطابقت نداشت. | سند Templates ما را ببینید تا با پارامترها آشنا شوید و مطمئن شوید درخواست شامل مقدار همه پارامترهای موردنیاز الگو است. |
| 132001 - Template does not exist | الگو در زبان مشخص‌شده وجود ندارد یا الگو تأیید نشده است. | مطمئن شوید الگوی شما تأیید شده و نام الگو و locale زبان درست است. برای اطلاعات بیشتر درباره الگوها، سند Templates ما را ببینید. |
| 132005 - Template Hydrated Text Too Long | متن ترجمه‌شده بیش از حد طولانی است. | در WhatsApp Manager بررسی کنید که الگوی شما ترجمه شده باشد. برای آشنایی با نحوه بررسی وضعیت الگو، سند Template quality ما را ببینید. |
| 132007 - Template Format Character Policy Violated | محتوای الگو سیاست WhatsApp را نقض می‌کند. | برای آشنایی با دلایل ممکن نقض، سند Template review ما را ببینید. |
| 132012 - Template Parameter Format Mismatch | مقادیر پارامترهای متغیر نادرست قالب‌بندی شده‌اند. | مقادیر پارامترهای متغیر گنجانده‌شده در درخواست از قالب مشخص‌شده در الگو پیروی نمی‌کنند. برای اطلاعات بیشتر درباره پارامترها و قالب‌های الگو، سند Templates ما را ببینید. |
| 132015 - Template is Paused | الگو به‌دلیل کیفیت پایین متوقف شده است و نمی‌توان آن را در پیام الگو ارسال کرد. | الگو را برای بهبود کیفیت ویرایش کنید و پس از تأیید دوباره تلاش کنید. |
| 132016 - Template is Disabled | الگو به‌دلیل کیفیت پایین بیش از حد متوقف شده و اکنون برای همیشه غیرفعال است. | الگوی جدیدی با محتوای متفاوت بسازید. |
| 132068 - Flow is blocked | Flow در وضعیت مسدود است. | Flow را اصلاح کنید |
| 132069 - Flow is throttled | Flow در وضعیت محدودشده است و در یک ساعت گذشته ۱۰ پیام با این Flow ارسال شده است. | Flow را اصلاح کنید |
| 133000 - Incomplete Deregistration | تلاش قبلی برای لغو ثبت ناموفق بود. | پیش از ثبت، شماره را دوباره لغو ثبت کنید. |
| 133004 - Server Temporarily Unavailable | سرور موقتاً در دسترس نیست. | پیش از تلاش دوباره، صفحه WhatsApp Business Platform Status را برای مشاهده وضعیت API بررسی کنید و مقدار details پاسخ را ببینید. |
| 133005 - Two step verification PIN Mismatch | پین تأیید دومرحله‌ای نادرست است. | بررسی کنید پین تأیید دومرحله‌ای گنجانده‌شده در درخواست درست باشد. برای بازنشانی پین، تأیید دومرحله‌ای را غیرفعال کنید و سپس پین جدیدی تنظیم کنید. Two-step verification را ببینید. |
| 133006 - Phone number re-verification needed | شماره تلفن پیش از ثبت باید تأیید شود. | شماره تلفن را تأیید و ثبت کنید. |
| 133010 - Phone number Not Registered | شماره تلفن در WhatsApp Business Platform ثبت نشده است. | پیش از تلاش دوباره، شماره تلفن را ثبت کنید. |
| 135000 - Generic user error | ارسال پیام به‌دلیل یک خطای ناشناخته در پارامترهای درخواست شما ناموفق بود. | مرجع endpoint را ببینید تا مشخص شود آیا endpoint را با نحو درست فراخوانی می‌کنید. اگر همچنان این کد خطا را در پاسخ دریافت می‌کنید، با پشتیبانی مشتری تماس بگیرید. |
کدهای خطای Instagram Messaging API
این خطاها از Messenger Platform سرچشمه می‌گیرند. آن‌ها به تشخیص مشکلات مربوط به دسترسی‌های کاربر، تنظیمات صفحه، محدودیت‌های API، محدودیت‌های نرخ و محدودیت‌های تحویل پیام کمک می‌کنند.
| کد خطا | پیام کاربر | راه‌حل پیشنهادی |
|---|---|---|
| 2207003 | دانلود رسانه بیش از حد طول می‌کشد. | هنگام دانلود رسانه، وقفه زمانی رخ داد. دوباره تلاش کنید. |
| 2207020 | رسانه‌ای که می‌خواهید به آن دسترسی پیدا کنید منقضی شده است. لطفاً دوباره بارگذاری کنید. | یک شناسه container جدید بسازید و با آن دوباره تلاش کنید. |
| 2207001 | خطای سرور Instagram. دوباره تلاش کنید. | خطای سرور Instagram. دوباره تلاش کنید. |
| 2207032 | ساخت رسانه ناموفق بود، لطفاً رسانه را دوباره بسازید | ساخت container رسانه ناموفق بود. دوباره تلاش کنید. |
| 2207053 | خطای ناشناخته بارگذاری | هنگام بارگذاری خطایی ناشناخته رخ داد. یک container جدید بسازید و با آن دوباره تلاش کنید. این مورد فقط باید بارگذاری ویدیو را تحت تأثیر قرار دهد. |
| 2207057 | offset تصویر بندانگشتی باید بزرگ‌تر یا مساوی ۰ و کمتر از مدت ویدیو باشد، یعنی {video-length} | offset تصویر بندانگشتی خارج از محدوده است. یک offset معتبر را بر حسب میلی‌ثانیه وارد کنید. |
| 2207051 | ما برای محافظت از جامعه خود برخی فعالیت‌ها را محدود می‌کنیم. اگر فکر می‌کنید اشتباه کرده‌ایم، به ما اطلاع دهید. | اقدام انتشار به‌عنوان هرزنامه مشکوک شناخته شده است. اگر نادرست است بازخورد ارسال کنید و اقدامات تکراری را کاهش دهید. |
| 2207042 | به حداکثر تعداد پست‌هایی که Content Publishing API اجازه انتشار می‌دهد رسیده‌اید. | به سقف انتشار روزانه رسیده‌اید. فردا دوباره تلاش کنید. |
| 2207006 | رسانه با {media-id} پیدا نشد | احتمالاً دسترسی وجود ندارد یا توکن منقضی شده است. یک container جدید بسازید و دوباره تلاش کنید. |
| 2207008 | media builder با creation id = {creation-id} وجود ندارد یا منقضی شده است. | خطای موقت. ۳۰ تا ۱۲۰ ثانیه دوباره تلاش کنید. اگر همچنان ناموفق بود، یک container جدید بسازید. |
| 2207050 | حساب Instagram محدود شده است. | حساب حرفه‌ای Instagram غیرفعال یا محدود است. وارد Instagram شوید و اقدامات موردنیاز را انجام دهید. |
| 2207023 | نوع رسانه {media-type} ناشناخته است. | نوع رسانه نامعتبر است. از یک نوع رسانه پشتیبانی‌شده استفاده کنید. |
| 2207028 | پست شما به‌عنوان کاروسل کار نخواهد کرد. کاروسل‌ها دست‌کم به ۲ عکس/ویدیو و حداکثر ۱۰ عکس/ویدیو نیاز دارند. | تعداد موارد را روی ۲ تا ۱۰ عکس/ویدیو تنظیم کنید. |
| 2207035 | موقعیت برچسب محصول نباید برای رسانه ویدیویی مشخص شود. | ویدیوها از مختصات X/Y پشتیبانی نمی‌کنند. مختصات را حذف کنید. |
| 2207036 | موقعیت برچسب محصول برای رسانه عکس الزامی است. | برچسب‌های تصویر به مختصات X/Y نیاز دارند. آن‌ها را اضافه کنید. |
| 2207037 | نتوانستیم همه برچسب‌های محصول شما را اضافه کنیم. ممکن است شناسه محصول نادرست یا حذف‌شده باشد یا دسترسی وجود نداشته باشد. | کاتالوگ را تازه‌سازی کنید و فقط از شناسه‌های محصول واجد شرایط استفاده کنید. |
| 2207040 | نمی‌توان بیش از {max-tag-count} برچسب برای هر رسانه ساخته‌شده استفاده کرد. | حداکثر ۲۰ برچسب مجاز است. تعداد برچسب‌ها را کاهش دهید. |
| 2207026 | قالب ویدیو پشتیبانی نمی‌شود. لطفاً مشخصات را برای قالب {video} پشتیبانی‌شده بررسی کنید. | قالب پشتیبانی‌نشده. از MP4 یا MOV استفاده کنید. |
| 2207052 | رسانه از این uri قابل دریافت نبود: {uri} | URI نامعتبر یا غیرقابل دسترس است. مطمئن شوید عمومی و در دسترس است. |
| 2207027 | رسانه برای انتشار آماده نیست، لطفاً چند لحظه صبر کنید | فقط زمانی منتشر کنید که وضعیت container برابر FINISHED باشد. |
| 2207004 | تصویر برای دانلود بیش از حد بزرگ است. باید کمتر از {size} باشد. | حداکثر ۸ مبی‌بایت مجاز است. تصویر کوچک‌تری بارگذاری کنید. |
| 2207005 | قالب تصویر {current-image-format} پشتیبانی نمی‌شود. قالب‌های پشتیبانی‌شده: {format}. | قالب تصویر پشتیبانی‌نشده یا توکن منقضی‌شده. container را دوباره بسازید. |
| 2207009 | تصویر ارسال‌شده با نسبت ابعاد {submitted-ratio} قابل انتشار نیست. لطفاً تصویری با نسبت ابعاد معتبر ارسال کنید. | باید بین 4:5 و 1.91:1 باشد. با نسبت معتبر بارگذاری کنید. |
| 2207010 | کپشن تصویر ارسال‌شده {submitted-caption-length} نویسه بود. حداکثر {maximum-caption-length} است. | حداکثر: ۲۲۰۰ نویسه، ۳۰ هشتگ، ۲۰ @تگ. از کپشن کوتاه‌تری استفاده کنید. |
کدهای خطای Facebook Messenger
این کدها مختص Instagram Messaging API هستند. برای درک مشکلات مربوط به اتصال حساب، دسترسی‌های کاربر، انواع پیام و قوانین مخصوص پلتفرم Instagram به این فهرست مراجعه کنید.
| کد خطا | توضیح | جزئیات / دلایل ممکن |
|---|---|---|
| 1 – 99 | خطای ناشناخته رخ داد | دسترسی‌ها وجود ندارد، ممکن است برنامه به Advanced Access، Business Verification یا دسترسی‌های بیشتر نیاز داشته باشد |
| 1 – 1357046 | پاسخ JSON نامعتبر | تأخیر سیستم یا پاسخ دسته پیام ناقص |
| 2 | خطای غیرمنتظره، بعداً دوباره تلاش کنید | قطعی پلتفرم Meta یا مشتری کسب‌وکار شما را مسدود کرده است |
| 2 – 2018344 | سرویس موقتاً در دسترس نیست | مدیر صفحه باید Privacy ToS را برای inbox label API بپذیرد |
| 4 | به محدودیت نرخ رسیده‌اید | درخواست‌های بیش از حد؛ ارسال را متوقف کنید |
| 4 – 2018354 | بسامد پیام بازاریابی بیش از حد بالاست | حداقل فاصله میان دو اعلان رعایت نشده است |
| 9 – 2018352 | کاربر اقدامات بیش از حدی انجام می‌دهد | از سقف opt-in پیام بازاریابی فراتر رفته است |
| 10 | دسترسی برای این اقدام وجود ندارد | User Profile API برای Instant Games در دسترس نیست |
| 10 – 1404170 | برنامه دسترسی‌ها را ندارد | صفحه موقتاً برای opt-in پیام بازاریابی محدود شده است |
| 10 – 1893015 | کاربر پیام‌های اعلان را متوقف کرده است | کاربر روی «Stop these messages» کلیک کرده است |
| 10 – 2018336 | تأثیر بر رشته گفتگوی کاربر | رشته گفتگو تحت تأثیر قرار گرفته است؛ User Level Menu API را بررسی کنید |
| 10 – 2534022 | پیام خارج از بازه مجاز | باید در بازه ۲۴ ساعته پیام ارسال شود |
| 10 – 2534077 | مشکل اتصال IG–FB | IG و صفحه متصل نیستند یا 2FA وجود ندارد |
| 10 – 2018278 | پیام خارج از بازه مجاز | سیاست به‌روزشده Meta را ببینید |
| 10 – 2018065 | خارج از بازه مجاز؛ به دسترسی News Messaging نیاز دارد | به تأیید News Messaging نیاز دارد |
| 10 – 2018108 | شخص نمی‌تواند پیام دریافت کند | کاربر پیام‌های کسب‌وکار را نمی‌پذیرد |
| 100 | پارامترهای نامعتبر | FBID نامعتبر، توکن اعلان نامعتبر/منقضی |
| 100 – 33 | درخواست GET پشتیبانی‌نشده | دسترسی‌ها وجود ندارد، شیء وجود ندارد |
| 100 – 2018001 | کاربر منطبقی یافت نشد | شناسه کاربر نامعتبر یا ناموجود |
| 100 – 2018008 | دریافت فایل ناموفق بود | URL، SSL، اندازه یا وقفه زمانی نامعتبر |
| 100 – 2018014 | نمی‌توان هم پیام و هم state را ارسال کرد | یکی از فیلدهای متضاد را حذف کنید |
| 100 – 2018047 | شکست در بارگذاری پیوست | نوع رسانه مطابقت ندارد |
| 100 – 2018074 | پیوست نامعتبر/غیرمجاز | پیوست متعلق به شما نیست یا نامعتبر است |
| 100 – 2018109 | اندازه پیوست بیش از حد بزرگ است | اندازه فایل را کاهش دهید |
| 100 – 2018164 | App ID نادرست | App ID نامعتبر است |
| 100 – 2018294 | بارگذاری ویدیو دچار وقفه زمانی یا خراب شد | ظرف ۷۵ ثانیه قابل دریافت نیست |
| 100 – 2018320 | شناسه محصول نامعتبر | محصول وجود ندارد یا دسترسی وجود ندارد |
| 100 – 2018328 | الگوی محصول پشتیبانی نمی‌شود | باید از API نسخه ۸ یا بالاتر استفاده شود |
| 100 – 2534013 | صفحه به IG متصل نیست | صفحه FB را به حساب حرفه‌ای IG متصل کنید |
| 100 – 2534014 | کاربر IG منطبقی وجود ندارد | شناسه Instagram-scoped نامعتبر |
| 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 | درخواست opt-in تکراری است | چند درخواست opt-in برای یک موضوع |
| 613 – 2018338 | هشدار: رفتار سوءاستفاده‌آمیز | نرخ ارسال پیام را کاهش دهید |
| 613 – 2534040 | از محدودیت نرخ فراتر رفته است | فراخوانی‌های API را متوقف کنید |
| 2022 | پیام‌رسانی تجاری غیرفعال است | به‌دلیل نقض سیاست |
| 10303 | توکن اتصال حساب نامعتبر | توکن نادرست یا منقضی است |
| 24001 | کاربر جریان پرداخت را لغو کرد | پرداخت لغو شد |
| 24002 | URL حریم خصوصی وجود ندارد | برای پرداخت URL حریم خصوصی ارائه دهید |
| 24005 | دریافت شناسه کاربر ناموفق بود | مشکل شناسایی کاربر |
| 36103 | حساب IG واجد شرایط API نیست | بخشی از عرضه مرحله‌ای |
| 2018144 | سقف Instant Game | فقط ۵ اعلان در ۱۰ روز |
| 2018154 | خطای Messenger Extensions | خطای غیرمنتظره SDK |
| 2018163 | خطای اعتبارسنجی پارامتر share | پارامترهای share نامعتبر |
| 2018166 | دسترسی SDK نامعتبر | دسترسی وجود ندارد |
| 2018171 | فقط برای گیرندگان اصلی/ثانویه | دسترسی محدود است |
| 2018218 | هیچ پروفایلی در دسترس نیست | کاربر از طریق شماره تلفن ساخته شده است |
| 2018234 | دیده‌شدن رد شد | جداسازی گیرنده ثانویه |
| 2018247 | دسترسی‌های پروفایل ناکافی | دسترسی‌های User Profile وجود ندارد |
| 2018300 | برنامه دیگری رشته گفتگو را کنترل می‌کند | رویداد hand-off فعال است |
| 2018321 | جریان پرسش و پاسخ خودکار فعال است | صبر کنید تا جریان تمام شود |
| 2071010 | روش SDK پشتیبانی‌نشده | کلاینت Messenger را به‌روزرسانی کنید |
| 2071011 | Messenger Extensions غیرفعال است | دامنه در فهرست مجاز نیست یا کلاینت قدیمی است |
| 2071014–1025 | فیلدهای محتوای پیام نامعتبر | عنوان‌ها، URLها، پیوست‌ها، الگوها نامعتبر |
| 9000001 | پیام حذف شد | نمی‌توان محتوای حذف‌شده را بازیابی کرد |
| OAuthException | مشکل احراز هویت | خطای عمومی OAuth |
| 2018389 | صفحه در فهرست مجاز نیست | صفحه باید در فهرست مجاز قرار گیرد |
| 2018390 | شناسه تماس نامعتبر | عدم تطابق شناسه تماس |
| 2018391 | پارامتر اتصال نامعتبر | نمی‌تواند خالی باشد |
| 2018392 | پارامتر SDP نامعتبر | باید از مشخصات JSON dict پیروی کند |
| 2018393 | شرکت‌کننده تماس نامعتبر | صفحه بخشی از تماس نیست |
| 2018394 | دسترسی‌های ناکافی برای پیوستن به تماس | صفحه دسترسی ندارد |
| 2018395 | نمی‌توان به تماس ناموفق پیوست | منتظر callback بمانید |
| 2018396 | نمی‌توان به تماس پایان‌یافته پیوست | تماس قبلاً پایان یافته است |
| TBD | از محدودیت نرخ تماس فراتر رفته است | بسامد تماس را کاهش دهید |