نصب سریع روی سایت
کد زیر را پیش از بستهشدن تگ </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 را هرگز داخل کد عمومی سایت یا فایلهای مرورگر قرار ندهید.