#P1566
POST /api/v2/support/ticket/update
Route Info
| Method | Endpoint | Controller |
| POST | /api/v2/support/ticket/update | OfficialController@updateTicketSupport |
شرح عملکرد (Functionality)
این متد برای بروزرسانی اطلاعات مختلف یک تیکت استفاده میشود. ساختار کد به صورت if/else if است، به این معنی که در هر درخواست تنها یکی از عملیات زیر بر اساس اولویت پارامتر ارسالی انجام میشود:
- تغییر وضعیت (Status): اگر پارامتر
statusارسال شود:- وضعیت تیکت آپدیت میشود.
- یک یادداشت خودکار (System Note) متناسب با وضعیت جدید (مثلاً: "مورد شما در حال بررسی میباشد...") توسط اپراتور جاری در تیکت درج میشود.
- اگر تیکت هنوز اپراتوری نداشت (
operator IS NULL)، اپراتور جاری به عنوان مسئول تیکت ثبت میشود.
- ثبت امتیاز (Score): اگر پارامتر
scoreارسال شود، امتیاز کاربر به تیکت ثبت میشود. - ارجاع به دپارتمان (Department): اگر پارامتر
departmentارسال شود، تیکت به دپارتمان دیگری منتقل میشود. - تخصیص کارشناس (Operator): اگر پارامتر
operatorارسال شود:- مسئول تیکت به شناسه ارسالی تغییر میکند.
- یک اعلان (Notification) تلگرامی برای کارشناس انتخاب شده ارسال میشود که حاوی لینک مشاهده تیکت است.
پارامترهای ورودی (Input Parameters)
| نام پارامتر | نوع | الزامی؟ | توضیحات |
|---|---|---|---|
| ticket | Integer | بله | شناسه تیکت مورد نظر برای ویرایش. |
| status | Integer | اختیاری* | وضعیت جدید تیکت (1 تا 5). در صورت ارسال، اولویت با این فیلد است. |
| score | Integer | اختیاری* | امتیاز دهی به تیکت (معمولاً 1 تا 5). |
| department | Integer | اختیاری* | شناسه دپارتمان جدید جهت انتقال تیکت. |
| operator | Integer | اختیاری* | شناسه کارشناس جهت ارجاع دستی تیکت. |
* نکته: در هر درخواست باید فقط یکی از پارامترهای اختیاری ارسال شود تا عملیات مربوطه انجام گیرد.
نمونه خروجی (Response)
{
"status": true,
"time": 1732621500
}