> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-parschat.parstechai.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-parschat.parstechai.com/_mcp/server.

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

> محدودیت‌های اینستاگرام هستند که تعیین‌کننده‌اند. ما سقف جداگانه‌ای برای هر بسته اضافه نمی‌کنیم و پاسخ‌هایی که نمی‌توانیم فوراً بفرستیم در صف می‌مانند و دور ریخته نمی‌شوند.

> **Warning**
>
> **نسخهٔ پیش‌انتشار `v1`، منتشرشده در ۲۰۲۶-۰۹-۱۴.** این صفحه به شکل API متعهد است، نه به یک
> تاریخ. دقیقاً همان چیزی را می‌سازیم که اینجا مستند شده است. شکل API تا **۲۰۲۶-۱۰-۱۴** هنوز ممکن
> است تغییر کند؛ پس از آن، تغییرات از [نسخه‌بندی و پایداری](/documentation/reference/versioning-stability) پیروی می‌کنند.
>
> این بنر با راه‌اندازی هر مسیر، صفحه به صفحه برداشته می‌شود. تا وقتی اینجاست، بر اساس قرارداد
> بسازید و فرض کنید این مسیر هنوز قابل فراخوانی نیست.

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

|                                             | محدودیت                              | وقتی به آن برسید چه می‌شود                                     |
| ------------------------------------------- | ------------------------------------ | -------------------------------------------------------------- |
| **درخواست‌هایی که شما به ما می‌فرستید**     | **۳۰۰ در دقیقه**، بر اساس بستهٔ شما  | `429`. شما دوباره تلاش می‌کنید                                 |
| **پاسخ‌هایی که ما به اینستاگرام می‌فرستیم** | محدودیت خود اینستاگرام، برای هر حساب | **در صف می‌ماند و بعداً ارسال می‌شود.** هرگز دور ریخته نمی‌شود |

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

## محدودیت درخواست‌های شما \[#your-call-limit]

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

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

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

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

```json
{
  "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` عددی را که به آن محدود هستید نام می‌برد؛ بنابراین بدون پرسیدن از ما می‌توانید محدودیت
افزایش‌یافته را از مقدار پیش‌فرض تشخیص دهید.

> **Info**
>
> **عدد ۳۰۰ در دقیقه بر اساس ترافیک واقعی تعیین شده است، نه حدس.** یک همکار تجاری با ۵۰۰ صفحه در
> اوج، از پاسخ‌ها حدود **۷ درخواست در دقیقه** تولید می‌کند. چیزی که واقعاً سهمیه را مصرف می‌کند
> پرس‌وجوی دوره‌ای (polling) است: پرس‌وجوی ۵۰۰ صفحه در هر دقیقه به‌تنهایی ۵۰۰ درخواست در دقیقه
> است. اگر به این محدودیت نزدیک هستید، تقریباً به‌طور قطع چیزی را پرس‌وجو می‌کنید که باید
> [وب‌هوک](/documentation/guides/webhook-events) باشد.

> **Note**
>
> یک سقف ساده برای هر IP هم برای محافظت از زیرساخت در درگاه ما وجود دارد. این سقف بسیار بالاتر از
> محدودیت همهٔ حساب‌ها تنظیم شده است؛ بنابراین شما به محدودیت بالا می‌رسید (که عددش را اعلام
> می‌کند و قابل افزایش است)، نه به یک رد مبهم در درگاه. این سقف بخشی از محصول نیست و فروخته
> نمی‌شود.

## محدودیت‌های اینستاگرام \[#instagrams-limits]

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

| عملیات                                  | محدودیت         | معادل ساعتی |
| --------------------------------------- | --------------- | ----------: |
| ارسال متن، لینک، واکنش و استیکر         | ۱۰۰ در ثانیه    |     ۳۶۰٬۰۰۰ |
| ارسال صدا یا ویدیو                      | ۱۰ در ثانیه     |      ۳۶٬۰۰۰ |
| خواندن گفتگوها                          | ۲ در ثانیه      |       ۷٬۲۰۰ |
| پاسخ خصوصی به کامنت زیر **پست یا ریلز** | **۷۵۰ در ساعت** |     **۷۵۰** |
| پاسخ خصوصی به کامنت در **لایو**         | ۱۰۰ در ثانیه    |     ۳۶۰٬۰۰۰ |

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

### محدودیت تعیین‌کننده، ۷۵۰ در ساعت است \[#750-per-hour-is-the-one-that-binds]

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

> **Info**
>
> این سقف با **موفقیت** پر می‌شود، نه با سوءاستفاده. یک پست که به‌طور غیرعادی خوب دیده شود آن را
> تمام می‌کند و هیچ بسته‌ای آن را بالا نمی‌برد.

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

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

## بودجهٔ ایمپرشن \[#the-impressions-budget]

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

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

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

| ایمپرشن در ۲۴ ساعت | درخواست‌های در دسترس |
| -----------------: | -------------------: |
|             ۱۰٬۰۰۰ |           ۴۸٬۰۰۰٬۰۰۰ |
|              ۱٬۰۰۰ |            ۴٬۸۰۰٬۰۰۰ |
|                ۱۰۰ |              ۴۸۰٬۰۰۰ |
|                 ۱۰ |               ۴۸٬۰۰۰ |
|                  ۰ |                    ۰ |

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

|                               |          درخواست در روز |
| ----------------------------- | ----------------------: |
| پرس‌وجوی کامنت‌ها هر ۳۰ ثانیه | ۲٬۸۸۰، حتی با صفر کامنت |
| وب‌هوک، با پاسخ به ۲۰۰ کامنت  |                     ۲۰۰ |

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

> **Warning**
>
> **برای پیام‌ها یا کامنت‌های جدید پرس‌وجوی دوره‌ای نکنید.** از [رویدادهای وب‌هوک](/documentation/guides/webhook-events)
> استفاده کنید. تحویل وب‌هوک هیچ هزینه‌ای از این بودجه ندارد، اما در یک حساب کوچک، پرس‌وجوی دوره‌ای
> به‌تنهایی می‌تواند کل سهمیهٔ روزانهٔ مشتری شما را تمام کند.

## پنجرهٔ ۲۴ ساعتهٔ پاسخ \[#the-24-hour-reply-window]

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

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

|             |                                                            |
| ----------- | ---------------------------------------------------------- |
| شروع زمان   | آخرین پیام کاربر نهایی                                     |
| شامل        | همهٔ پاسخ‌ها، چه خودکار و چه از طرف اپراتور                |
| پس از پایان | ارسال ناموفق می‌شود. هیچ صف یا تلاش دوباره‌ای کمکی نمی‌کند |

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

## تاریخچهٔ پیام‌ها در ۲۰ پیام متوقف می‌شود \[#message-history-stops-at-20]

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

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

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

## پاسخ‌ها در صف می‌مانند، دور ریخته نمی‌شوند \[#replies-are-queued-not-dropped]

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

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

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

### صف تا دو ساعت نگه می‌دارد \[#the-queue-holds-for-two-hours]

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

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

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

### آنچه می‌بینید \[#what-you-see]

|                             |                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **درخواست‌های API خود شما** | `429 rate_limited`، با نام محدودیت شما در `details`. این‌ها را *می‌توانید* به‌طور معنادار دوباره امتحان کنید |
| **پاسخ‌های خودکار خروجی**   | هرگز رد نمی‌شوند. در صف می‌مانند و با آزاد شدن ظرفیت ارسال می‌شوند                                           |

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

> **Note**
>
> وضعیت محدودیت نرخ خود اینستاگرام را از طریق این API منتقل نمی‌کنیم. اگر درخواستی به این دلیل
> ناموفق شود که اینستاگرام آن را رد کرده (نه ما)، آن را به‌صورت یک ارسال ناموفق می‌بینید، نه `429`.

## فایل، صدا و سند \[#files-voice-and-documents]

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

| نوع                 |      Basic |   Professional | نوع‌های پذیرفته‌شده                                                                            |
| ------------------- | ---------: | -------------: | ---------------------------------------------------------------------------------------------- |
| **تصویر**           |  ۲ مگابایت |  **۴ مگابایت** | `image/jpeg` · `image/png`                                                                     |
| **ویدیو**           | ۱۰ مگابایت | **۲۰ مگابایت** | `video/mp4` · `video/quicktime` (.mov) · `video/webm` · `video/ogg` · `video/x-msvideo` (.avi) |
| **پیام صوتی / صدا** |  ۵ مگابایت | **۱۰ مگابایت** | `audio/aac` · `audio/mp4` · `audio/x-m4a` · `audio/wav`                                        |
| **سند**             |  ۵ مگابایت | **۱۰ مگابایت** | `application/pdf`                                                                              |

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

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

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

> **Info**
>
> این‌ها محدودیت‌های **ما** هستند، نه اینستاگرام. اینستاگرام اندازه‌های بسیار بزرگ‌تری را مجاز
> می‌داند (۸ مگابایت برای تصویر و ۲۵ مگابایت برای بقیه). ما عمداً سقف پایین‌تری گذاشته‌ایم: پذیرفتن
> سقف‌های اینستاگرام فضای ذخیره‌سازی پایدار را بیش از دو برابر می‌کرد، برای قابلیتی که تقریباً کسی
> از آن استفاده نمی‌کند.

### چه چیزی شمرده می‌شود \[#what-counts]

|                                 |                                                                          |
| ------------------------------- | ------------------------------------------------------------------------ |
| برای هر **فایل**، نه هر پیام    | پیامی با سه تصویر سه بار بررسی می‌شود                                    |
| هنگام **بارگذاری** بررسی می‌شود | `POST /attachments` ناموفق می‌شود، نه ارسال بعدی                         |
| خارج از فهرست مجاز              | `422 validation_failed`، پیش از ذخیرهٔ هر چیزی                           |
| بیش از سقف بستهٔ شما            | `422 validation_failed`، با `kind`، `cap_mb` و `size_bytes` در `details` |
| نوعی که بستهٔ شما شامل آن نیست  | `403 attachment_not_in_plan`                                             |

> **Info**
>
> پیام صوتی یک پیوست عادی با `type: voice` است، بنابراین محدودیت صدا شامل آن می‌شود. با نرخ ۶۴
> کیلوبیت بر ثانیه (نرخ معمول پیام صوتی) **۵ مگابایت حدود ۱۰ دقیقه** و **۱۰ مگابایت حدود ۲۱ دقیقه**
> است؛ بنابراین در عمل اندازه به‌ندرت محدودکننده است.

### بارگذاری‌های ارسال‌نشده پس از ۲۴ ساعت منقضی می‌شوند \[#unsent-uploads-expire-after-24-hours]

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

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

## گفتگوها تا چه مدت نگه داشته می‌شوند \[#how-long-conversations-are-kept]

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

| بسته             | بسته‌های اینستاگرام | بسته‌های استاندارد |
| ---------------- | ------------------- | ------------------ |
| **Basic**        | ۶ ماه               | ۶ ماه              |
| **Business**     | —                   | ۱ سال              |
| **Professional** | ۱ سال               | ۱ سال              |

> **Note**
>
> اگر یک حساب بیش از یک اشتراک داشته باشد، **طولانی‌ترین مدت نگه‌داری اعمال می‌شود.** مدت نگه‌داری یک
> بازهٔ زمانی است، نه سهمیه: جمع کردن یک بستهٔ ۶ ماهه و یک بستهٔ ۱ ساله برای رسیدن به ۱۸ ماه بی‌معناست،
> و انتخاب کوتاه‌ترین مدت، تاریخچه‌ای را حذف می‌کند که مشتری برای نگه داشتنش هزینهٔ سطح بالاتر را
> پرداخته است.

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

## برای چه چیزی بسازید \[#what-to-build-for]

| محدودیت                                            | چه کسی آن را جذب می‌کند     | شما چه باید بکنید                                   |
| -------------------------------------------------- | --------------------------- | --------------------------------------------------- |
| ۳۰۰ درخواست در دقیقهٔ **شما**                      | تلاش دوباره روی `429`       | فاصله بیندازید و پرس‌وجوی دوره‌ای را کنار بگذارید   |
| سقف هر IP در درگاه                                 | بسیار بالاتر از محدودیت شما | هیچ. اول به محدودیت خودتان می‌رسید                  |
| **۷۵۰ پاسخ خصوصی در ساعت** اینستاگرام (پست و ریلز) | صف ما آن‌ها را نگه می‌دارد  | در پست‌های وایرال انتظار تأخیر داشته باشید          |
| پاسخ‌های خصوصی **لایو** اینستاگرام (۱۰۰ در ثانیه)  | —                           | هیچ. اینجا بر اساس ۷۵۰ برنامه‌ریزی نکنید            |
| **پنجرهٔ ۲۴ ساعتهٔ** اینستاگرام                    | هیچ‌کس                      | درون پنجره پاسخ دهید                                |
| **بودجهٔ ایمپرشن** اینستاگرام                      | قابل اجتناب                 | از وب‌هوک استفاده کنید، هرگز پرس‌وجوی دوره‌ای نکنید |
| **تاریخچهٔ ۲۰ پیامی** اینستاگرام                   | هیچ‌کس                      | اندپوینت وب‌هوک خود را سالم نگه دارید               |
| اندازهٔ پیوست                                      | —                           | پیش از بارگذاری، سقف‌های بستهٔ خود را بررسی کنید    |