{"openapi":"3.0.3","info":{"title":"MasterCall API","version":"1.0.0","description":"Arabic-first SaaS API; shared contracts for Sites preview and NestJS."},"servers":[{"url":"https://api.mastercall.ly/api/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/health":{"get":{"summary":"حالة API","operationId":"get_health","security":[],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/health/ready":{"get":{"summary":"جاهزية الخدمات الفعلية","operationId":"get_health_ready","security":[],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/config":{"get":{"summary":"إعدادات الواجهة العامة","operationId":"get_config","security":[],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/openapi.json":{"get":{"summary":"OpenAPI","operationId":"get_openapi_json","security":[],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/login":{"post":{"summary":"تسجيل الدخول","operationId":"post_auth_login","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254},"password":{"type":"string","maxLength":128}},"required":["email","password"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/register":{"post":{"summary":"إنشاء شركة ومساحة عمل","operationId":"post_auth_register","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254},"password":{"type":"string","minLength":12,"maxLength":128},"name":{"type":"string","minLength":2,"maxLength":120},"company":{"type":"string","minLength":2,"maxLength":120},"slug":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,29}[a-z0-9]$"}},"required":["email","password","name","company","slug"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/refresh":{"post":{"summary":"تدوير رمز التحديث","operationId":"post_auth_refresh","security":[],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/logout":{"post":{"summary":"إلغاء الجلسة","operationId":"post_auth_logout","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/logout-all":{"post":{"summary":"إلغاء جميع الجلسات","operationId":"post_auth_logout_all","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/me":{"get":{"summary":"المستخدم ومساحة العمل الحالية","operationId":"get_auth_me","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/sessions":{"get":{"summary":"جلسات المستخدم","operationId":"get_auth_sessions","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/forgot-password":{"post":{"summary":"طلب استعادة الوصول","operationId":"post_auth_forgot_password","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"}},"required":["email"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/dashboard":{"get":{"summary":"مؤشرات مساحة العمل","operationId":"get_dashboard","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/events":{"get":{"summary":"أحداث مساحة العمل","operationId":"get_events","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents":{"get":{"summary":"عرض agents","operationId":"get_agents","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إضافة agents","operationId":"post_agents","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"extension":{"type":"string","pattern":"^\\d{2,6}$"},"team":{"type":"string","maxLength":80,"default":"خدمة العملاء"},"queueId":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"}},"required":["name","extension","queueId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{id}":{"get":{"summary":"تفاصيل agents","operationId":"get_agents__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/queues":{"get":{"summary":"عرض queues","operationId":"get_queues","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إضافة queues","operationId":"post_queues","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"strategy":{"type":"string","enum":["longest_idle","round_robin"]},"slaSeconds":{"type":"integer","minimum":5,"maximum":600},"timeoutSeconds":{"type":"integer","minimum":10,"maximum":3600},"members":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"maxItems":100,"default":[]}},"required":["name","strategy","slaSeconds","timeoutSeconds"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/queues/{id}":{"get":{"summary":"تفاصيل queues","operationId":"get_queues__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/customers":{"get":{"summary":"عرض customers","operationId":"get_customers","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إضافة customers","operationId":"post_customers","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"phone":{"type":"string","maxLength":30},"organization":{"type":"string","maxLength":120,"default":""},"tags":{"type":"array","items":{"type":"string","maxLength":32},"maxItems":10,"default":[]}},"required":["name","phone"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/customers/{id}":{"get":{"summary":"تفاصيل customers","operationId":"get_customers__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/calls":{"get":{"summary":"عرض calls","operationId":"get_calls","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/calls/{id}":{"get":{"summary":"تفاصيل calls","operationId":"get_calls__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/recordings":{"get":{"summary":"عرض recordings","operationId":"get_recordings","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/recordings/{id}":{"get":{"summary":"تفاصيل recordings","operationId":"get_recordings__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flows":{"get":{"summary":"عرض flows","operationId":"get_flows","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إنشاء تدفق","operationId":"post_flows","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"templateId":{"type":"string","enum":["service","simple","sales","support","after_hours","direct","vip","complete_ivr","ring_and_answer","hold_music","missed_callback","post_call_survey","voicemail"],"default":"service"}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flows/{id}":{"get":{"summary":"تفاصيل flows","operationId":"get_flows__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"حفظ مسودة التدفق","operationId":"put_flows__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"type":{"type":"string","maxLength":40},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false},"data":{"type":"object","properties":{"label":{"type":"string","maxLength":120},"config":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":4000},{"type":"number"},{"type":"boolean"}]}}},"required":["label","config"],"additionalProperties":false}},"required":["id","type","position","data"],"additionalProperties":false},"maxItems":150},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":240},"source":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"target":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"sourceHandle":{"type":"string","maxLength":40,"nullable":true},"label":{"type":"string","maxLength":100}},"required":["id","source","target"],"additionalProperties":false},"maxItems":400},"rev":{"type":"integer","minimum":0}},"required":["name","nodes","edges","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/devices":{"get":{"summary":"عرض devices","operationId":"get_devices","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/devices/{id}":{"get":{"summary":"تفاصيل devices","operationId":"get_devices__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/notifications":{"get":{"summary":"عرض notifications","operationId":"get_notifications","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/notifications/{id}":{"get":{"summary":"تفاصيل notifications","operationId":"get_notifications__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/audit_logs":{"get":{"summary":"عرض audit_logs","operationId":"get_audit_logs","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/audit_logs/{id}":{"get":{"summary":"تفاصيل audit_logs","operationId":"get_audit_logs__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/tickets":{"get":{"summary":"عرض tickets","operationId":"get_tickets","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إضافة tickets","operationId":"post_tickets","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":2,"maxLength":120},"customerId":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"priority":{"type":"string","enum":["normal","high"],"default":"normal"},"status":{"type":"string","enum":["open","in_progress","closed"],"default":"open"}},"required":["title","customerId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/tickets/{id}":{"get":{"summary":"تفاصيل tickets","operationId":"get_tickets__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"patch":{"summary":"تحديث حالة التذكرة","operationId":"patch_tickets__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["open","in_progress","closed"]}},"required":["status"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/customers/{id}/notes":{"post":{"summary":"إضافة ملاحظة للعميل","operationId":"post_customers__id_notes","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":3000}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"get":{"summary":"ملاحظات العميل","operationId":"get_customers__id_notes","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{id}/status":{"post":{"summary":"تغيير حالة الموظف","operationId":"post_agents__id_status","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["available","paused","offline","break","after_call"]}},"required":["status"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/calls/{id}/control":{"post":{"summary":"التحكم في المكالمة","operationId":"post_calls__id_control","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["answer","hangup","hold","unhold","mute","unmute","transfer","dtmf"]},"agentId":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"digits":{"type":"string","pattern":"^[0-9*#]{1,32}$"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/calls/{id}/disposition":{"post":{"summary":"خلاصة المكالمة","operationId":"post_calls__id_disposition","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"disposition":{"type":"string","minLength":1,"maxLength":500}},"required":["disposition"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flows/{id}/validate":{"post":{"summary":"فحص التدفق المحفوظ","operationId":"post_flows__id_validate","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flows/{id}/publish":{"post":{"summary":"نشر نسخة ثابتة من التدفق","operationId":"post_flows__id_publish","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flows/{id}/versions":{"get":{"summary":"إصدارات التدفق الثابتة","operationId":"get_flows__id_versions","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flow-templates":{"get":{"summary":"قوالب التدفقات العربية","operationId":"get_flow_templates","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flow-registry":{"get":{"summary":"أنواع عناصر التدفقات","operationId":"get_flow_registry","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/modules":{"get":{"summary":"متجر الإضافات والصلاحيات","operationId":"get_modules","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/modules/{id}/toggle":{"post":{"summary":"تفعيل إضافة أو إيقافها","operationId":"post_modules__id_toggle","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"}},"required":["active"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/settings":{"get":{"summary":"إعدادات الشركة","operationId":"get_settings","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"تحديث إعدادات الشركة","operationId":"put_settings","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"timezone":{"type":"string","maxLength":80},"retentionDays":{"type":"integer","minimum":7,"maximum":3650},"businessStart":{"type":"integer","minimum":0,"maximum":23},"businessEnd":{"type":"integer","minimum":1,"maximum":24}},"required":["name","timezone","retentionDays","businessStart","businessEnd"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/onboarding":{"post":{"summary":"حفظ تقدم التهيئة","operationId":"post_onboarding","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"step":{"type":"integer","minimum":1,"maximum":6}},"required":["step"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/users":{"get":{"summary":"المستخدمون والأدوار","operationId":"get_users","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إضافة مستخدم","operationId":"post_users","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email"},"password":{"type":"string","minLength":12,"maxLength":128},"role":{"type":"string","enum":["admin","supervisor","agent","finance","analyst"]},"agentId":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"}},"required":["name","email","password","role"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/users/{id}/role":{"patch":{"summary":"تغيير صلاحيات المستخدم","operationId":"patch_users__id_role","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string","enum":["admin","supervisor","agent","finance","analyst"]},"agentId":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"}},"required":["role"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/reports":{"get":{"summary":"إحصاءات مشتقة من سجل المكالمات","operationId":"get_reports","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/billing":{"get":{"summary":"الخطة والاستخدام","operationId":"get_billing","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/recordings/{id}/access":{"post":{"summary":"وصول مؤقت للتسجيل","operationId":"post_recordings__id_access","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/audio-assets":{"get":{"summary":"مكتبة الملفات الصوتية الخاصة بالشركة","operationId":"get_audio_assets","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"رفع ملف WAV أو MP3 أو OGG؛ الاسم والتصنيف في query","operationId":"post_audio_assets","security":[{"bearerAuth":[]}],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":120}},{"name":"kind","in":"query","required":true,"schema":{"type":"string","enum":["greeting","ivr","hold","ringback","ringtone","announcement","goodbye","disclosure"]}},{"name":"description","in":"query","required":false,"schema":{"type":"string","maxLength":600}}],"requestBody":{"required":true,"content":{"audio/wav":{"schema":{"type":"string","format":"binary"}},"audio/mpeg":{"schema":{"type":"string","format":"binary"}},"audio/ogg":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/audio-assets/{id}/content":{"get":{"summary":"تشغيل ملف صوتي بعد التحقق من العضوية والصلاحية","operationId":"get_audio_assets__id_content","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"audio/wav":{"schema":{"type":"string","format":"binary"}},"audio/mpeg":{"schema":{"type":"string","format":"binary"}},"audio/ogg":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/audio-assets/{id}":{"patch":{"summary":"تحديث اسم وتصنيف الملف الصوتي","operationId":"patch_audio_assets__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"kind":{"type":"string","enum":["greeting","ivr","hold","ringback","ringtone","announcement","goodbye","disclosure"]},"description":{"type":"string","maxLength":600,"default":""},"rev":{"type":"integer","minimum":0}},"required":["name","kind","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/audio-assets/{id}/archive":{"post":{"summary":"أرشفة ملف غير مستخدم مع حفظ الإصدارات السابقة","operationId":"post_audio_assets__id_archive","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/voice-settings":{"get":{"summary":"سياسات الرنين والرد والانتظار والإنهاء","operationId":"get_voice_settings","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"حفظ سياسات المكالمة والتحقق من الملفات التابعة للشركة","operationId":"put_voice_settings","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"greetingAssetId":{"type":"string","maxLength":100,"default":""},"holdAssetId":{"type":"string","maxLength":100,"default":""},"ringbackAssetId":{"type":"string","maxLength":100,"default":""},"ringtoneAssetId":{"type":"string","maxLength":100,"default":""},"announcementAssetId":{"type":"string","maxLength":100,"default":""},"goodbyeAssetId":{"type":"string","maxLength":100,"default":""},"disclosureAssetId":{"type":"string","maxLength":100,"default":""},"ringSeconds":{"type":"integer","minimum":5,"maximum":120,"default":25},"queueTimeoutSeconds":{"type":"integer","minimum":10,"maximum":3600,"default":180},"announcementSeconds":{"type":"integer","minimum":15,"maximum":600,"default":60},"wrapUpSeconds":{"type":"integer","minimum":0,"maximum":600,"default":30},"answerMode":{"type":"string","enum":["manual","auto"],"default":"manual"},"autoAnswerDelay":{"type":"integer","minimum":0,"maximum":30,"default":3},"recordingMode":{"type":"string","enum":["off","on_answer","manual"],"default":"off"},"playDisclosure":{"type":"boolean","default":true},"allowHold":{"type":"boolean","default":true},"allowTransfer":{"type":"boolean","default":true},"allowDtmf":{"type":"boolean","default":true},"afterHoursMessage":{"type":"string","maxLength":1500,"default":"نعتذر، نحن خارج أوقات العمل. يرجى الاتصال لاحقًا."},"noAnswerAction":{"type":"string","enum":["end","callback","voicemail"],"default":"callback"},"goodbyeMessage":{"type":"string","maxLength":1500,"default":"شكرًا لاتصالك. يسعدنا خدمتك."},"collectRating":{"type":"boolean","default":false},"ratingQuestion":{"type":"string","maxLength":500,"default":"قيّم تجربتك من 1 إلى 5."},"rev":{"type":"integer","minimum":0}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/queues/{id}/voice":{"put":{"summary":"تخصيص إعدادات الرنين والانتظار لقائمة محددة","operationId":"put_queues__id_voice","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"inherit":{"type":"boolean"},"ringSeconds":{"type":"integer","minimum":5,"maximum":120},"timeoutSeconds":{"type":"integer","minimum":10,"maximum":3600},"announcementSeconds":{"type":"integer","minimum":15,"maximum":600},"holdAssetId":{"type":"string","maxLength":100,"default":""},"ringbackAssetId":{"type":"string","maxLength":100,"default":""},"announcementAssetId":{"type":"string","maxLength":100,"default":""},"noAnswerAction":{"type":"string","enum":["end","callback","voicemail"]},"rev":{"type":"integer","minimum":0}},"required":["inherit","ringSeconds","timeoutSeconds","announcementSeconds","noAnswerAction","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/callback-requests":{"get":{"summary":"طلبات إعادة الاتصال الناتجة عن التدفقات","operationId":"get_callback_requests","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/callback-requests/{id}":{"patch":{"summary":"تحديث متابعة طلب إعادة الاتصال","operationId":"patch_callback_requests__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["open","in_progress","done"]},"note":{"type":"string","maxLength":2000,"default":""}},"required":["status"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/overview":{"get":{"summary":"نظرة تشغيلية مقيدة بنطاق موظف المنصة","operationId":"get_admin_overview","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies":{"post":{"summary":"إنشاء شركة ومالكها وتهيئة مساحة العمل","operationId":"post_admin_companies","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"legalName":{"type":"string","maxLength":200,"default":""},"registrationNumber":{"type":"string","maxLength":100,"default":""},"taxNumber":{"type":"string","maxLength":100,"default":""},"industry":{"type":"string","maxLength":100,"default":""},"country":{"type":"string","maxLength":80,"default":""},"city":{"type":"string","maxLength":100,"default":""},"address":{"type":"string","maxLength":300,"default":""},"website":{"type":"string","maxLength":250,"default":""},"contact":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"default":""},"email":{"anyOf":[{"type":"string","format":"email"},{}],"default":""},"phone":{"type":"string","maxLength":40,"default":""}},"required":[],"additionalProperties":false,"default":{}},"technicalContact":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"default":""},"email":{"anyOf":[{"type":"string","format":"email"},{}],"default":""},"phone":{"type":"string","maxLength":40,"default":""}},"required":[],"additionalProperties":false,"default":{}},"billingContact":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"default":""},"email":{"anyOf":[{"type":"string","format":"email"},{}],"default":""},"phone":{"type":"string","maxLength":40,"default":""}},"required":[],"additionalProperties":false,"default":{}},"plan":{"type":"string","enum":["trial","starter","professional","enterprise"],"default":"starter"},"supportTier":{"type":"string","enum":["standard","priority","dedicated"],"default":"standard"},"timezone":{"type":"string","maxLength":80,"default":"Africa/Tripoli"},"branches":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"city":{"type":"string","maxLength":100,"default":""},"address":{"type":"string","maxLength":300,"default":""}},"required":["name"],"additionalProperties":false},"maxItems":30,"default":[]},"technical":{"type":"object","properties":{"deployment":{"type":"string","enum":["shared","dedicated"],"default":"shared"},"region":{"type":"string","maxLength":80,"default":""},"cluster":{"type":"string","maxLength":100,"default":""},"sipHost":{"type":"string","maxLength":200,"default":""},"sipPort":{"type":"integer","minimum":1,"maximum":65535,"default":5061},"sipTransport":{"type":"string","enum":["tls","tcp","udp"],"default":"tls"},"trunkReference":{"type":"string","maxLength":100,"default":""},"edgeSerial":{"type":"string","maxLength":100,"default":""},"networkMode":{"type":"string","enum":["vpn","tls","pending"],"default":"pending"},"inboundNumbers":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":30,"default":[]},"outboundCallerId":{"type":"string","maxLength":40,"default":""},"requestedDomains":{"type":"array","items":{"type":"string","pattern":"^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z]{2,}$"},"maxItems":10,"default":[]},"agentLimit":{"type":"integer","minimum":1,"maximum":10000,"default":25},"queueLimit":{"type":"integer","minimum":1,"maximum":1000,"default":10},"concurrentCallLimit":{"type":"integer","minimum":1,"maximum":10000,"default":10},"storageGB":{"type":"integer","minimum":1,"maximum":100000,"default":10},"retentionDays":{"type":"integer","minimum":7,"maximum":3650,"default":90},"notes":{"type":"string","maxLength":3000,"default":""}},"required":[],"additionalProperties":false,"default":{}},"accountNotes":{"type":"string","maxLength":3000,"default":""},"slug":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,29}[a-z0-9]$"},"ownerName":{"type":"string","minLength":2,"maxLength":120},"ownerEmail":{"type":"string","format":"email","maxLength":254},"ownerPassword":{"type":"string","minLength":12,"maxLength":128}},"required":["name","slug","ownerName","ownerEmail","ownerPassword"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/retry-provision":{"post":{"summary":"إعادة محاولة تهيئة شركة محفوظة","operationId":"post_admin_companies__id_retry_provision","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}":{"get":{"summary":"ملف الشركة التشغيلي والفني دون أسرار أو تسجيلات","operationId":"get_admin_companies__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"تحديث الملف الإداري والفني وحدود الشركة","operationId":"put_admin_companies__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"legalName":{"type":"string","maxLength":200,"default":""},"registrationNumber":{"type":"string","maxLength":100,"default":""},"taxNumber":{"type":"string","maxLength":100,"default":""},"industry":{"type":"string","maxLength":100,"default":""},"country":{"type":"string","maxLength":80,"default":""},"city":{"type":"string","maxLength":100,"default":""},"address":{"type":"string","maxLength":300,"default":""},"website":{"type":"string","maxLength":250,"default":""},"contact":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"default":""},"email":{"anyOf":[{"type":"string","format":"email"},{}],"default":""},"phone":{"type":"string","maxLength":40,"default":""}},"required":[],"additionalProperties":false,"default":{}},"technicalContact":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"default":""},"email":{"anyOf":[{"type":"string","format":"email"},{}],"default":""},"phone":{"type":"string","maxLength":40,"default":""}},"required":[],"additionalProperties":false,"default":{}},"billingContact":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"default":""},"email":{"anyOf":[{"type":"string","format":"email"},{}],"default":""},"phone":{"type":"string","maxLength":40,"default":""}},"required":[],"additionalProperties":false,"default":{}},"plan":{"type":"string","enum":["trial","starter","professional","enterprise"],"default":"starter"},"supportTier":{"type":"string","enum":["standard","priority","dedicated"],"default":"standard"},"timezone":{"type":"string","maxLength":80,"default":"Africa/Tripoli"},"branches":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"city":{"type":"string","maxLength":100,"default":""},"address":{"type":"string","maxLength":300,"default":""}},"required":["name"],"additionalProperties":false},"maxItems":30,"default":[]},"technical":{"type":"object","properties":{"deployment":{"type":"string","enum":["shared","dedicated"],"default":"shared"},"region":{"type":"string","maxLength":80,"default":""},"cluster":{"type":"string","maxLength":100,"default":""},"sipHost":{"type":"string","maxLength":200,"default":""},"sipPort":{"type":"integer","minimum":1,"maximum":65535,"default":5061},"sipTransport":{"type":"string","enum":["tls","tcp","udp"],"default":"tls"},"trunkReference":{"type":"string","maxLength":100,"default":""},"edgeSerial":{"type":"string","maxLength":100,"default":""},"networkMode":{"type":"string","enum":["vpn","tls","pending"],"default":"pending"},"inboundNumbers":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":30,"default":[]},"outboundCallerId":{"type":"string","maxLength":40,"default":""},"requestedDomains":{"type":"array","items":{"type":"string","pattern":"^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z]{2,}$"},"maxItems":10,"default":[]},"agentLimit":{"type":"integer","minimum":1,"maximum":10000,"default":25},"queueLimit":{"type":"integer","minimum":1,"maximum":1000,"default":10},"concurrentCallLimit":{"type":"integer","minimum":1,"maximum":10000,"default":10},"storageGB":{"type":"integer","minimum":1,"maximum":100000,"default":10},"retentionDays":{"type":"integer","minimum":7,"maximum":3650,"default":90},"notes":{"type":"string","maxLength":3000,"default":""}},"required":[],"additionalProperties":false,"default":{}},"accountNotes":{"type":"string","maxLength":3000,"default":""},"rev":{"type":"integer","minimum":0}},"required":["name","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/technical":{"put":{"summary":"تحديث معلومات الربط الفني دون أسرار","operationId":"put_admin_companies__id_technical","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deployment":{"type":"string","enum":["shared","dedicated"],"default":"shared"},"region":{"type":"string","maxLength":80,"default":""},"cluster":{"type":"string","maxLength":100,"default":""},"sipHost":{"type":"string","maxLength":200,"default":""},"sipPort":{"type":"integer","minimum":1,"maximum":65535,"default":5061},"sipTransport":{"type":"string","enum":["tls","tcp","udp"],"default":"tls"},"trunkReference":{"type":"string","maxLength":100,"default":""},"edgeSerial":{"type":"string","maxLength":100,"default":""},"networkMode":{"type":"string","enum":["vpn","tls","pending"],"default":"pending"},"inboundNumbers":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":30,"default":[]},"outboundCallerId":{"type":"string","maxLength":40,"default":""},"requestedDomains":{"type":"array","items":{"type":"string","pattern":"^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z]{2,}$"},"maxItems":10,"default":[]},"agentLimit":{"type":"integer","minimum":1,"maximum":10000,"default":25},"queueLimit":{"type":"integer","minimum":1,"maximum":1000,"default":10},"concurrentCallLimit":{"type":"integer","minimum":1,"maximum":10000,"default":10},"storageGB":{"type":"integer","minimum":1,"maximum":100000,"default":10},"retentionDays":{"type":"integer","minimum":7,"maximum":3650,"default":90},"notes":{"type":"string","maxLength":3000,"default":""},"rev":{"type":"integer","minimum":0}},"required":["rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/status":{"post":{"summary":"تعليق أو تفعيل شركة مع سبب مسجل","operationId":"post_admin_companies__id_status","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["active","suspended"]},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["status","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/revoke-sessions":{"post":{"summary":"إنهاء جلسات مستخدمي الشركة عند معالجة حادث وصول","operationId":"post_admin_companies__id_revoke_sessions","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/notes":{"post":{"summary":"إضافة ملاحظة داخلية إلى ملف الشركة","operationId":"post_admin_companies__id_notes","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/diagnostics":{"post":{"summary":"فحص إعدادات الشركة والتدفقات والمراجع دون اتصال خارجي","operationId":"post_admin_companies__id_diagnostics","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/modules/{moduleId}":{"post":{"summary":"إدارة إضافة متاحة لشركة محددة","operationId":"post_admin_companies__id_modules__moduleId","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"moduleId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"}},"required":["active"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/staff":{"get":{"summary":"فريق الدعم والتشغيل وأدوارهم","operationId":"get_admin_staff","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إضافة موظف دعم أو تشغيل بصلاحيات ونطاق شركات","operationId":"post_admin_staff","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email","maxLength":254},"password":{"type":"string","minLength":12,"maxLength":128},"role":{"type":"string","enum":["support_manager","support_agent","platform_engineer","platform_auditor"]},"companyScope":{"type":"string","enum":["all","assigned"],"default":"assigned"},"assignedTenantIds":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":200,"default":[]},"phone":{"type":"string","maxLength":40,"default":""},"team":{"type":"string","maxLength":100,"default":""}},"required":["name","email","password","role"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/staff/{id}":{"patch":{"summary":"تحديث دور موظف الدعم ونطاقه وإبطال جلساته","operationId":"patch_admin_staff__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"role":{"type":"string","enum":["support_manager","support_agent","platform_engineer","platform_auditor"]},"companyScope":{"type":"string","enum":["all","assigned"],"default":"assigned"},"assignedTenantIds":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":200,"default":[]},"phone":{"type":"string","maxLength":40,"default":""},"team":{"type":"string","maxLength":100,"default":""},"active":{"type":"boolean"},"rev":{"type":"integer","minimum":0},"password":{"type":"string","minLength":12,"maxLength":128}},"required":["name","role","active","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/support":{"get":{"summary":"قائمة تذاكر الدعم المسندة لنطاق الموظف","operationId":"get_admin_support","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"فتح تذكرة دعم وحفظ مهلة معالجتها","operationId":"post_admin_support","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":3,"maxLength":180},"description":{"type":"string","minLength":5,"maxLength":6000},"priority":{"type":"string","enum":["low","normal","high","urgent"],"default":"normal"},"category":{"type":"string","enum":["voice","ivr","connectivity","billing","access","general"],"default":"general"},"tenantId":{"type":"string","minLength":1,"maxLength":100}},"required":["subject","description","tenantId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/support/{id}":{"get":{"summary":"تفاصيل التذكرة وردودها مع إخفاء الملاحظات الداخلية عن العميل","operationId":"get_admin_support__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"patch":{"summary":"إسناد التذكرة وتحديث حالتها وأولويتها وحلها","operationId":"patch_admin_support__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["open","in_progress","waiting_customer","resolved","closed"]},"priority":{"type":"string","enum":["low","normal","high","urgent"]},"assigneeId":{"type":"string","maxLength":100,"default":""},"resolution":{"type":"string","maxLength":3000,"default":""},"rev":{"type":"integer","minimum":0}},"required":["status","priority","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/support/{id}/messages":{"post":{"summary":"إضافة رد أو ملاحظة داخلية إلى التذكرة","operationId":"post_admin_support__id_messages","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":6000},"internal":{"type":"boolean","default":false}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/support":{"get":{"summary":"تذاكر دعم الشركة لدى MasterCall","operationId":"get_support","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"فتح تذكرة دعم وحفظ مهلة معالجتها","operationId":"post_support","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":3,"maxLength":180},"description":{"type":"string","minLength":5,"maxLength":6000},"priority":{"type":"string","enum":["low","normal","high","urgent"],"default":"normal"},"category":{"type":"string","enum":["voice","ivr","connectivity","billing","access","general"],"default":"general"}},"required":["subject","description"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/support/{id}":{"get":{"summary":"تفاصيل التذكرة وردودها مع إخفاء الملاحظات الداخلية عن العميل","operationId":"get_support__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/support/{id}/messages":{"post":{"summary":"إضافة رد أو ملاحظة داخلية إلى التذكرة","operationId":"post_support__id_messages","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":6000},"internal":{"type":"boolean","default":false}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/audit":{"get":{"summary":"سجل إجراءات المنصة ضمن نطاق الموظف","operationId":"get_admin_audit","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{agentId}/telephony-devices":{"get":{"summary":"أجهزة الموظف وتسجيلها الفعلي دون أسرار","operationId":"get_agents__agentId_telephony_devices","security":[{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إصدار جهاز SIP مستقل؛ كلمة المرور في الاستجابة مرة واحدة","operationId":"post_agents__agentId_telephony_devices","security":[{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":2,"maxLength":80},"policy":{"type":"object","properties":{"allowInternal":{"type":"boolean","default":true},"allowIvr":{"type":"boolean","default":true},"allowTransfer":{"type":"boolean","default":false}},"required":[],"additionalProperties":false,"default":{"allowInternal":true,"allowIvr":true,"allowTransfer":false}}},"required":["label"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{agentId}/telephony-devices/{id}/rotate":{"post":{"summary":"تدوير هوية الجهاز وإبطال بياناته السابقة","operationId":"post_agents__agentId_telephony_devices__id_rotate","security":[{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{agentId}/telephony-devices/{id}/disable":{"post":{"summary":"تعطيل الجهاز للمكالمات الجديدة مع استمرار المكالمة القائمة","operationId":"post_agents__agentId_telephony_devices__id_disable","security":[{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{agentId}/telephony-devices/{id}":{"delete":{"summary":"إلغاء الجهاز نهائيًا للمكالمات الجديدة","operationId":"delete_agents__agentId_telephony_devices__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{agentId}/telephony-devices/{id}/policy":{"put":{"summary":"صلاحيات الاتصال الداخلي وIVR والتحويل عبر المنصة","operationId":"put_agents__agentId_telephony_devices__id_policy","security":[{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"allowInternal":{"type":"boolean","default":true},"allowIvr":{"type":"boolean","default":true},"allowTransfer":{"type":"boolean","default":false}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/agents/{agentId}/telephony-devices/default":{"put":{"summary":"اختيار جهاز استقبال واحد؛ لا رنين متوازٍ","operationId":"put_agents__agentId_telephony_devices_default","security":[{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deviceId":{"type":"string","maxLength":100}},"required":["deviceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/softphone/session":{"post":{"summary":"إعداد هاتف WebRTC مرتبط بجلسة الموظف","operationId":"post_softphone_session","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"delete":{"summary":"إلغاء هوية الهاتف المرتبطة بالجلسة","operationId":"delete_softphone_session","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/telephony/routing":{"get":{"summary":"مسار الاختبار الصوتي الداخلي والإصدار الفعلي","operationId":"get_telephony_routing","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"ربط تدفق منشور بالمدخل الداخلي 7000","operationId":"put_telephony_routing","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"flowId":{"type":"string","maxLength":100},"enabled":{"type":"boolean"}},"required":["flowId","enabled"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/recordings/{id}/content":{"get":{"summary":"تشغيل تسجيل حقيقي من التخزين الخاص بعد التحقق من الصلاحية","operationId":"get_recordings__id_content","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"audio/wav":{"schema":{"type":"string","format":"binary"}},"audio/mpeg":{"schema":{"type":"string","format":"binary"}},"audio/ogg":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}}}}