راهنمای فنی ویجت

نصب ویجت چت آنلاین راوین

کد اختصاصی سایت را اضافه کنید، نصب را بررسی کنید و پنجره گفتگو را متناسب با مسیر کاربر کنترل کنید؛ راه‌اندازی اولیه کمتر از دو دقیقه زمان می‌برد.

راهنمای رسمیمطابق نسخه فعلی راوین چت
۰۱

نصب سریع روی سایت

کد زیر را پیش از بسته‌شدن تگ </body> قرار دهید و مقدار YOUR_API_KEY را با کلید سایت خود جایگزین کنید.

<script>
  window.ravin = window.ravin || { q: [] };
  window.ravin.q.push(['init', {
    apiKey: 'YOUR_API_KEY',
    baseUrl: 'https://ravinchat.com'
  }]);
</script>
<script src="/js/ravin-chat.js" async></script>

کلید اختصاصی را از پنل، بخش «سایت‌ها» و صفحه سایت موردنظر بردارید. پس از ذخیره کد، از همان صفحه گزینه بررسی نصب را اجرا کنید.

  • زبان خودکار: زبان ویجت از ویژگی lang صفحه تشخیص داده می‌شود.
  • زبان دستی: برای تعیین صریح زبان از language: 'fa' یا language: 'en' استفاده کنید.
  • امنیت کلید: اگر کلید سایت را دوباره تولید کردید، کد نصب سایت را نیز به‌روزرسانی کنید.
۰۲

بازکردن گفتگو با دکمه دلخواه

ویژگی data-ravin-open را به هر لینک یا دکمه‌ای اضافه کنید تا پنجره گفتگو با کلیک کاربر باز شود.

<a href="#" data-ravin-open>گفتگو با پشتیبانی</a>
  • ravin('open')بازکردن پنجره گفتگو
  • ravin('close')بستن پنجره گفتگو
  • ravin('toggle')تغییر وضعیت باز یا بسته
۰۳

نصب بدون کدنویسی روی وردپرس

از صفحه سایت موردنظر در پنل، فایل آماده ravin-chat.zip را دانلود کنید. کلید همان سایت از قبل داخل افزونه تنظیم شده است.

۰۱

بارگذاری افزونه

در پیشخوان وردپرس وارد «افزونه‌ها ← افزودن افزونه تازه ← بارگذاری افزونه» شوید.

۰۲

نصب و فعال‌سازی

فایل ZIP را انتخاب کنید، نصب را بزنید و سپس افزونه راوین چت را فعال کنید.

۰۳

بررسی نمایش ویجت

سایت را در یک پنجره ناشناس باز کنید و نمایش دکمه گفتگو را بررسی کنید.

۰۴

صفحه اختصاصی گفتگو

اگر وب‌سایت ندارید یا می‌خواهید لینک مستقیم پشتیبانی بفرستید، از صفحه اختصاصی گفتگو با کلید سایت استفاده کنید.

https://ravinchat.com/chat/YOUR_API_KEY
۰۵

مسیرهای عمومی API ویجت

این مسیرها توسط ویجت رسمی راوین استفاده می‌شوند. برای یکپارچه‌سازی سمت سرور و دسترسی‌های مدیریتی، توکن را از بخش «دسترسی API» پنل بسازید.

  • GET /api/widget/{apiKey}/configدریافت تنظیمات عمومی ویجت
  • POST /api/widget/{apiKey}/initایجاد یا بازیابی نشست گفتگو
  • POST /api/widget/{apiKey}/sendارسال پیام بازدیدکننده
  • GET /api/widget/{apiKey}/pollدریافت پیام‌ها و وضعیت جدید

نکته امنیتی: توکن مدیریتی API را هرگز داخل کد عمومی سایت یا فایل‌های مرورگر قرار ندهید.