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

# API پارس‌چت

> ربات بسازید، کانال‌ها را وصل کنید، پاسخ‌های اینستاگرام را خودکار کنید و هر گفتگو را به‌صورت رویداد وب‌هوک دریافت کنید.

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

با API پارس‌چت می‌توانید **ربات** بسازید، **کانال‌های** آن را وصل کنید، پاسخ‌های اینستاگرام را
خودکار کنید و هر گفتگو را روی وب‌هوک خودتان دریافت کنید.

```
https://api-chat.parstechai.com/v1
```

#### [شروع سریع](/documentation/get-started/quickstart)

یک ربات بسازید، یک کانال وصل کنید و اولین رویدادتان را دریافت کنید.

#### [مفاهیم اصلی](/documentation/get-started/core-concepts)

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

#### [اتصال اینستاگرام](/documentation/guides/connect-instagram)

یک ریدایرکت در مرورگر، نه یک فراخوانی API. پیش از ساختن این جریان، این صفحه را بخوانید.

#### [پاسخ به مشتریان](/documentation/guides/replying-to-customers)

از پنل خودتان با متن، فایل و پیام صوتی به مشتریان نهایی پاسخ دهید.

#### [رویدادهای وب‌هوک](/documentation/guides/webhook-events)

تحویل، تلاش دوباره و همه محتواهای رویداد.

## دسترسی به API

دسترسی به API همراه با بسته ارائه می‌شود. بسته‌ای بخرید که این دسترسی را داشته باشد تا API روی حساب‌تان فعال شود:

| بسته                                               | دسترسی به API |
| -------------------------------------------------- | :-----------: |
| **تجاری**                                          |       ✅       |
| **حرفه‌ای**                                        |       ✅       |
| **بسته API اینستاگرام** (تماس با فروش)             |       ✅       |
| پایه، و بسته‌های رایگان، پایه و حرفه‌ای اینستاگرام |       —       |

برای جزئیات به‌روز، [قیمت‌ها](https://parstechai.com/products/parschat/) را ببینید.

چند عملیات به‌جای همه بسته‌ها فقط برای شرکای تجاری در نظر گرفته شده است: ساخت و حذف ربات،
و اتصال کانال اینستاگرام. برای این موارد با [تیم فروش ما تماس بگیرید](mailto:info@parstechai.com).

## چه چیزی را کجا تنظیم می‌کنید

وقتی بسته را تهیه کردید، API را خودتان در
[chat.parstechai.com](https://chat.parstechai.com) راه‌اندازی می‌کنید.

|                 |                                                |
| --------------- | ---------------------------------------------- |
| **کلید API**    | از پنل‌تان کپی کنید                            |
| **آدرس وب‌هوک** | اندپوینت HTTPS شما. آن را در پنل تنظیم می‌کنید |
| **آدرس بازگشت** | این یکی را به ما بدهید تا تنظیمش کنیم          |

آدرس بازگشت استثناست. این آدرس جایی است که مرورگر مشتری پس از تأیید دسترسی اینستاگرام به آن
می‌رسد، پس پیش از اولین اتصال اینستاگرام آن را برای رابط پارس‌چت خود بفرستید.

## کارهایی که این API انجام نمی‌دهد

#### ساختن یا تعویض کلیدهای API

کلیدها در پنل ساخته می‌شوند، نه از طریق API. ما فقط یک HMAC از کلید را نگه می‌داریم، پس کلید گم‌شده
بازیابی نمی‌شود و باید آن را تعویض کنید.

#### تغییر آدرس بازگشت

آدرس بازگشت تعیین می‌کند مرورگر یک مشتری واقعی در میانه ثبت‌نام به کجا فرستاده شود. اگر
اندپوینتی برای نوشتن آن وجود داشت، یک کلید دزدیده‌شده به ابزاری برای ریدایرکت باز (open redirect) تبدیل می‌شد؛ برای همین
خودمان آن را برایتان تنظیم می‌کنیم.

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

سقف فراخوانی‌های شما از بسته‌تان می‌آید و برای حساب شما قابل افزایش است، اما نه از طریق این API
— از مدیر حساب‌تان بخواهید. محدودیت‌های خود اینستاگرام جداست و هیچ بسته‌ای آن را تغییر نمی‌دهد.
[محدودیت نرخ درخواست](/documentation/guides/rate-limits) را ببینید.