> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rntor.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kisi

> Configure the Kisi integration with RNTOR

يتيح تكامل Kisi منح العملاء صلاحية مؤقتة للأقفال المحددة تلقائيًا. ويمكنهم فتح الأبواب من صفحة **الدخول** في بوابة الأعضاء أو التطبيق.

<Info>
  Kisi شركة مستقلة وغير تابعة لـRNTOR. للاستفسار عن حلولها أو خدماتها أو أسعارها، تواصل معها مباشرة.
</Info>

## المتطلبات الأساسية

1. جهّز حساب Kisi وأضف الأقفال إلى مجموعات دخول مخصصة لـRNTOR فقط.

<Warning>
  قد تؤدي إعادة استخدام مجموعات أُنشئت لتطبيقات أخرى إلى أخطاء.
</Warning>

2. عطّل اشتراط Bluetooth للأقفال في لوحة Kisi.

<Warning>
  عند تفعيله، لن يتمكن المستخدمون من فتح الأبواب عبر صفحة **الدخول** في RNTOR؛ فالفتح عبر Bluetooth مدعوم داخل تطبيق Kisi فقط.
</Warning>

3. استخدم حساب **مالك** في Kisi.

## ربط Kisi

1. اضغط **(...)** بجوار اسم الموقع وافتح **التكاملات**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/rntor/images/integrations/access-control-kisi-1.png" alt="فتح التكاملات" />

2. افتح **Kisi** واضغط **ربط**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/rntor/images/integrations/access-control-kisi-2.png" alt="ربط Kisi" />

3. أدخل بيانات حساب Kisi، واستخدم بريد مالك الحساب في حقل **البريد الإلكتروني**.
4. حدّد [ظهور](/docs/ar/admin/location/visibility) صفحة **الدخول**.

<Tip>
  لتمكين [غير الأعضاء](/docs/ar/admin/customer-management/users/nonmembers) من فتح الأبواب عند الحجز، اضبط الظهور على **عام**.
</Tip>

5. اختر الموقع الذي أضفت إليه الأقفال في Kisi، ثم احفظ.

<Info>
  يمكنك ربط حساب Kisi منفصل بكل موقع في RNTOR.
</Info>

## إعداد التكامل

يمكن منح الدخول بناءً على اشتراك أو حجز غرفة أو مقعد أو مكتب أو معدات أو موقف.

### الاشتراكات

**للأعضاء الجدد:** اختر مجموعة Kisi المناسبة في قسم **الدخول** ضمن [إعدادات الخطة](/docs/ar/admin/billing/plans/set-up-plans) أو [إعدادات المورد](/docs/ar/admin/resource-management/resources/set-up-resources). عند [إنشاء الاشتراك](/docs/ar/admin/billing/subscriptions/set-up-subscriptions) أو [الاشتراك الذاتي](/docs/ar/admin/billing/plans/immediate-plan-sign-ups)، يُزامن المستخدم تلقائيًا طوال مدة الاشتراك.

**للأعضاء الحاليين:** [افتح الاشتراك](/docs/ar/admin/billing/subscriptions/edit-a-subscription)، واختر المجموعة في **الدخول**. يسري التعديل فورًا.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/rntor/images/integrations/access-control-kisi-3.png" alt="مجموعة اشتراك Kisi" />

### حجوزات الموارد

افتح [إعدادات المورد](/docs/ar/admin/resource-management/resources/set-up-resources) من صفحة الغرف أو المقاعد أو المكاتب أو المواقف أو المعدات، واختر مجموعة Kisi في **الدخول**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/rntor/images/integrations/access-control-kisi-4.png" alt="مجموعة مورد Kisi" />

## آلية العمل

### الاشتراكات

* يُزامن المستخدم مع المجموعة طوال مدة الاشتراك، ويمنح اشتراك الشركة الصلاحية لكل مستخدميها.
* تبدأ المزامنة عند منتصف الليل في تاريخ البداية.
* تُلغى الصلاحية تلقائيًا عند انتهاء الاشتراك أو إلغائه.

<Info>
  لا ترتبط الصلاحية بحالة دفع الفاتورة. لإلغائها، [جدوِل نهاية الاشتراك](/docs/ar/admin/billing/subscriptions/edit-a-subscription) أو [ألغِه](/docs/ar/admin/billing/subscriptions/cancel-a-subscription).
</Info>

### الحجوزات

يحصل المستخدم ومدعوّو حجز الغرفة على الصلاحية طوال الحجز، مع مهلة 30 دقيقة قبله وبعده.

| وقت الحجز      | نافذة الدخول   |
| -------------- | -------------- |
| 12:00 م–4:00 م | 11:30 ص–4:30 م |
| 9:30 ص–11:30 ص | 9:00 ص–12:00 م |

## كيفية فتح الأبواب

1. يفتح المستخدم صاحب الاشتراك أو الحجز النشط بوابة الأعضاء أو التطبيق.
2. ينتقل إلى **الدخول**.
3. تظهر الأقفال المسموح بها وفق مجموعة الحجز أو الاشتراك.
4. يضغط القفل لفتح الباب.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/rntor/images/integrations/access-control-kisi-5.png" alt="صفحة الدخول" />

### إبلاغ العملاء بطريقة الدخول

لا ترسل Kisi رسائل آلية للمستخدمين. لذلك:

* أضف التعليمات إلى [رسائل تأكيد الحجز](/docs/ar/admin/general/customize-emails) في إعدادات المورد.
* [أنشئ دليلًا بعنوان «كيفية دخول المساحة»](/docs/ar/admin/support/guides) ليجده العملاء في صفحتي **المعلومات** و**الدعم**.

## فصل Kisi

انتقل إلى **التكاملات** > **Kisi**، ثم اضغط **فصل** وأكد.

<Warning>
  بعد الفصل لن تُمنح صلاحيات للحجوزات والاشتراكات المستقبلية، وتبقى الصلاحيات الممنوحة حتى تلغيها يدويًا من Kisi.
</Warning>

## حل أخطاء الدخول

<Accordion title="لا توجد أقفال">
  قد تظهر رسالة **لا توجد أقفال** للأسباب التالية:

  * لم تُربط مجموعات بالخطط أو الموارد.

  * لا يملك العميل حجزًا أو اشتراكًا نشطًا.

  * تاريخ بدء الاشتراك لم يحن بعد.

  * يسجّل المستخدم ببريد مختلف عن البريد المرتبط بالدعوة.

  * لم يُضف المستخدم إلى الشركة المناسبة.

  * لم تُنشأ الأقفال أو لم تُضف إلى المجموعة في Kisi. أضفها هناك، ثم افتح الاشتراك في RNTOR وتحقق من المجموعة واحفظ.

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/rntor/images/integrations/access-control-kisi-7.png" alt="إعادة حفظ المجموعة" />

  * تم اختيار موقع غير صحيح في إعدادات التكامل. افتح **التكاملات** > **Kisi**، واختر الموقع الذي توجد فيه الأبواب، أو اختر **غير محدد** لإظهار أقفال جميع المواقع.

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/rntor/images/integrations/access-control-kisi-6.png" alt="لا توجد أقفال" />
</Accordion>

<Accordion title="اطلب من المسؤول تعطيل قيد قارئ Kisi">
  يعني هذا الخطأ أن القفل مضبوط للفتح عبر Bluetooth فقط. افتح لوحة Kisi وعطّل اشتراط Bluetooth للقفل؛ إذ يرسل RNTOR طلب الفتح إلى خادم Kisi مباشرة.
</Accordion>

<Accordion title="يجب تأكيد بريدك الإلكتروني قبل المتابعة">
  يحدث ذلك عندما يضيف المسؤول المستخدم يدويًا إلى Kisi دون أن يؤكد الدعوة، ثم يُزامن المستخدم نفسه من RNTOR.

  **إذا كانت الصلاحية عبر اشتراك:**

  1. أزل المستخدم من مجموعات Kisi.
  2. في RNTOR، افتح العميل واشتراكه، واختر **غير محدد** في **الدخول** واحفظ، ثم أعد اختيار المجموعة واحفظ.

  **إذا كان لديه حجز مستقبلي:** أزله من مجموعات Kisi، وستتم مزامنته تلقائيًا قبل بدء الحجز.

  **إذا بدأ حجز الغرفة:** أزله من المجموعات، ثم عدّل [وقت نهاية الحجز](/docs/ar/admin/resource-management/resources/manage-bookings) مؤقتًا واحفظ، وبعدها أعد الوقت الصحيح لإجبار النظام على منح الصلاحية من جديد.
</Accordion>

<Accordion title="لم يتم العثور على المجموعة">
  تم حذف مجموعة Kisi المختارة في الاشتراك. تحقق من وجود المجموعات والأقفال في Kisi، ثم [عدّل الاشتراكات الحالية](/docs/ar/admin/billing/subscriptions/edit-a-subscription) واختر مجموعة موجودة، وتحقق من الخطط والموارد أيضًا.
</Accordion>

## الأسئلة الشائعة

<Accordion title="هل يمكن منح أعضاء حاليين صلاحية الدخول؟">
  نعم. [افتح اشتراك العضو](/docs/ar/admin/billing/subscriptions/edit-a-subscription)، واختر مجموعة Kisi في **الدخول** واحفظ؛ يسري التعديل فورًا.
</Accordion>

<Accordion title="لماذا يفشل ربط Kisi؟">
  تحقق من البريد وكلمة المرور والنطاق، واستخدم بريد مالك حساب Kisi. وقد يفشل الربط إذا تجاوز الحساب 10 اتصالات أو عمليات دخول نشطة لواجهة API؛ اطلب من Kisi إزالة بعض الاتصالات.
</Accordion>

<Accordion title="كيف أُعد مجموعات لأبواب مختلفة؟">
  * باب رئيسي واحد: مجموعة واحدة لكل الموارد والخطط.
  * مكاتب خاصة: مجموعة لكل مكتب تضم الباب الرئيسي وباب المكتب.
  * غرف: مجموعة لكل غرفة تضمها مع الباب الرئيسي؛ وللمقاعد والمساحات تكفي مجموعة الباب الرئيسي.
  * صلاحيات متدرجة: مجموعات بالأقفال نفسها وأوقات مختلفة، مثل 9 ص–6 م أو 24/7.
</Accordion>

<Accordion title="كيف أمنح دخولًا عامًا للمشتركين ودخول الغرف لمن يحجزها فقط؟">
  أنشئ مجموعة عامة للأبواب الرئيسية واربطها بالخطط، ومجموعات خاصة بكل غرفة تضم الباب الرئيسي والغرفة واربطها بإعدادات الغرف.
</Accordion>

<Accordion title="هل تتعارض مجموعات الاشتراك والحجز؟">
  لا. خلال الحجز تتجمع الصلاحيات من مجموعتي الاشتراك والحجز، وخارجه تبقى أقفال مجموعة الاشتراك فقط.
</Accordion>

<Accordion title="هل يمكن ربط مجموعتين بخطة أو مورد واحد؟">
  لا؛ يمكن اختيار مجموعة واحدة فقط. إذا احتجت إلى عدة أقفال، أنشئ مجموعة تضمها جميعًا واربطها بالخطة أو المورد.
</Accordion>