الدعم

البادئة: /v1/support على الواجهة العامة.

يفتح العملاء تذاكر من التطبيق. التصنيفات عامة؛ إنشاء التذاكر وقراءتها تتطلب JWT عميل (Authorization: Bearer).

النقاط

الطريقة	المسار	المصادقة	الغرض
GET	/v1/support/categories	عامة	تصنيف نموذج الإنشاء
GET	/v1/support/tickets	عميل	تذاكري (صفحات؛ status اختياري)
POST	/v1/support/tickets	عميل	فتح تذكرة
GET	/v1/support/tickets/:ticketId	عميل	محادثة يملكها العميل
POST	/v1/support/tickets/:ticketId/messages	عميل	رد
PATCH	/v1/support/tickets/:ticketId	عميل	{ "action": "confirm" | "reopen" }

التصنيفات

يرجع GET /v1/support/categories قيم category المسموحة وقوائم subcategory. استخدم تلك السلاسل عند الإنشاء؛ لا تخترع قيماً.

category	الاستخدام المعتاد
order	أصناف ناقصة / خاطئة، الكمية
delivery	تأخير، سائق، عنوان خاطئ، زيارة فاشلة
payment	نزاعات الرسوم
wallet	الرصيد، الرصيد الدائن، الاسترداد للمحفظة
account	الدخول، الملف، الحذف
product	تالف، منتهٍ، جودة
subscription	فوترة برو / الوصول
other	أي شيء آخر

بعض التصنيفات تتطلب orderId و/أو productIds حسب قواعد النموذج المُرجعة مع التصنيف.

الإنشاء

الجسم

الحقل	مطلوب	ملاحظات
subject	نعم	حد أقصى 200
category	نعم	من التصنيف
subcategory	لا	من قائمة ذلك التصنيف
orderId	لا	ربط طلب يملكه العميل
productIds	لا	معرّفات منتجات
body	نعم	حد أقصى 4000
attachmentUrls	لا	روابط وسائط مرفوعة مسبقاً

POST /v1/support/tickets
Content-Type: application/json
Authorization: Bearer <accessToken>

{
  "subject": "حليب ناقص",
  "category": "order",
  "subcategory": "missing_items",
  "orderId": "665f0c0c0c0c0c0c0c0c0c10",
  "body": "صنف واحد لم يكن في الكيس."
}

يشمل results الحقلين ticketId وmessage.

الرد والتحديث

جسم الرد: نص الرسالة وattachmentUrls اختياري.

PATCH action:

action	متى
confirm	العميل يقبل الحل
reopen	العميل يريد إعادة فتح التذكرة

يرد الموظفون من اللوحة. يتلقى العملاء أيضاً إشعارات داخل التطبيق (support.ticket_created، support.replied، support.resolved).

يمكن لمحادثات المساعد إنشاء تذكرة عبر التحويل.