POST/api/global-chatbot/demo/voice-speak

يحوّل النص إلى كلام منطوق (إخراج صوتي في صفحة العرض التجريبي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.

أرسلوا `visitor_id` (UUID) والنص المطلوب قراءته في `text`. تحتوي الاستجابة على بيانات الصوت للتشغيل؛ لعنصر `<audio>` يتوفر المسار نفسه إضافيًا عبر GET. يماثل هذا المسار `POST /api/public/widget/voice-speak`، لكنه مرتبط بالعرض التجريبي على zentor-app.de ولا يُراد به أن يكون واجهة عامة لإخراج الصوت. حالات الخطأ: 400 `INVALID_VISITOR_ID` (UUID غائب أو غير صالح)، و403 `ORIGIN_DENIED` (الاستدعاء ليس من zentor-app.de)، و503 `VOICE_UNAVAILABLE` (وظيفة الصوت غير متاحة حاليًا).

نظرة عامة

الاستدعاء: POST /api/global-chatbot/demo/voice-speak. تنتمي نقطة النهاية هذه إلى مجموعة «روبوت الدردشة التجريبي وSSO» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء متساوي القوة (idempotent): الاستدعاءات المتكررة بالبيانات نفسها تُرجع النتيجة نفسها. المعاملات الإلزامية: visitor_id (النص (Body)), text (النص (Body)). حالات الخطأ الموثقة: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.

المصادقة والأمان

لا يلزم أي مصادقة

لا يقبل سوى الاستدعاءات من https://zentor-app.de و https://www.zentor-app.de؛ ولا يلزم رمز تضمين للعرض التجريبي.

متطابق القوة: نعم

المعلمات

visitor_id(body, string، إلزامي)— مُعرِّف الزائر، يجب أن يكون UUID صالحًا
text(body, string، إلزامي)— النص المطلوب قراءته

مثال استجابة

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}

رموز الأخطاء

400 INVALID_VISITOR_ID — `visitor_id` غائب أو ليس UUID صالحًا.
403 ORIGIN_DENIED — الاستدعاء ليس من zentor-app.de.
503 VOICE_UNAVAILABLE — وظيفة الصوت غير متاحة حاليًا.

السلوك المُتحقَّق منه

`visitor_id` غير صالح يُعيد 400 `INVALID_VISITOR_ID`، وعدم توفر وظيفة الصوت يُعيد 503 `VOICE_UNAVAILABLE`. حالة النجاح ممكنة فقط من 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-transcribeيحوّل تسجيلًا صوتيًا على صفحة العرض التجريبي إلى نص (إدخال صوتي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.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) لاستيرادها في مزوّد الهوية الخاص بكم.

مقالات ذات صلة

← روبوت الدردشة التجريبي وSSO