{"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":{}}}},"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":"إنشاء قائمة انتظار والتحقق من الأعضاء والحدود","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,100}$"},"maxItems":100,"default":[]},"requestKey":{"type":"string"}},"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":"تعارض الحالة"}}},"put":{"summary":"تعديل اسم القائمة واستراتيجيتها وأعضائها مع حماية التزامن","operationId":"put_queues__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},"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,100}$"},"maxItems":100,"default":[]},"rev":{"type":"integer","minimum":0}},"required":["name","strategy","slaSeconds","timeoutSeconds","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"patch":{"summary":"تعديل اسم القائمة واستراتيجيتها وأعضائها مع حماية التزامن","operationId":"patch_queues__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},"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,100}$"},"maxItems":100,"default":[]},"rev":{"type":"integer","minimum":0}},"required":["name","strategy","slaSeconds","timeoutSeconds","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"delete":{"summary":"حذف آمن من مساحة العمل مع الاحتفاظ بالمراجع التاريخية","operationId":"delete_queues__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"confirmation":{"type":"string","maxLength":120}},"required":["rev","confirmation"],"additionalProperties":false}}}},"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":"تعارض الحالة"}}},"delete":{"summary":"حذف آمن من مساحة العمل مع الاحتفاظ بالمراجع التاريخية","operationId":"delete_flows__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"confirmation":{"type":"string","maxLength":120}},"required":["rev","confirmation"],"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":"تعارض الحالة"}}}},"/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":"تعارض الحالة"}}}},"/calls/{id}/details":{"get":{"summary":"تفاصيل رحلة المكالمة والتسجيل والأحداث","operationId":"get_calls__id_details","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/{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","record_start","record_stop"]},"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":"تعارض الحالة"}}}},"/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}/voice-ingress":{"get":{"summary":"هويات دخول الصوت الموثوقة للشركة","operationId":"get_admin_companies__id_voice_ingress","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}/voice-ingress/{endpointId}":{"put":{"summary":"اعتماد هوية PJSIP موثوقة كمدخل مكالمات للشركة","operationId":"put_admin_companies__id_voice_ingress__endpointId","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":2,"maxLength":120},"kind":{"type":"string","enum":["masteredge","sip_trunk"]},"enabled":{"type":"boolean"}},"required":["label","kind","enabled"],"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/operations":{"get":{"summary":"مراقبة الشركات والأجهزة وAI ضمن نطاق الصلاحية دون أسرار","operationId":"get_admin_operations","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/service-health":{"get":{"summary":"جاهزية الخدمات المقاسة دون إعادة تشغيل أو تغيير الإعدادات","operationId":"get_admin_service_health","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/security":{"get":{"summary":"سياسات الوصول الفعلية ومصفوفة الصلاحيات دون بيانات جلسات سرية","operationId":"get_admin_security","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/plans":{"get":{"summary":"كتالوج باقات بإصدارات مستقلة؛ لا يغير اشتراكات العملاء أو يحصّل أموالًا","operationId":"get_admin_plans","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_plans","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","pattern":"^[a-z][a-z0-9-]{2,39}$"},"name":{"type":"string","minLength":2,"maxLength":100},"description":{"type":"string","maxLength":600},"monthlyPriceMinor":{"type":"integer","minimum":0,"maximum":100000000},"currency":{},"agentLimit":{"type":"integer","minimum":1,"maximum":10000},"queueLimit":{"type":"integer","minimum":1,"maximum":1000},"concurrentCallLimit":{"type":"integer","minimum":1,"maximum":10000},"storageGB":{"type":"integer","minimum":1,"maximum":100000},"retentionDays":{"type":"integer","minimum":7,"maximum":3650},"modules":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":30},"hostedChannels":{"type":"integer","minimum":0,"maximum":256,"default":0},"customerChannels":{"type":"integer","minimum":0,"maximum":256,"default":0},"requestKey":{"type":"string"}},"required":["code","name","description","monthlyPriceMinor","currency","agentLimit","queueLimit","concurrentCallLimit","storageGB","retentionDays","modules","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/plans/{id}":{"put":{"summary":"تعديل مسودة فقط مع منع الكتابة فوق تعديل متزامن","operationId":"put_admin_plans__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":100},"description":{"type":"string","maxLength":600},"monthlyPriceMinor":{"type":"integer","minimum":0,"maximum":100000000},"currency":{},"agentLimit":{"type":"integer","minimum":1,"maximum":10000},"queueLimit":{"type":"integer","minimum":1,"maximum":1000},"concurrentCallLimit":{"type":"integer","minimum":1,"maximum":10000},"storageGB":{"type":"integer","minimum":1,"maximum":100000},"retentionDays":{"type":"integer","minimum":7,"maximum":3650},"modules":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":30},"hostedChannels":{"type":"integer","minimum":0,"maximum":256,"default":0},"customerChannels":{"type":"integer","minimum":0,"maximum":256,"default":0},"rev":{"type":"integer","minimum":0}},"required":["name","description","monthlyPriceMinor","currency","agentLimit","queueLimit","concurrentCallLimit","storageGB","retentionDays","modules","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/plans/{id}/approve":{"post":{"summary":"اعتماد إصدار ثابت وسعره التجاري دون تغيير العملاء","operationId":"post_admin_plans__id_approve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"pricingConfirmed":{}},"required":["rev","pricingConfirmed"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/plans/{id}/archive":{"post":{"summary":"أرشفة إصدار الكتالوج دون حذف بياناته","operationId":"post_admin_plans__id_archive","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"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/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":"تعارض الحالة"}}}},"/public/inquiries":{"post":{"summary":"طلب عرض MasterCall دون إنشاء اشتراك أو تحصيل مالي","operationId":"post_public_inquiries","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestKey":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":100},"company":{"type":"string","minLength":2,"maxLength":150},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","minLength":5,"maxLength":35},"teamSize":{"type":"string","enum":["1-5","6-15","16-40","41+"]},"interest":{"type":"string","enum":["contact-center","masteredge","ai","enterprise"]},"message":{"type":"string","minLength":5,"maxLength":2000},"consent":{},"website":{"type":"string","maxLength":100,"default":""}},"required":["requestKey","name","company","email","phone","teamSize","interest","message","consent"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/inquiries":{"get":{"summary":"طلبات العروض التجارية؛ لمدير المنصة فقط","operationId":"get_admin_inquiries","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/inquiries/{id}":{"patch":{"summary":"متابعة طلب عرض دون إنشاء عميل أو اشتراك تلقائي","operationId":"patch_admin_inquiries__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":["new","contacted","qualified","closed"]},"internalNote":{"type":"string","maxLength":3000},"rev":{"type":"integer","minimum":0}},"required":["status","internalNote","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity":{"get":{"summary":"مخزون الاتصال وتخصيصات الشركات والرخص دون أسرار","operationId":"get_admin_connectivity","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/gateways":{"post":{"summary":"تسجيل Gateway ومنافذ غير معتمدة حتى الفحص","operationId":"post_admin_connectivity_gateways","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"model":{},"serialNumber":{"type":"string","pattern":"^[a-zA-Z0-9_-]{4,80}$"},"ownership":{"type":"string","enum":["provider","customer"]},"ownerTenantId":{"type":"string","maxLength":100,"default":""},"siteName":{"type":"string","minLength":2,"maxLength":120},"managementIp":{},"radioChannels":{"anyOf":[{},{}]},"capacityReference":{"type":"string","minLength":3,"maxLength":160},"requestKey":{"type":"string"}},"required":["name","model","serialNumber","ownership","siteName","managementIp","radioChannels","capacityReference","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/gateways/{id}/inspect":{"post":{"summary":"قراءة منافذ الجهاز ومطابقة السعة دون تعديل الجهاز","operationId":"post_admin_connectivity_gateways__id_inspect","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/connectivity/sims":{"post":{"summary":"تسجيل استلام شريحة ورقم بمرجع ملكية وحيازة","operationId":"post_admin_connectivity_sims","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phoneNumber":{"type":"string","pattern":"^(0|\\+218)9\\d{8}$"},"carrier":{"type":"string","enum":["libyana","almadar","other"]},"ownership":{"type":"string","enum":["customer_owned","provider_owned"]},"ownerTenantId":{"type":"string","pattern":"^[a-zA-Z0-9_:-]{1,100}$"},"iccid":{"type":"string","pattern":"^\\d{18,22}$"},"custodyReference":{"type":"string","minLength":3,"maxLength":160},"ownershipVerified":{},"requestKey":{"type":"string"}},"required":["phoneNumber","carrier","ownership","ownerTenantId","iccid","custodyReference","ownershipVerified","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/companies/{id}/license":{"put":{"summary":"اعتماد حد القنوات دون تغيير الأسعار أو إصدار فاتورة","operationId":"put_admin_connectivity_companies__id_license","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hostedChannels":{"type":"integer","minimum":0,"maximum":256},"customerChannels":{"type":"integer","minimum":0,"maximum":256},"enabled":{"type":"boolean"},"approvalReference":{"type":"string","minLength":3,"maxLength":160},"validUntil":{"type":"string","format":"date-time","nullable":true,"default":null},"planVersionId":{"type":"string","maxLength":100,"nullable":true,"default":null},"rev":{"type":"integer","minimum":0}},"required":["hostedChannels","customerChannels","enabled","approvalReference","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments":{"post":{"summary":"حجز منفذ وشريحة ورقم ورخصة مع منع التكرار والتعارض","operationId":"post_admin_connectivity_assignments","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tenantId":{"type":"string","pattern":"^[a-zA-Z0-9_:-]{1,100}$"},"portId":{"type":"string","pattern":"^[a-zA-Z0-9_:-]{1,100}$"},"simId":{"type":"string","pattern":"^[a-zA-Z0-9_:-]{1,100}$"},"mode":{"type":"string","enum":["hosted_sim","customer_edge"]},"flowId":{"type":"string","pattern":"^[a-zA-Z0-9_:-]{1,100}$"},"requestId":{"type":"string","maxLength":100,"default":""},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["tenantId","portId","simId","mode","flowId","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}":{"get":{"summary":"خطة الخط ومراجع التهيئة والقبول","operationId":"get_admin_connectivity_assignments__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":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/manual-config":{"get":{"summary":"بيانات DINSTAR اليدوية للمنفذ المخصص فقط","operationId":"get_admin_connectivity_assignments__id_manual_config","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/connectivity/assignments/{id}/acceptance-evidence":{"get":{"summary":"آخر مكالمة قبول نظامية لهذا الخط وحالة اكتمال الصوت وDTMF","operationId":"get_admin_connectivity_assignments__id_acceptance_evidence","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/connectivity/assignments/{id}/flow":{"put":{"summary":"ربط الرقم بتدفق منشور من الشركة نفسها مع كشف تعارض التعديل","operationId":"put_admin_connectivity_assignments__id_flow","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160},"flowId":{"type":"string","pattern":"^[a-zA-Z0-9_:-]{1,100}$"}},"required":["rev","requestKey","reason","flowId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/connectivity/assignments/{id}/flow":{"put":{"summary":"ربط الرقم بتدفق منشور من الشركة نفسها مع كشف تعارض التعديل","operationId":"put_connectivity_assignments__id_flow","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160},"flowId":{"type":"string","pattern":"^[a-zA-Z0-9_:-]{1,100}$"}},"required":["rev","requestKey","reason","flowId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/prepare":{"post":{"summary":"إجراء اتصال محكوم بالحالة: prepare","operationId":"post_admin_connectivity_assignments__id_prepare","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/manual-verify":{"post":{"summary":"إجراء اتصال محكوم بالحالة: manual-verify","operationId":"post_admin_connectivity_assignments__id_manual_verify","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/provision":{"post":{"summary":"إجراء اتصال محكوم بالحالة: provision","operationId":"post_admin_connectivity_assignments__id_provision","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/test-window":{"post":{"summary":"إجراء اتصال محكوم بالحالة: test-window","operationId":"post_admin_connectivity_assignments__id_test_window","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/suspend":{"post":{"summary":"إجراء اتصال محكوم بالحالة: suspend","operationId":"post_admin_connectivity_assignments__id_suspend","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/resume":{"post":{"summary":"إجراء اتصال محكوم بالحالة: resume","operationId":"post_admin_connectivity_assignments__id_resume","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/cancel":{"post":{"summary":"إجراء اتصال محكوم بالحالة: cancel","operationId":"post_admin_connectivity_assignments__id_cancel","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/release":{"post":{"summary":"إجراء اتصال محكوم بالحالة: release","operationId":"post_admin_connectivity_assignments__id_release","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/assignments/{id}/activate":{"post":{"summary":"تفعيل الخط بعد مكالمة قبول مثبتة ومراجعة الصوت والعزل","operationId":"post_admin_connectivity_assignments__id_activate","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160},"callId":{"type":"string","minLength":1,"maxLength":100},"mediaReviewed":{},"isolationReference":{"type":"string","minLength":3,"maxLength":160},"customerAcceptanceReference":{"type":"string","minLength":3,"maxLength":160}},"required":["rev","requestKey","reason","callId","mediaReviewed","isolationReference","customerAcceptanceReference"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/connectivity/requests/{id}":{"patch":{"summary":"متابعة طلب الاتصال والاستلام دون إصدار رقم صوري","operationId":"patch_admin_connectivity_requests__id","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"requestKey":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":160},"status":{"type":"string","enum":["accepted","rejected","received","cancelled"]},"internalNote":{"type":"string","maxLength":1200,"default":""},"customerNote":{"type":"string","maxLength":1200,"default":""},"simId":{"type":"string","maxLength":100}},"required":["rev","requestKey","reason","status"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/connectivity":{"get":{"summary":"أرقام الشركة وقنواتها وطلباتها ورخصتها دون مخزون الشركات الأخرى","operationId":"get_connectivity","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/connectivity/requests":{"post":{"summary":"طلب MasterEdge أو استضافة شريحة أو رقم جديد دون تحصيل تلقائي","operationId":"post_connectivity_requests","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["hosted_sim","customer_edge"]},"supply":{"type":"string","enum":["existing_sim","new_number"]},"requestedChannels":{"type":"integer","minimum":1,"maximum":32},"phoneNumber":{"type":"string","maxLength":30,"default":""},"notes":{"type":"string","maxLength":1200,"default":""},"consent":{},"requestKey":{"type":"string"}},"required":["mode","supply","requestedChannels","consent","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/notifications":{"get":{"summary":"صندوق الإشعارات وحالة القراءة لكل مستخدم","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}/read":{"post":{"summary":"تعليم إشعار كمقروء للمستخدم الحالي فقط","operationId":"post_notifications__id_read","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/read-all":{"post":{"summary":"تعليم إشعارات المستخدم الحالية كمقروءة","operationId":"post_notifications_read_all","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/notifications":{"post":{"summary":"تخزين إشعار في صناديق شركات محددة مع تتبع التسليم وإعادة المحاولة","operationId":"post_admin_notifications","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":2,"maxLength":120},"message":{"type":"string","minLength":2,"maxLength":4000},"severity":{"type":"string","enum":["info","success","warning","action_required"],"default":"info"},"audience":{"type":"string","enum":["all","administrators","roles"],"default":"all"},"roles":{"type":"array","items":{"type":"string","enum":["owner","admin","supervisor","agent","finance","analyst"]},"maxItems":6,"default":[]},"actionPath":{"type":"string","enum":["","/app/account","/app/support","/app/billing","/app/notifications"],"default":""},"actionLabel":{"type":"string","maxLength":60,"default":""},"tenantIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":100},"requestKey":{"type":"string"}},"required":["title","message","tenantIds","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"get":{"summary":"سجل الإرسال مع فرق واضح بين التخزين والقراءة","operationId":"get_admin_notifications","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/notifications/{id}/retry":{"post":{"summary":"إعادة محاولة الشركات الفاشلة دون إنشاء نسخة إشعار جديدة","operationId":"post_admin_notifications__id_retry","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestKey":{"type":"string"}},"required":["requestKey"],"additionalProperties":false}}}},"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":"تعارض الحالة"}}}},"/admin/companies/{id}/billing":{"get":{"summary":"اشتراك وفواتير وسداد شركة ضمن نطاق الإدارة","operationId":"get_admin_companies__id_billing","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}/subscription":{"post":{"summary":"ربط الشركة بإصدار باقة معتمد دون تحصيل تلقائي","operationId":"post_admin_companies__id_subscription","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"planVersionId":{"type":"string","minLength":3,"maxLength":100},"startsAt":{"type":"string","format":"date-time"},"renewsAt":{"type":"string","format":"date-time"},"graceDays":{"type":"integer","minimum":0,"maximum":90},"tenantRev":{"type":"integer","minimum":0},"requestKey":{"type":"string"}},"required":["planVersionId","startsAt","renewsAt","graceDays","tenantRev","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/invoices":{"post":{"summary":"إصدار فاتورة LYD من الاشتراك وإصدار الباقة المثبت","operationId":"post_admin_companies__id_invoices","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subscriptionId":{"type":"string","minLength":3,"maxLength":120},"periodStart":{"type":"string","format":"date-time"},"periodEnd":{"type":"string","format":"date-time"},"requestKey":{"type":"string"}},"required":["subscriptionId","periodStart","periodEnd","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/billing/payments":{"post":{"summary":"إرسال إثبات سداد يدوي لفاتورة دون خصم أو تحصيل آلي","operationId":"post_billing_payments","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"invoiceId":{"type":"string","minLength":3,"maxLength":120},"reference":{"type":"string","minLength":3,"maxLength":160},"proofReference":{"type":"string","maxLength":240,"default":""},"requestKey":{"type":"string"}},"required":["invoiceId","reference","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/payments/{paymentId}/approve":{"post":{"summary":"اعتماد إثبات السداد دون تحصيل","operationId":"post_admin_companies__id_payments__paymentId_approve","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"paymentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"reason":{"type":"string","minLength":3,"maxLength":500},"requestKey":{"type":"string"}},"required":["rev","reason","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/payments/{paymentId}/reject":{"post":{"summary":"رفض إثبات السداد مع سبب","operationId":"post_admin_companies__id_payments__paymentId_reject","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"paymentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"reason":{"type":"string","minLength":3,"maxLength":500},"requestKey":{"type":"string"}},"required":["rev","reason","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/payments/{paymentId}/reconcile":{"post":{"summary":"تسجيل مصالحة السداد المعتمد بمرجع تسوية","operationId":"post_admin_companies__id_payments__paymentId_reconcile","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"paymentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"settlementReference":{"type":"string","minLength":3,"maxLength":160},"requestKey":{"type":"string"}},"required":["rev","settlementReference","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/onboarding/state":{"get":{"summary":"حالة إعداد الاتصال المحفوظة والقابلة للاستئناف","operationId":"get_onboarding_state","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"حفظ تقدم ومسار التجهيز دون طلب أو حجز موارد","operationId":"put_onboarding_state","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"step":{"type":"integer","minimum":1,"maximum":6},"path":{"type":"string","enum":["existing_device","buy_device","owned_sim_cloud","buy_sim"],"nullable":true,"default":null},"details":{"type":"object","properties":{"deviceModel":{"type":"string","maxLength":120,"default":""},"deviceReference":{"type":"string","maxLength":160,"default":""},"phoneNumber":{"type":"string","maxLength":30,"default":""},"deliveryNote":{"type":"string","maxLength":400,"default":""},"notes":{"type":"string","maxLength":1200,"default":""},"termsAccepted":{"type":"boolean","default":false}},"required":[],"additionalProperties":false}},"required":["step","details"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/onboarding/submit":{"post":{"summary":"إرسال مسار التجهيز دون شراء أو تحصيل أو اختلاق مخزون","operationId":"post_onboarding_submit","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestKey":{"type":"string"}},"required":["requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/onboarding/requests":{"get":{"summary":"طلبات التجهيز المحفوظة ضمن نطاق موظف المنصة","operationId":"get_admin_onboarding_requests","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/register/otp":{"post":{"summary":"بدء تسجيل شركة برقم هاتف المالك وإرسال رمز تحقق","operationId":"post_auth_register_otp","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string","minLength":7,"maxLength":30},"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]$"},"email":{"anyOf":[{"type":"string","format":"email","maxLength":254},{}]}},"required":["phone","name","company","slug"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/register/otp/resend":{"post":{"summary":"إعادة إرسال رمز التسجيل بقيود زمنية","operationId":"post_auth_register_otp_resend","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"challengeId":{"type":"string","minLength":10,"maxLength":100}},"required":["challengeId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/auth/register/otp/verify":{"post":{"summary":"التحقق الذري من رمز التسجيل مرة واحدة","operationId":"post_auth_register_otp_verify","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"challengeId":{"type":"string","minLength":10,"maxLength":100},"code":{"type":"string","pattern":"^\\d{6}$"}},"required":["challengeId","code"],"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":{"verificationToken":{"type":"string","minLength":20,"maxLength":300},"password":{"type":"string","minLength":12,"maxLength":128}},"required":["verificationToken","password"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/account/status":{"get":{"summary":"حالة الحساب والرخصة والإجراءات المطلوبة دون بيانات تشغيلية","operationId":"get_account_status","security":[{"bearerAuth":[]}],"parameters":[],"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":1000},"title":{"type":"string","minLength":2,"maxLength":120},"requiredAction":{"type":"string","maxLength":1500},"rev":{"type":"integer","minimum":0}},"required":["status","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/account-control/capabilities":{"get":{"summary":"جاهزية رسالة التجميد الصوتية الثابتة","operationId":"get_admin_account_control_capabilities","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/freeze":{"post":{"summary":"تجميد الشركة مع إبقاء الدعم والهوية وإيقاف جميع عملياتها","operationId":"post_admin_companies__id_freeze","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":2,"maxLength":120},"reason":{"type":"string","minLength":3,"maxLength":1000},"requiredAction":{"type":"string","minLength":3,"maxLength":1500},"rev":{"type":"integer","minimum":0},"confirmation":{"type":"string","maxLength":120}},"required":["title","reason","requiredAction","rev","confirmation"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/unfreeze":{"post":{"summary":"فك التجميد والعودة إلى الحالة السابقة دون تفعيل رخصة منتهية","operationId":"post_admin_companies__id_unfreeze","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rev":{"type":"integer","minimum":0},"confirmation":{"type":"string","maxLength":120},"reason":{"type":"string","minLength":3,"maxLength":1000}},"required":["rev","confirmation","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/service-license":{"put":{"summary":"ضبط صلاحية رخصة مساحة العمل دون تعديل الفواتير أو رخص القنوات","operationId":"put_admin_companies__id_service_license","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":2,"maxLength":120},"reason":{"type":"string","minLength":3,"maxLength":1000},"requiredAction":{"type":"string","minLength":3,"maxLength":1500},"rev":{"type":"integer","minimum":0},"enabled":{"type":"boolean"},"validUntil":{"type":"string","format":"date-time","nullable":true}},"required":["title","reason","requiredAction","rev","enabled","validUntil"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/flows/{id}/deletion-preview":{"get":{"summary":"التحقق من مراجع العنصر قبل الحذف","operationId":"get_flows__id_deletion_preview","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/{id}/deletion-preview":{"get":{"summary":"التحقق من مراجع العنصر قبل الحذف","operationId":"get_queues__id_deletion_preview","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":"تعارض الحالة"}}}},"/workspace/history/cleanup-preview":{"get":{"summary":"معاينة أعداد السجلات التشغيلية القابلة للأرشفة","operationId":"get_workspace_history_cleanup_preview","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/workspace/history/cleanup":{"post":{"summary":"تنظيف سجل الشركة بأرشفة قابلة للاسترجاع دون الأمان والفواتير","operationId":"post_workspace_history_cleanup","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cutoff":{"type":"string","format":"date-time"},"confirmation":{"type":"string","maxLength":200},"requestKey":{"type":"string"}},"required":["cutoff","confirmation","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/admin/companies/{id}/history/cleanup-preview":{"get":{"summary":"معاينة تنظيف السجل لشركة محددة دون تعديل بياناتها","operationId":"get_admin_companies__id_history_cleanup_preview","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}/history/cleanup":{"post":{"summary":"تنظيف سجل شركة محددة بموافقة صريحة مع إبقاء سجلات التدقيق","operationId":"post_admin_companies__id_history_cleanup","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cutoff":{"type":"string","format":"date-time"},"confirmation":{"type":"string","maxLength":200},"requestKey":{"type":"string"}},"required":["cutoff","confirmation","requestKey"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/ai/provider":{"get":{"summary":"حالة مزود الذكاء الاصطناعي","operationId":"get_ai_provider","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"ربط مزود AI خارجي","operationId":"put_ai_provider","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"default":"openai"},"apiKey":{"type":"string","minLength":20,"maxLength":500},"enabled":{"type":"boolean","default":true},"model":{"type":"string","minLength":3,"maxLength":100,"default":"gpt-realtime-1.5"},"voice":{"type":"string","enum":["marin","cedar","coral","sage","verse","alloy","ash","ballad","echo","shimmer"],"default":"marin"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/ai/provider/test":{"post":{"summary":"اختبار اتصال مزود AI","operationId":"post_ai_provider_test","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/ai-agents":{"get":{"summary":"الموظفون الذكيون","operationId":"get_ai_agents","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"إنشاء موظف ذكي","operationId":"post_ai_agents","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":100},"instructions":{"type":"string","minLength":20,"maxLength":20000},"knowledge":{"type":"string","maxLength":40000,"default":""},"dialect":{"type":"string","enum":["libyan","arabic"],"default":"libyan"},"voice":{"type":"string","enum":["marin","cedar","coral","sage","verse","alloy","ash","ballad","echo","shimmer"],"default":"marin"},"model":{"type":"string","minLength":3,"maxLength":100,"default":"gpt-realtime-1.5"},"maxSeconds":{"type":"integer","minimum":30,"maximum":3600,"default":600},"handoffQueueId":{"type":"string","maxLength":100,"default":"queue-service"},"enabled":{"type":"boolean","default":true}},"required":["name","instructions"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/ai-agents/{id}":{"put":{"summary":"تحديث موظف ذكي","operationId":"put_ai_agents__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":100},"instructions":{"type":"string","minLength":20,"maxLength":20000},"knowledge":{"type":"string","maxLength":40000,"default":""},"dialect":{"type":"string","enum":["libyan","arabic"],"default":"libyan"},"voice":{"type":"string","enum":["marin","cedar","coral","sage","verse","alloy","ash","ballad","echo","shimmer"],"default":"marin"},"model":{"type":"string","minLength":3,"maxLength":100,"default":"gpt-realtime-1.5"},"maxSeconds":{"type":"integer","minimum":30,"maximum":3600,"default":600},"handoffQueueId":{"type":"string","maxLength":100,"default":"queue-service"},"enabled":{"type":"boolean","default":true},"rev":{"type":"integer","minimum":0}},"required":["name","instructions","rev"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/ai-sessions":{"get":{"summary":"جلسات موظفي AI","operationId":"get_ai_sessions","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/ai-sessions/{callId}/messages":{"get":{"summary":"نص محادثة AI","operationId":"get_ai_sessions__callId_messages","security":[{"bearerAuth":[]}],"parameters":[{"name":"callId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/softphone/provision":{"post":{"summary":"Provisioning آمن لتطبيقات SIP الخارجية","operationId":"post_softphone_provision","security":[],"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":"تعارض الحالة"}}}},"/telephony/inbound-routes":{"get":{"summary":"مسارات أرقام الدخول إلى التدفقات المنشورة","operationId":"get_telephony_inbound_routes","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"put":{"summary":"ربط رقم وارد محدد بتدفق منشور","operationId":"put_telephony_inbound_routes","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"destination":{"type":"string","pattern":"^\\+?\\d{2,20}$"},"label":{"type":"string","minLength":2,"maxLength":120},"flowId":{"type":"string","minLength":1,"maxLength":100},"sourceEndpointId":{"type":"string","pattern":"^(edge|trunk)_[a-z0-9_-]{3,70}$","default":""},"enabled":{"type":"boolean","default":true}},"required":["destination","label","flowId","sourceEndpointId"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/telephony/inbound-routes/{id}":{"delete":{"summary":"حذف توجيه رقم وارد","operationId":"delete_telephony_inbound_routes__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":"تعارض الحالة"}}}},"/masteredge/devices":{"get":{"summary":"أجهزة MasterEdge وربط VPN وSIP ومسار المكالمة","operationId":"get_masteredge_devices","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}},"post":{"summary":"طلب وتجهيز MasterEdge بهوية VPN وSIP مستقلة","operationId":"post_masteredge_devices","security":[{"bearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"vendor":{"type":"string","enum":["DINSTAR"],"default":"DINSTAR"},"model":{"type":"string","minLength":2,"maxLength":100},"serialNumber":{"type":"string","minLength":3,"maxLength":100},"managementIp":{"type":"string","pattern":"^(?:\\d{1,3}\\.){3}\\d{1,3}$","default":""},"siteName":{"type":"string","maxLength":120,"default":""},"gsmPorts":{"type":"array","items":{"type":"integer","minimum":0,"maximum":31},"maxItems":32},"notes":{"type":"string","maxLength":1000,"default":""}},"required":["name","model","serialNumber","managementIp","gsmPorts"],"additionalProperties":false}}}},"responses":{"200":{"description":"نجاح","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"بيانات غير صحيحة"},"401":{"description":"يتطلب تسجيل الدخول"},"403":{"description":"الصلاحية أو الشركة غير مسموحة"},"409":{"description":"تعارض الحالة"}}}},"/masteredge/devices/{id}":{"get":{"summary":"تفاصيل جهاز MasterEdge دون أسرار","operationId":"get_masteredge_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":"تعارض الحالة"}}}},"/masteredge/devices/{id}/retry":{"post":{"summary":"إعادة محاولة تجهيز MasterEdge المتعثر","operationId":"post_masteredge_devices__id_retry","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":"تعارض الحالة"}}}},"/masteredge/devices/{id}/vpn-profile":{"get":{"summary":"تنزيل ملف OpenVPN الخاص بجهاز MasterEdge بعد التحقق من الشركة","operationId":"get_masteredge_devices__id_vpn_profile","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":"تعارض الحالة"}}}},"/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":"تعارض الحالة"}}}}}}