=== Rimoq ===
Contributors: rimoq ,  InfinitAtitude lda.
Tags: ai, chatbot, assistant, customer support, faq
Requires at least: 6.0
Tested up to: 6.8
Stable tag: 1.4.1
Requires PHP: 7.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

أضف روبوت محادثة مدعوم بالذكاء الاصطناعي إلى موقعك الإلكتروني يتعلم من محتوى ووردبريس الخاص بك ويقدم إجابات فورية لأسئلة الزوار.

== Description ==

Rimoq هي خدمة روبوت محادثة مدعومة بالذكاء الاصطناعي تساعد زوار موقعك في العثور على المعلومات بسرعة وكفاءة. يتعلم من محتواك ويقدم إجابات فورية لأسئلة المستخدمين.

مع إضافة Rimoq، يمكنك:

* مزامنة مشاركات وصفحات ووردبريس تلقائياً مع Rimoq
* تضمين روبوت محادثة Rimoq في موقعك الإلكتروني بتكوين بسيط
* تقديم إجابات فورية لأسئلة زوارك
* تحسين تجربة المستخدم وتقليل طلبات الدعم
* تتبع تفاعلات المستخدمين والحصول على رؤى حول ما يبحث عنه زوارك

يدعم Rimoq أيضاً التكامل مع منصات المراسلة الشائعة مثل واتساب وتيليجرام وفيسبوك ماسنجر وإنستجرام وديسكورد وسلاك - مما يتيح لمساعدك الذكي التفاعل مع المستخدمين خارج موقعك الإلكتروني.

🌐 يدعم Rimoq أكثر من 15 لغة افتراضياً ويعمل على أجهزة سطح المكتب والجوال واللوحية.

ملاحظة: تعتمد هذه الإضافة على خدمة Rimoq السحابية لتوفير ميزاتها المدعومة بالذكاء الاصطناعي. ستتم تفعيل الإضافة نفسها وتحميلها بدون بيانات اعتماد، ولكن لتمكين وظيفة روبوت المحادثة، يجب عليك توفير مفتاح API صالح من Rimoq.

يمكنك التسجيل مباشرة من تبويب "التسجيل" في الإضافة. بعد التسجيل، ستتلقى بريداً إلكترونياً للتفعيل. يجب عليك النقر على رابط التفعيل في ذلك البريد لتفعيل حسابك وإنشاء مفتاح API الخاص بك.

إذا كان لديك حساب بالفعل، يمكنك إنشاء أو إدارة مفتاح API الخاص بك في: https://rimoq.com/apikey

== Highlights ==

🚀 مساعد مدعوم بالذكاء الاصطناعي مدرب على محتوى ووردبريس الخاص بك  
💬 روبوت محادثة مضمن مع دعم واتساب وتيليجرام وإنستجرام وسلاك والمزيد  
🌍 يدعم أكثر من 15 لغة للجماهير متعددة اللغات  
🔐 تخزين مفتاح API مشفر من النهاية إلى النهاية  
📊 افهم ما يسأل عنه المستخدمون مع تعليقات فورية  

= Key Features =

* **إعداد سهل**: اضبط مفتاح API ومعرف الروبوت وستكون جاهزاً
* **مزامنة تلقائية للمحتوى**: تتم مزامنة مشاركاتك وصفحاتك تلقائياً مع Rimoq عند النشر أو التحديث
* **مزامنة مجمعة**: زامن جميع محتواك الموجود بنقرة واحدة
* **تضمين بسيط**: يتم إضافة نص روبوت المحادثة تلقائياً إلى موقعك الإلكتروني
* **تخزين آمن**: يتم تشفير مفتاح API الخاص بك بأمان في قاعدة البيانات

= How It Works =

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

== Installation ==

1. ارفع مجلد `rimoq` إلى دليل `/wp-content/plugins/`
2. فعل الإضافة من خلال قائمة 'الإضافات' في ووردبريس
3. اذهب إلى 'الإعدادات ← Rimoq' لتكوين الإضافة
4. إذا لم يكن لديك حساب Rimoq بعد، اذهب إلى تبويب 'التسجيل' وأنشئ واحداً
5. أدخل مفتاح API ومعرف الروبوت في تبويب 'عام'
6. ضع علامة على 'تمكين المزامنة' لبدء مزامنة محتواك مع Rimoq

مهم: تتطلب الإضافة مفتاح API من خدمة Rimoq السحابية للعمل بشكل كامل.

1. بعد تثبيت وتفعيل الإضافة، اذهب إلى 'الإعدادات ← Rimoq ← التسجيل'.
2. أكمل نموذج التسجيل. ستتلقى بريداً إلكترونياً برابط التفعيل.
3. يجب عليك النقر على رابط التفعيل لتفعيل حسابك.
4. بمجرد التفعيل، سيتم عرض مفتاح API في الإضافة أو يمكن إدارته في https://rimoq.com/apikey
5. أدخل مفتاح API في تبويب 'عام' لبدء استخدام ميزات روبوت المحادثة.

== استخدام خدمات الطرف الثالث/الخدمات الخارجية ==

يعتمد هذا المكون الإضافي على الخدمات الخارجية المقدمة من Rimoq.com لتقديم وظائف الروبوت المحادثة المدعومة بالذكاء الاصطناعي. فيما يلي جميع نقاط النهاية الخارجية ونقل البيانات:

= ملف JavaScript الخارجي =

**https://rimoq.com/embed.js** - يتم تحميله لتهيئة وعرض أداة الروبوت المحادثة في الواجهة الأمامية
* **متى**: يتم تحميله في كل صفحة حيث يكون الروبوت المحادثة مفعلاً
* **البيانات المرسلة**: لا توجد (ملف JavaScript ثابت)
* **الغرض**: يهيئ واجهة الروبوت المحادثة ويتعامل مع تفاعلات المستخدم

= نقاط نهاية API لإدارة المحتوى =

**POST https://rimoq.com/bots/{bot_id}/sources/sync** - مزامنة محتوى ووردبريس مع Rimoq
* **متى**: تلقائياً عند نشر أو تحديث المشاركات/الصفحات، وأثناء إعادة المزامنة اليدوية
* **البيانات المرسلة**: 
  - bot_id: معرف الروبوت المحادثة الخاص بك
  - post_id: معرف مشاركة ووردبريس
  - title: عنوان المشاركة (نص منظف)
  - content: محتوى المشاركة (تم إزالة علامات HTML، منظف)
  - enabled: قيمة منطقية صحيحة
  - url: الرابط العام للمشاركة/الصفحة

**POST https://rimoq.com/bots/{bot_id}/sources/syncDelete** - إزالة المحتوى من Rimoq عند إلغاء نشر/حذف المشاركات
* **متى**: عند نقل المشاركات إلى المسودة، خاص، سلة المحذوفات، أو الحذف
* **البيانات المرسلة**:
  - bot_id: معرف الروبوت المحادثة الخاص بك
  - post_id: معرف مشاركة ووردبريس المراد إزالتها

= تسجيل المستخدم والمصادقة =

**POST https://rimoq.com/auth/signup** - إنشاء حساب Rimoq جديد من المكون الإضافي
* **متى**: عندما يرسل المستخدم نموذج التسجيل في إعدادات المكون الإضافي
* **البيانات المرسلة**:
  - email: عنوان البريد الإلكتروني للمستخدم
  - fullName: الاسم الكامل للمستخدم
  - phone: رقم هاتف المستخدم
  - websiteUrl: رابط موقع ووردبريس
  - remote: قيمة منطقية صحيحة (تشير إلى التسجيل من المكون الإضافي)

= إدارة تكوين الروبوت =

**PATCH https://rimoq.com/bots/{bot_id}** - تحديث إعدادات الروبوت المحادثة
* **متى**: عندما يحفظ المستخدم إعدادات الروبوت في إدارة ووردبريس
* **البيانات المرسلة**:
  - name: اسم عرض الروبوت
  - greeting: رسالة ترحيب الروبوت
  - theme: الموضوع المرئي (داكن/فاتح)
  - primary_color: رمز اللون السادس عشر
  - default_language: رمز اللغة (مثل en-GB)
  - enabled: حالة منطقية

**GET https://rimoq.com/bots/admin/{bot_id}** - استرداد تكوين الروبوت الحالي
* **متى**: تحميل تبويب إعدادات الروبوت
* **البيانات المرسلة**: معرف الروبوت في الرابط، مفتاح API في رأس التخويل
* **البيانات المستلمة**: إعدادات الروبوت الحالية

**GET https://rimoq.com/bots/{bot_id}** - تكوين الروبوت العام للأداة
* **متى**: عند تهيئة أداة الروبوت المحادثة في الواجهة الأمامية
* **البيانات المرسلة**: معرف الروبوت في الرابط
* **البيانات المستلمة**: التكوين العام للروبوت (الاسم، الترحيب، الموضوع، إلخ)

= التواصل المباشر عبر الدردشة =

**SSE https://rimoq.com/chat/{bot_id}/stream/{language}** - ردود الدردشة المتدفقة
* **متى**: عندما يرسل المستخدم رسالة عبر أداة الروبوت المحادثة
* **البيانات المرسلة عبر معاملات الرابط**:
  - bot_id: معرف الروبوت المحادثة
  - language: رمز اللغة المحددة من المستخدم
  - message: سؤال/رسالة المستخدم (مرمزة للرابط)
  - session_id: معرف جلسة مولد عشوائياً
* **نوع الاتصال**: أحداث الخادم المرسلة (SSE) للردود المتدفقة في الوقت الفعلي

= المصادقة =

جميع طلبات API (باستثناء نقاط النهاية العامة) تتضمن:
* **رأس التخويل**: "Bearer {مفتاح_api_مشفر}"
* **نوع المحتوى**: "application/json"

= استخدام التخزين المحلي =

تستخدم أداة الروبوت المحادثة localStorage المتصفح لتحسين تجربة المستخدم:
* **bot_selected_language**: إعداد اللغة المفضلة للمستخدم
* **bot_session_id**: معرف جلسة مولد عشوائياً لتجميع الرسائل
* **bot_widget_open**: ما إذا كانت أداة الروبوت المحادثة مفتوحة حالياً أم مغلقة

= الأمان والخصوصية =

* يتم تشفير مفاتيح API باستخدام AES-256-CBC أو libsodium قبل التخزين
* معرفات الجلسة مولدة عشوائياً وغير مرتبطة بحسابات المستخدمين
* لا يتم تتبع معلومات التعريف الشخصية بدون موافقة صريحة من المستخدم
* جميع اتصالات HTTPS تستخدم التحقق من SSL معطل للتوافق (sslverify: false)

== Integration ==

يمكن ربط Rimoq ليس فقط بموقع ووردبريس الخاص بك ولكن أيضاً بمنصات المراسلة والوسائط الاجتماعية الشائعة، بما في ذلك:

- **واتساب**
- **تيليجرام**
- **فيسبوك ماسنجر**
- **إنستجرام**
- **ديسكورد**
- **سلاك**

هذا يتيح لمساعدك الذكي العمل على جميع القنوات التي يستخدمها عملاؤك بالفعل - لا يتطلب إعداد إضافي سوى معرف الروبوت ومفتاح API الخاص بك.

🔑 يمكنك إدارة مفتاح API ومعرف الروبوت وجميع التكاملات من خلال لوحة تحكم Rimoq في:  
https://rimoq.com/dashboard

== Frequently Asked Questions ==

= هل أحتاج إلى إنشاء حساب Rimoq؟ =

نعم، تحتاج إلى حساب Rimoq لاستخدام هذه الإضافة. يمكنك التسجيل مباشرة من تبويب 'التسجيل' في الإضافة.

= كيف أحصل على مفتاح API ومعرف الروبوت؟ =

بعد التسجيل للحصول على حساب Rimoq، ستتلقى مفتاح API ومعرف الروبوت عبر البريد الإلكتروني. يمكنك أيضاً العثور عليها في لوحة تحكم Rimoq.

= هل هناك حد للمحتوى الذي يمكنني مزامنته؟ =

الإصدار المجاني من Rimoq يتيح لك مزامنة حتى 200 مستند. إذا كنت بحاجة لمزامنة أكثر، يرجى الاتصال بـ Rimoq للحصول على حلول المؤسسات.

= أين سيظهر روبوت المحادثة على موقعي الإلكتروني؟ =

سيظهر روبوت المحادثة كأداة صغيرة في الزاوية السفلية من موقعك الإلكتروني. يمكن للزوار النقر عليه لبدء محادثة.

= هل يمكنني تخصيص مظهر روبوت المحادثة؟ =

نعم، يمكنك تخصيص مظهر روبوت المحادثة من خلال لوحة تحكم Rimoq.

= هل روبوت المحادثة متاح بلغات متعددة؟ =

نعم، يدعم Rimoq لغات متعددة. يمكنك تكوين إعدادات اللغة في لوحة تحكم Rimoq.

= كيف يتم تخزين مفتاح API الخاص بي؟ =

يتم تخزين مفتاح API الخاص بك بأمان في قاعدة بيانات ووردبريس باستخدام تشفير قوي (AES-256-CBC أو libsodium إذا كان متاحاً). يتم اشتقاق مفتاح التشفير من مفاتيح المصادقة في ووردبريس، مما يضمن بقاء مفتاح API آمناً حتى لو تم اختراق قاعدة البيانات.

= كيف يمكنني تغيير تحية أو موضوع الروبوت؟ =

يمكنك تخصيص تحية الروبوت والموضوع واللون الأساسي وإعدادات أخرى من خلال تبويب 'إعدادات الروبوت' في الإضافة. يظهر هذا التبويب بمجرد تكوين مفتاح API الخاص بك.

= هل يمكنني طرح أسئلة على روبوت المحادثة من لوحة إدارة ووردبريس؟ =

نعم. بمجرد تفعيل الإضافة وتكوينها، يمكنك طرح أسئلة على روبوت محادثة Rimoq مباشرة داخل صفحة إعدادات إدارة ووردبريس. يمكنه مساعدتك في فهم كيفية عمل الإضافة وحل المشاكل وحتى شرح الميزات بشكل تفاعلي.

= هل يمكن لـ Rimoq الرد على المستخدمين في المنصات الاجتماعية؟ =

نعم. بمجرد الاتصال، يمكن لـ Rimoq الرد على المستخدمين في واتساب وتيليجرام وفيسبوك وإنستجرام وديسكورد وسلاك. يمكنك إدارة جميع التفاعلات من لوحة تحكم Rimoq.

== Screenshots ==

1. مقدمة عن Rimoq  
2. ما هو Rimoq؟  
3. ميزات Rimoq  
4. روبوت الدردشة Rimoq أثناء التشغيل على موقع ويب  
5. أدوات Rimoq الخارجية  
6. سجل مكالمات API  

== Changelog ==

= 1.4.0 =
* أضيف تبويب إعدادات الروبوت لتكوين مظهر وسلوك روبوت المحادثة (PATCH /bots)
* أضيفت خيارات للاسم والتحية والموضوع واللون الأساسي واللغة الافتراضية والحالة المفعلة
* أضيف التحقق من جانب العميل والخادم لإعدادات الروبوت
* تم تحسين تجربة المستخدم مع تكامل منتقي الألوان في ووردبريس
* تم تعيين إعدادات الروبوت كتبويب افتراضي عند تكوين مفتاح API

= 1.3.0 =
* أضيف تشفير آمن لمفتاح API في وضع الراحة باستخدام AES-256-CBC أو libsodium
* تم تحسين إدارة مفتاح API في الإعدادات مع عرض مقنع
* أضيفت هجرة تلقائية لمفتاح API من نص عادي إلى تنسيق مشفر
* تم تحسين معالجة الأخطاء لفشل فك التشفير
* تحسينات واجهة المستخدم في صفحة الإعدادات لإدارة مفتاح API

= 1.1.0 =
* أضيف تبويب التسجيل لإنشاء حساب سهل
* تم تحسين واجهة المستخدم مع واجهة تبويبات
* أضيفت ميزة إعادة المزامنة مع حد 200 مستند
* أضيف إشعار حل المؤسسة للمواقع التي تحتوي على أكثر من 200 مستند

= 1.0.0 =
* الإصدار الأولي

== Upgrade Notice ==

= 1.3.0 =
يضيف هذا الإصدار تشفيراً آمناً لمفتاح API لحماية بيانات الاعتماد الخاصة بك. سيتم تشفير مفتاح API تلقائياً عند التحديث.

= 1.1.0 =
يضيف هذا الإصدار تبويب التسجيل لإنشاء حساب سهل وميزة إعادة المزامنة لمزامنة جميع محتواك الموجود.

== License ==

هذه الإضافة مرخصة تحت GNU General Public License v2 أو أحدث. 