كيف تعمل المصادقة في Zentor App
لا يوجد نظام مفاتيح API للمطوّرين — فقط تسجيل الدخول إلى لوحة التحكم وToken تضمين الـ Widget. إليك كيف يعمل كلاهما.
آخر تحقق: 2026-07-20
لا يوفّر Zentor App حاليًا مفتاح API كلاسيكيًا ودائمًا للمطوّرين. توجد طريقتان حقيقيتان للمصادقة: تسجيل الدخول إلى لوحة التحكم (قائم على الجلسة، لك كمستخدم) وToken تضمين الـ Widget (لتضمين Widget الدردشة الخاص بك بشكل عام على موقعك).
خطوة بخطوة
- فهم تسجيل الدخول إلى لوحة التحكمبعد تسجيل الدخول تحصل على Token وصول صالح لمدة 12 ساعة، إضافة إلى Token تجديد صالح لمدة 7 أيام للبقاء مسجّل الدخول دون إعادة إدخال كلمة المرور. يتم استبدال Token الوصول عند كل تجديد (للاستخدام مرة واحدة).
- تفعيل المصادقة الثنائية (اختياري)يمكنك تفعيل المصادقة الثنائية القائمة على TOTP (المتوافقة مع تطبيقات المصادقة الشائعة) لحسابك، بما في ذلك رموز احتياطية للحالات الطارئة.
- الدخول الموحّد Single Sign-On (إن كان متاحًا)إذا كان الدخول الموحّد SSO (SAML/OIDC) مُعدًّا لمستأجرك، فيمكن فرض تسجيل الدخول حصريًا عبر موفّر الهوية الخاص بك — عندئذٍ يُعطَّل تسجيل الدخول العادي بكلمة المرور.
- فهم Token تضمين الـ Widgetيتم إنشاء Token خاص بـ Widget الدردشة عند إنشائه ويُعرض كنص صريح مرة واحدة فقط. وهو مقيّد بصرامة بنقاط النهاية العامة للـ Widget (رسائل الدردشة، التقييم، الإدخال/الإخراج الصوتي) ولا يمنح أي وصول إلى وظائف لوحة التحكم أو الإدارة. علاوة على ذلك، يُتحقَّق من النطاق المُستدعي مقابل قائمة سماح.
النتيجة المتوقعة
تفهم أيّ من الآليتين المتوفّرتين فعليًا (تسجيل دخولك الخاص أو تضمين الـ Widget) مناسب لحالة استخدامك.
حالات الأخطاء الشائعة
أبحث عن مفتاح API لتشغيل نصوصي البرمجية الخاصة مقابل واجهة API الخاصة بـ Zentor App.
السبب: لا يوجد حاليًا نظام مفاتيح API للمطوّرين من هذا النوع.
الحل: الطريقة الوحيدة للوصول البرمجي هي نقطة نهاية تسجيل الدخول المعتادة يتبعها استخدام الـ Token — ضمن القيود المذكورة (انتهاء الصلاحية، الارتباط بالجلسة). للتكاملات الدائمة تواصل مع Zentor.
تنتهي صلاحية Token الوصول الخاص بي أثناء تشغيل نص برمجي.
السبب: Token الوصول مقيّد بـ 12 ساعة ويجب تجديده عبر نقطة نهاية التجديد.
الحل: طبّق تجديد الـ Token عبر نقطة نهاية التجديد، أو سجّل الدخول من جديد عند الحاجة.
قد يستطيع Token الـ Widget الخاص بي جلب بيانات لوحة التحكم عن طريق الخطأ — هل يشكّل ذلك خطرًا أمنيًا؟
السبب: لا — إن Token الـ Widget مقيّد تقنيًا بصرامة بنقاط النهاية العامة للـ Widget ولا يعمل كبديل عن تسجيل دخول الجلسة.
الحل: لا حاجة لأي إجراء؛ ومع ذلك تعامل مع Token الـ Widget بسرّية، لأنه يمنح الوصول إلى Widget الخاص بك إضافة إلى التحقق من النطاق.