GET/api/global-chatbot/demo/history

يحمّل سجل الرسائل السابق لمحادثة تجريبية، بحيث يبقى محفوظًا عند إعادة فتح العرض التجريبي.

مرِّروا `session_id` و`visitor_id` كمعاملَي استفسار؛ يجب أن يكونا من نفس المحادثة التجريبية. تحتوي الاستجابة في الكائن `data` على قائمة `messages` مع `id` و`role` و`text` و`created_at`. الاستدعاء للقراءة فقط وidempotent. إذا غاب أحد المعاملين، يستجيب الخادم بـ400 `PARAMS_REQUIRED`. إذا لم تكن الجلسة معروفة، ابدأوا محادثة تجريبية جديدة.

نظرة عامة

الاستدعاء: GET /api/global-chatbot/demo/history. تنتمي نقطة النهاية هذه إلى مجموعة «روبوت الدردشة التجريبي وSSO» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء متساوي القوة (idempotent): الاستدعاءات المتكررة بالبيانات نفسها تُرجع النتيجة نفسها. المعاملات الإلزامية: session_id (الاستعلام (Query)), visitor_id (الاستعلام (Query)). حالات الخطأ الموثقة: 400 PARAMS_REQUIRED. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.

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

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

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

المعلمات

session_id(query, string، إلزامي)— مُعرِّف جلسة المحادثة التجريبية
visitor_id(query, string، إلزامي)— مُعرِّف الزائر (UUID) الذي تُولِّده صفحة العرض التجريبي

مثال استجابة

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"مرحبًا، كم تكلفة Zentor؟","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ich kann dir zeigen, wie das für deinen Anwendungsfall aussehen würde — ohne Verpflichtung.","created_at":"2026-07-20T17:07:02.329Z"}]}}

رموز الأخطاء

400 PARAMS_REQUIRED — `session_id` أو `visitor_id` غائب.

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

جلسة تجريبية قائمة تُعيد 200 مع السجل؛ والمعاملات الغائبة تُعيد 400 `PARAMS_REQUIRED`.

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

POST /api/global-chatbot/demoيُرسل رسالة إلى روبوت الدردشة التجريبي العام على zentor-app.de/demo ويُرجع رده. يمكن تجربة العرض التجريبي في المتصفح دون تسجيل.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يحوّل تسجيلًا صوتيًا على صفحة العرض التجريبي إلى نص (إدخال صوتي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.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) لاستيرادها في مزوّد الهوية الخاص بكم.

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

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