=== 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** - برای راه‌اندازی و نمایش ویجت چت‌بات در frontend بارگذاری می‌شود
* **چه زمانی**: در هر صفحه‌ای که چت‌بات فعال است بارگذاری می‌شود
* **داده‌های ارسالی**: هیچ (فایل JavaScript ثابت)
* **هدف**: رابط چت‌بات را راه‌اندازی کرده و تعاملات کاربر را مدیریت می‌کند

= نقاط پایانی API برای مدیریت محتوا =

**POST https://rimoq.com/bots/{bot_id}/sources/sync** - محتوای وردپرس را با Rimoq همگام‌سازی می‌کند
* **چه زمانی**: به طور خودکار هنگام انتشار یا به‌روزرسانی نوشته‌ها/صفحات، و در طول همگام‌سازی دستی
* **داده‌های ارسالی**: 
  - bot_id: شناسه چت‌بات شما
  - post_id: شناسه نوشته وردپرس
  - title: عنوان نوشته (متن پاک شده)
  - content: محتوای نوشته (برچسب‌های HTML حذف شده، پاک شده)
  - enabled: مقدار منطقی درست
  - url: 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: URL سایت وردپرس
  - 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}** - پیکربندی فعلی بات را بازیابی می‌کند
* **چه زمانی**: بارگذاری تب تنظیمات بات
* **داده‌های ارسالی**: شناسه بات در URL، کلید API در هدر Authorization
* **داده‌های دریافتی**: تنظیمات فعلی بات

**GET https://rimoq.com/bots/{bot_id}** - پیکربندی عمومی بات برای ویجت
* **چه زمانی**: ویجت چت‌بات در frontend راه‌اندازی می‌شود
* **داده‌های ارسالی**: شناسه بات در URL
* **داده‌های دریافتی**: پیکربندی عمومی بات (نام، خوشامدگویی، تم، و غیره)

= ارتباط چت بلادرنگ =

**SSE https://rimoq.com/chat/{bot_id}/stream/{language}** - پاسخ‌های چت جریانی
* **چه زمانی**: کاربر پیامی از طریق ویجت چت‌بات ارسال می‌کند
* **داده‌های ارسالی از طریق پارامترهای URL**:
  - bot_id: شناسه چت‌بات
  - language: کد زبان انتخاب شده توسط کاربر
  - message: سوال/پیام کاربر (کدگذاری شده URL)
  - session_id: شناسه جلسه تولید شده تصادفی
* **نوع اتصال**: Server-Sent Events (SSE) برای پاسخ‌های جریانی بلادرنگ

= احراز هویت =

تمام درخواست‌های API (به جز نقاط پایانی عمومی) شامل:
* **هدر Authorization**: "Bearer {کلید_api_رمزگذاری_شده}"
* **Content-Type**: "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)
* گزینه‌هایی برای نام، پیام خوشامدگویی، تم، رنگ اصلی، زبان پیش‌فرض و وضعیت فعال اضافه شد
* اعتبارسنجی سمت کلاینت و سرور برای تنظیمات بات اضافه شد
* بهبود UX با ادغام انتخابگر رنگ وردپرس
* تنظیمات بات به عنوان برگه پیش‌فرض هنگام پیکربندی کلید API تنظیم شد

= 1.3.0 =
* رمزگذاری امن کلید API در حالت استراحت با استفاده از AES-256-CBC یا libsodium اضافه شد
* مدیریت کلید API در تنظیمات با نمایش پوشیده بهبود یافت
* مهاجرت خودکار کلید API از متن ساده به فرمت رمزگذاری شده اضافه شد
* مدیریت خطا برای شکست‌های رمزگشایی بهبود یافت
* بهبودهای UI در صفحه تنظیمات برای مدیریت کلید API

= 1.1.0 =
* برگه ثبت‌نام برای ایجاد آسان حساب اضافه شد
* UI با رابط برگه‌ای بهبود یافت
* ویژگی همگام‌سازی مجدد با محدودیت 200 سند اضافه شد
* اعلان راه‌حل سازمانی برای سایت‌های دارای بیش از 200 سند اضافه شد

= 1.0.0 =
* انتشار اولیه

== Upgrade Notice ==

= 1.3.0 =
این نسخه رمزگذاری امن کلید API را برای محافظت از اعتبارنامه‌های شما اضافه می‌کند. کلید API شما هنگام به‌روزرسانی به طور خودکار رمزگذاری خواهد شد.

= 1.1.0 =
این نسخه برگه ثبت‌نام برای ایجاد آسان حساب و ویژگی همگام‌سازی مجدد برای همگام‌سازی تمام محتوای موجود شما اضافه می‌کند.

== License ==

این افزونه تحت مجوز GNU General Public License نسخه 2 یا جدیدتر قرار دارد. 