> 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.

# تغییرات نسخه‌ها

> هر تغییر در قرارداد v1، با تاریخ، از جمله تغییراتی که در دوره پیش‌انتشار اعمال می‌شوند.

> **Info**
>
> تا وقتی `v1` در مرحله پیش‌انتشار است، **شکل API هنوز ممکن است تغییر کند**. بنر پیش‌انتشار
> همین را می‌گوید. هر تغییر اینجا ثبت می‌شود، تا دقیقاً ببینید چه چیزی جابه‌جا شده و تصمیم بگیرید
> آیا روی یکپارچه‌سازی شما اثر دارد یا نه.

## ۲۰۲۶-۰۹-۱۴: انتشار `v1`

اولین نسخه عمومی قرارداد. هرچه در ادامه آمده، تعهد اولیه است.

**اندپوینت‌ها**: ربات‌ها، کانال‌ها، قانون‌های خودکارسازی، رسانه، مصرف، و یک اندپوینت فقط‌خواندنی
برای تنظیمات وب‌هوک.

**رویدادهای وب‌هوک**: `message`، `message.generating`، `chat`، `reaction`، `is_typing`.

**تصمیم‌هایی که باید به آن‌ها توجه کرد**، چون هر کدام چیزی را که می‌سازید تغییر می‌دهد:

| تصمیم                                                                     | چرا                                                                             |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| هیچ اندپوینتی برای نوشتن وب‌هوک وجود ندارد                                | کلید دزدیده‌شده نباید بتواند جریان رویدادهای شما را منحرف کند                   |
| توکن احراز هویت وب‌هوک را **خودتان** تعیین می‌کنید                        | این توکن فقط از اندپوینت خود شما محافظت می‌کند، پس منتظر ما ماندن فقط دردسر بود |
| محدودیت نرخ درخواست، درخواست‌ها را **در صف می‌گذارد** و هرگز دور نمی‌ریزد | پاسخ خودکاری که دور ریخته شود، یعنی از دست رفتن گفتگو با مشتری                  |
| `context_reset` به معنای حذف نیست                                         | اگر آن را حذف فرض کنید، متن گفتگویی را دور می‌ریزید که ما هنوز نگه‌اش داشته‌ایم |
| `follows_business: null` به‌صورت **باز** (fail open) تفسیر می‌شود         | `null` یعنی «Meta تأیید نکرد»، نه «دنبال نمی‌کند»                               |
| `404` و نه `403` برای منابع دیگران                                        | `403` وجود آن شناسه را تأیید می‌کرد                                             |

## تغییرات چطور اعلام می‌شوند

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

برای قواعد کامل اینکه چه تغییری ناسازگار حساب می‌شود، [نسخه‌بندی و پایداری](/documentation/reference/versioning-stability) را ببینید.