وقتی بسته منقضی می‌شود

نسخه پیش‌انتشار v1، منتشرشده در ۲۰۲۶-۰۹-۱۴. این صفحه شکل API را تعهد می‌کند، نه تاریخ آن را. دقیقاً همین چیزی را که این‌جا مستند شده می‌سازیم. شکل API تا ۲۰۲۶-۱۰-۱۴ هنوز ممکن است تغییر کند؛ پس از آن، تغییرات از نسخه‌بندی و پایداری پیروی می‌کنند.

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

انقضا در دو مرحله اتفاق می‌افتد. بسته‌ای که منقضی می‌شود، دسترسی مشتری را سر ساعت دوازده شب قطع نمی‌کند.

مرحله	بازه زمانی	نوشتن از طریق API	تحویل رویدادها	هوش مصنوعی
مهلت	حدود ۱ روز پس از انقضا	`403 plan_inactive` هنگام ایجاد	✅	❌
غیرفعال	پس از مهلت، در صورت پرداخت‌نشدن	`403` هنگام ایجاد	❌	❌

آنچه همچنان کار می‌کند

خواندن (GET) در تمام این مدت کار می‌کند. همیشه می‌توانید وضعیت خودتان را ببینید، از جمله ربات‌ها، کانال‌ها، مصرف و پیکربندی؛ حتی وقتی بسته کاملاً غیرفعال شده باشد. شریکی که در میانه یک اختلاف صورتحساب از داده‌های خودش محروم شود، وضعیت بدتری دارد تا شریکی که نمی‌تواند ربات تازه بسازد.

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

هیچ چیزی حذف نمی‌شود

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

فعال‌سازی دوباره پس از تمدید

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

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

curl https://api-chat.parstechai.com/v1/robots/rbt_8fK2mQ/channels \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxx"

هر کانالی که هنوز "is_active": false نشان می‌دهد، باید خودتان فعالش کنید و انتخاب اینکه کدام‌ها، با شماست:

curl -X PATCH https://api-chat.parstechai.com/v1/robots/rbt_8fK2mQ/channels/chn_3pQ7xL \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"is_active": true}'

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

می‌توانید یک کانال را آگاهانه هم با {"is_active": false} غیرفعال کنید. این روش درست برای متوقف‌کردن صفحه یک مشتری است، طوری که تاریخچه، قانون‌ها و پیکربندی او برای زمان بازگشتش آماده بماند و هزینه‌ای بابت یک جایگاه نپردازید. ببینید: فعال یا غیرفعال‌کردن یک کانال.

چه باید بکنید

خطای 403 plan_inactive را در نوشتن‌ها مدیریت کنید

آن را به‌عنوان یک وضعیت صورتحساب به مشتری نشان دهید، نه یک خطای سیستمی. این خطا گذرا نیست و تلاش دوباره کمکی نمی‌کند.

به خواندن ادامه دهید

فراخوانی‌های GET شما همچنان کار می‌کنند. با آن‌ها دقیقاً به مشتری نشان دهید چه چیزی متوقف شده است.

حذف نکنید و از نو نسازید

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

پس از تمدید، بررسی کنید چه چیزی برگشته است

کانال‌هایتان را فهرست کنید و هر کدام را که هنوز is_active: false است فعال کنید؛ مهم‌ترین‌ها را اول.