POST/api/global-chatbot/demo/voice-transcribe
يحوّل تسجيلًا صوتيًا على صفحة العرض التجريبي إلى نص (إدخال صوتي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.
أرسلوا `visitor_id` (UUID) وملف الصوت في الحقل `audio` بصيغة `multipart/form-data`. تحتوي الاستجابة على النص المُتعرَّف عليه. يماثل هذا المسار `POST /api/public/widget/voice-transcribe`، لكنه مرتبط بالعرض التجريبي على zentor-app.de. حالات الخطأ: 400 `INVALID_VISITOR_ID` (UUID غائب أو غير صالح)، و403 `ORIGIN_DENIED` (الاستدعاء ليس من zentor-app.de)، و413 `AUDIO_TOO_LARGE` (الملف كبير جدًا)، و415 `AUDIO_TYPE_UNSUPPORTED` (الصيغة غير مدعومة).
نظرة عامة
الاستدعاء: POST /api/global-chatbot/demo/voice-transcribe. تنتمي نقطة النهاية هذه إلى مجموعة «روبوت الدردشة التجريبي وSSO» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: visitor_id (النص (Body)), audio (النص (Body)). حالات الخطأ الموثقة: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.
المصادقة والأمان
لا يلزم أي مصادقة
لا يقبل سوى الاستدعاءات من https://zentor-app.de و https://www.zentor-app.de؛ ولا يلزم رمز تضمين للعرض التجريبي.
متطابق القوة: لا
المعلمات
visitor_id(body, string، إلزامي)— مُعرِّف الزائر، يجب أن يكون UUID صالحًاaudio(body, file، إلزامي)— ملف الصوت (`multipart/form-data`)مثال استجابة
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}رموز الأخطاء
400 INVALID_VISITOR_ID — `visitor_id` غائب أو ليس UUID صالحًا.403 ORIGIN_DENIED — الاستدعاء ليس من zentor-app.de.413 AUDIO_TOO_LARGE — يتجاوز ملف الصوت الحجم المسموح.415 AUDIO_TYPE_UNSUPPORTED — صيغة الصوت غير مدعومة.السلوك المُتحقَّق منه
`visitor_id` غير صالح يُعيد 400 `INVALID_VISITOR_ID`، والاستدعاء من نطاق آخر يُعيد 403 `ORIGIN_DENIED`. حالة النجاح ممكنة فقط من zentor-app.de.
روبوت الدردشة التجريبي وSSO
POST /api/global-chatbot/demoيُرسل رسالة إلى روبوت الدردشة التجريبي العام على zentor-app.de/demo ويُرجع رده. يمكن تجربة العرض التجريبي في المتصفح دون تسجيل.GET /api/global-chatbot/demo/historyيحمّل سجل الرسائل السابق لمحادثة تجريبية، بحيث يبقى محفوظًا عند إعادة فتح العرض التجريبي.POST /api/global-chatbot/demo/pollيستدعي الرسائل الجديدة لمحادثة تجريبية، كما يحدث عند تولّي أحد موظفي Zentor المحادثة. تستدعي صفحة العرض التجريبي هذا المسار على فترات.POST /api/global-chatbot/demo/ratingيحفظ تقييم محادثة تجريبية (مفيدة أو غير مفيدة) مع تعليق اختياري.POST /api/global-chatbot/demo/trackيسجّل أحداث استخدام مجهولة الهوية لصفحة العرض التجريبي لإحصاءات زوار Zentor.POST /api/global-chatbot/demo/voice-speakيحوّل النص إلى كلام منطوق (إخراج صوتي في صفحة العرض التجريبي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.GET /api/sso/:tenantSlug/statusيتحقق مما إذا كان تسجيل الدخول الموحد (SAML أو OIDC) مُهيَّأ لحساب معيّن. تستخدم صفحة تسجيل الدخول النتيجة لعرض خيار الدخول عبر SSO.GET /api/sso/:tenantSlug/oidc/startيبدأ تسجيل الدخول عبر OpenID Connect ويوجّه المتصفح إلى مزوّد الهوية المُهيَّأ.GET /api/sso/:tenantSlug/oidc/callbackيستقبل تحويل مزوّد الهوية بعد تسجيل الدخول عبر OIDC، ويعيد توجيه المتصفح إلى Zentor App.GET /api/sso/:tenantSlug/saml/startيبدأ تسجيل الدخول عبر SAML ويوجّه المتصفح إلى مزوّد الهوية المُهيَّأ.POST /api/sso/:tenantSlug/saml/acsخدمة استقبال التأكيد (ACS): تستقبل استجابة SAML الموقَّعة من مزوّد الهوية عبر POST عبر نموذج.GET /api/sso/:tenantSlug/saml/metadataيُقدّم بيانات تعريف SAML الخاصة بـ Zentor App (XML) لاستيرادها في مزوّد الهوية الخاص بكم.