محدودیت نرخ درخواست

اینجا دو چیز متفاوت محدود می‌شوند و رفتارشان برعکس یکدیگر است.

اگر این تفاوت را درست بفهمید، بقیهٔ این صفحه از آن نتیجه می‌شود: 429 همیشه یعنی شما با سرعت زیادی ما را فراخوانی می‌کنید و هرگز به این معنا نیست که پاسخی به مشتری شما دور ریخته شده است.

محدودیت درخواست‌های شما

به‌طور پیش‌فرض ۳۰۰ درخواست در دقیقه، که برای هر حساب شمرده می‌شود نه برای هر کلید API؛ بنابراین کلیدهای بیشتر ظرفیت بیشتری به شما نمی‌دهند.

این محدودیت یکی از ابعاد بسته است. اگر یکپارچه‌سازی شما واقعاً به ظرفیت بیشتری نیاز دارد، این عدد برای حساب شما بالا برده می‌شود، نه با تغییر یک عدد مشترک. با مدیر حساب خود تماس بگیرید.

پنجرهٔ زمانی لغزان است: ۶۰ ثانیهٔ اخیر را پیوسته می‌شماریم و شمارش با شروع هر دقیقهٔ ساعت صفر نمی‌شود؛ بنابراین نمی‌توانید سهم یک دقیقه را در انتهای یک پنجره و سهم دقیقهٔ بعد را در ابتدای پنجرهٔ بعدی مصرف کنید.

وقتی از آن فراتر بروید:

{
  "error": {
    "code": "rate_limited",
    "message": "API rate limit exceeded. Slow down and retry shortly.",
    "request_id": "req_8f2Kq9mR",
    "details": { "limit_per_minute": 300, "window_seconds": 60 }
  }
}

details عددی را که به آن محدود هستید نام می‌برد؛ بنابراین بدون پرسیدن از ما می‌توانید محدودیت افزایش‌یافته را از مقدار پیش‌فرض تشخیص دهید.

محدودیت‌های اینستاگرام

این محدودیت‌ها برای هر حساب اینستاگرام اعمال می‌شوند، نه برای هر اپلیکیشن، کلید یا بسته. هیچ بستهٔ پارس‌چت آن‌ها را بالا نمی‌برد.

پیام‌رسانی جدا از بودجهٔ ایمپرشن (پایین‌تر) شمرده می‌شود؛ بنابراین ارسال دایرکت از سهمیه‌ای که خواندن کامنت‌ها مصرف می‌کند کم نمی‌کند.

محدودیت تعیین‌کننده، ۷۵۰ در ساعت است

پاسخ خصوصی دایرکتی است که با کامنت یک نفر فرستاده می‌شود؛ هستهٔ اتوماسیون کامنت به دایرکت. برای کامنت‌های زیر پست یا ریلز ۷۵۰ پاسخ در ساعت دارید؛ یعنی به‌طور پیوسته تقریباً یکی در هر پنج ثانیه، و این عدد با بزرگ شدن حساب بیشتر نمی‌شود.

کامنت‌های پخش زنده (لایو) فرق دارند: ۱۰۰ در ثانیه، سقفی ۴۸۰ برابر بالاتر. اگر برای فروش در لایو می‌سازید، بر اساس ۷۵۰ برنامه‌ریزی نکنید؛ این عدد شامل شما نمی‌شود. فروش در لایو الگوی رایجی در اینستاگرام است و این دو محدودیت آن‌قدر با هم فاصله دارند که فرض کردن محدودیت سخت‌گیرانه‌تر باعث می‌شود ترافیکی را که می‌توانستید فوراً بفرستید در صف بگذارید.

سقف‌های ارسال (۱۰۰ در ثانیه، ۱۰ در ثانیه) چندین مرتبه بزرگ‌تر از هر چیزی هستند که این محصول تولید می‌کند. فقط برای کامل بودن فهرست شده‌اند و لازم نیست طراحی خود را بر اساس آن‌ها انجام دهید.

بودجهٔ ایمپرشن

هر چیزی که پیام‌رسانی نیست (خواندن کامنت‌ها، پاسخ عمومی، پنهان کردن، فهرست کردن پست‌ها) از یک بودجهٔ مشترک ۲۴ ساعته استفاده می‌کند:

calls per 24h = 4,800 × impressions in the last 24h

نتیجهٔ آن خلاف انتظار است و باید صریح گفته شود: یک حساب پرمخاطب عملاً سهمیهٔ نامحدود دارد و یک حساب کم‌مخاطب تقریباً هیچ.

معمولاً این مشکلی ندارد، چون حجم کار با میزان دیده شدن بالا می‌رود: صفحه‌ای که کسی آن را نمی‌بیند کامنتی هم برای پاسخ دادن نمی‌گیرد. پرس‌وجوی دوره‌ای استثناست، چون با گذر زمان بالا می‌رود.

در صفحه‌ای با یک ایمپرشن در روز کل بودجه ۴٬۸۰۰ است و پرس‌وجوی دوره‌ای به‌تنهایی ۶۰٪ آن را بدون هیچ نتیجه‌ای مصرف می‌کند.

پنجرهٔ ۲۴ ساعتهٔ پاسخ

برای پاسخ به پیام کاربر نهایی ۲۴ ساعت فرصت دارید. پس از آن اینستاگرام پاسخ را رد می‌کند، هر چه قوانین اتوماسیون شما بگویند.

این محدودیت از همه سخت‌تر است، چون کند شدن نیست. پاسخی که در ساعت ۲۵ فرستاده شود دیر نمی‌رسد؛ اصلاً نمی‌رسد.

به اپراتورهای خود نشان دهید چقدر از زمان یک گفتگو مانده است، به‌جای اینکه با ناتوانی در پاسخ دادن متوجه این پنجره شوند.

تاریخچهٔ پیام‌ها در ۲۰ پیام متوقف می‌شود

اینستاگرام فقط ۲۰ پیام آخر یک گفتگو را برمی‌گرداند. پیام‌های قدیمی‌تر صفحه‌بندی نمی‌شوند؛ اصلاً در دسترس نیستند.

به همین دلیل تحویل وب‌هوک مهم‌تر از آن است که به نظر می‌رسد: اگر اندپوینت شما از کار بیفتد، نمی‌توانید آنچه را از دست داده‌اید فراتر از همان ۲۰ پیام بازیابی کنید. قطعی وب‌هوک را نمی‌توان بعداً جبران کرد.

با خطاهای تحویل مثل چیزی رفتار کنید که باید برایش هشدار بدهید، نه چیزی که بعداً تطبیقش دهید.

پاسخ‌ها در صف می‌مانند، دور ریخته نمی‌شوند

وقتی پاسخی را نمی‌توان فوراً فرستاد (چون اینستاگرام آن را رد کرده یا صف ارسال خود ما در حال خالی شدن است)، نگه داشته می‌شود و بعداً ارسال می‌شود. هیچ چیزی دور ریخته نمی‌شود.

چرا صف به‌جای رد کردن: درخواست‌هایی که نگه داشته می‌شوند پاسخ‌های خودکار به یک انسان واقعی هستند که به یک فروشگاه پیام داده است. دور ریختن یکی از آن‌ها به قیمت از دست رفتن گفتگو با یک مشتری تمام می‌شود و شما هم عملاً نمی‌توانستید آن را دوباره بفرستید. تا وقتی متوجه شوید، فرصت گذشته است.

صف تا دو ساعت نگه می‌دارد

یک پاسخ در صف حداکثر ۲ ساعت نگه داشته می‌شود. پس از آن دور ریخته و ثبت می‌شود.

پاسخ فقط تا وقتی ارزش فرستادن دارد که فرد هنوز در گفتگو حاضر است. بعد از چند ساعت، کاربر نهایی سراغ کار دیگری رفته است. پاسخی که آن موقع برسد به کسی می‌رسد که سؤالش را فراموش کرده و محصول شما را نامنظم نشان می‌دهد، نه کند.

دو ساعت خودِ حجم صف را هم محدود می‌کند: صف با زمان محدود می‌شود، نه با یک سقف جداگانه برای عمق آن.

آنچه می‌بینید

پس 429 همیشه یعنی «شما با سرعت زیادی ما را فراخوانی می‌کنید». هرگز به این معنا نیست که «پاسخ مشتری شما دور ریخته شد.»

فایل، صدا و سند

اندازهٔ پیوست یکی از ابعاد بسته است. محدودیت‌ها برای هر فایل و هنگام بارگذاری بررسی می‌شوند.

نگارش‌های جایگزین رایج هم پذیرفته می‌شوند (image/jpg، video/avi، audio/m4a، audio/wave، audio/x-wav، audio/vnd.wave). این دقیقاً همان چیزی است که اینستاگرام تحویل می‌دهد: GIF، WebP و قالب‌های دیگر هنگام بارگذاری رد می‌شوند، نه اینکه پذیرفته شوند و بعد هنگام ارسال خطا بدهند.

هر بسته‌ای که دسترسی API دارد هر چهار نوع را می‌فرستد؛ تفاوت سطح‌ها در اندازه است، نه در نوع فایل‌هایی که می‌توانید بفرستید.

اگر قرارداد شما سقف‌های دیگری تعیین کرده باشد، همان‌ها به‌جای جدول بالا اعمال می‌شوند.

چه چیزی شمرده می‌شود

بارگذاری‌های ارسال‌نشده پس از ۲۴ ساعت منقضی می‌شوند

پیوستی که بارگذاری کنید ولی هرگز نفرستید، پس از ۲۴ ساعت دور ریخته می‌شود.

نزدیک به زمان ارسال بارگذاری کنید. جریان دومرحله‌ای برای این است که بتوانید بارگذاری بزرگ را بدون فرستادن دوبارهٔ پیام تکرار کنید، نه برای اینکه فایل‌ها را از قبل آماده نگه دارید.

گفتگوها تا چه مدت نگه داشته می‌شوند

تاریخچهٔ گفتگوها برای مدتی که بسته تعیین می‌کند نگه داشته می‌شود و سپس حذف می‌شود.

مدت نگه‌داری چه کانال فعال باشد چه نباشد سپری می‌شود؛ غیرفعال کردن یک کانال پیکربندی و قوانین آن را حفظ می‌کند، اما زمان گفتگوهای آن را متوقف نمی‌کند. هر چیزی را که لازم دارید فراتر از این بازه نگه دارید، خروجی بگیرید.

برای چه چیزی بسازید