#P1567
PATCH /api/v2/support/ticket/notice
Route Info
| Method | Endpoint | Controller |
| PATCH | /api/v2/support/ticket/notice | OfficialController@noticeNoteTicketSupport |
شرح عملکرد (Functionality)
این متد برای ارسال دستی اعلان (Notification) به درخواستکننده تیکت (Requester) جهت اطلاعرسانی درباره پاسخ داده شدن به تیکت استفاده میشود. فرآیند به شرح زیر است:
- شناسایی کاربر: ابتدا اطلاعات تماس کاربر درخواستکننده (موبایل، تلگرام و شعبه) از جدول
operatorsبر اساس شناسه تیکت استخراج میشود. - تعیین دامنه لینک: سیستم بررسی میکند که کاربر متعلق به کدام شعبه است. اگر شعبه داشته باشد، دامنه (Domain) اختصاصی آن شعبه از جدول
officesخوانده میشود؛ در غیر این صورت دامنه پیشفرضerp.savosh.comاستفاده میشود. - کانالهای ارسال (بر اساس Type):
- تلگرام: اگر
typeبرابر 1 یا 2 باشد و کاربر شناسه تلگرام داشته باشد، پیام حاوی لینک "مشاهده تیکت" ارسال میشود. - پیامک (SMS): اگر
typeبرابر 2 باشد و کاربر شماره موبایل داشته باشد، پیامک اطلاعرسانی ارسال میشود.
- تلگرام: اگر
- لینک دهی: شناسه تیکت در لینک ارسالی با عدد 10,000 جمع میشود (فرمت نمایش عمومی).
پارامترهای ورودی (Input Parameters)
| نام پارامتر | نوع | الزامی؟ | توضیحات |
|---|---|---|---|
| ticket | Integer | بله | شناسه تیکت مورد نظر. |
| type | Integer | بله | نوع اطلاعرسانی: 1: فقط تلگرام 2: تلگرام و پیامک (SMS) |
نمونه خروجی (Response)
در صورت موفقیت، کد وضعیت 201 (Created) بدون بدنه (Body) بازگردانده میشود.
HTTP/1.1 201 Created
در صورت بروز خطای سیستمی:
{
"error": {
"code": 0,
"message": "Error description...",
"trace": [...]
},
"meta": {
"timestamp": 1732622000
}
}