الخدمة 3

تحسين صياغة وصف الشكوى

POST/insaf/description-refinement

ترسل نص الشكوى كما كتبه المشتكي، فتُرجَع صياغة فصحى أوضح مع تقييم لجودته، دون أي تصنيف.

هو نفس الـ description الذي يُرجع في الخدمة رقم 2، لكن منفرداً ودون request_type.

جرّب الطلب

x-velents-api-key

المفتاح يُحفظ في متصفحك فقط ويُرسل مع الطلب عند التجربة.

POSThttps://inbound-api-gateway.velents.ai

Body (JSON)

Request

الحقل	النوع	مطلوب	الشرح
`description`	string	إجباري	نص الشكوى، من 20 إلى 10,000 حرف بعد الـ trim.
`webhook, webhook_headers, webhook_body`	—	اختياري	اختياري لتشغيل الطلب بشكل غير متزامن (انظر الأساسيات المشتركة).

request

curl --location 'https://inbound-api-gateway.velents.ai/insaf/description-refinement' \
--header 'x-velents-api-key: {clientId}|{secret}' \
--header 'Content-Type: application/json' \
--data '{
  "description": "المحامي ما حضر الجلسة الاخيره وما بلغني انها تأجلت، والقاضي اجل القضيه ثلاث مرات بدون سبب"
}'

Response — 200

الحقل	النوع	الشرح
`description.original`	string	النص الأصلي بعد الـ trim.
`description.refined`	string \| null	الصياغة المحسّنة. تكون null إذا أضافت الصياغة أرقاماً غير موجودة في الأصل أو حذفت جزءاً كبيراً منه.
`description.quality.score`	number	من 0 إلى 1. يبدأ من 1 وينقص بوزن كل مشكلة.
`description.quality.issues[]`	string[]	مشاكل الصياغة في النص الأصلي (الجدول أدناه).
`description.changes[]`	string[]	التعديلات التي أُجريت. فارغة إذا كانت refined = null.

مشاكل الصياغة (issues) وأوزانها

Issue	الوزن	المعنى
`too_short`	0.25	النص قصير ولا يحتوي وقائع كافية.
`legal_conclusion_instead_of_facts`	0.2	فيه حكم قانوني بدلاً من وصف ما حدث.
`informal_dialect`	0.2	مكتوب بالعامية.
`run_on_sentence`	0.15	جملة طويلة دون فواصل.
`self_referred_in_third_person`	0.15	المشتكي يتحدث عن نفسه بصيغة الغائب.
`missing_dates`	0.1	لا توجد تواريخ.
`missing_amounts`	0.05	لا توجد مبالغ.
`emotional_language`	0.05	لغة انفعالية.

response

{
  "description": {
    "original": "المحامي ما حضر الجلسة الاخيره وما بلغني انها تأجلت، ...",
    "refined": "تغيب المحامي عن حضور الجلسة الأخيرة، ...",
    "quality": { "score": 0.7, "issues": ["informal_dialect", "missing_dates"] },
    "changes": ["تحويل العامية إلى الفصحى"]
  },
  "apiProcessingDuration": 5,
  "apiProcessingDurationFormatted": "00:05"
}

Errors

Status	Code	السبب
400	`INVALID_INPUT`	description ناقص أو طوله خارج 20–10,000.
502	`ANALYSIS_FAILED / NO_RESULT`	لم تتم الصياغة.
503	`SERVICE_BUSY`	الـ upstream مشغول.

→ تصنيف الشكوى على المخالفات اقتراح القرار على ملف شكوى ←