فقط originهای ثبتشده اجازه ایجاد نشست دارند.
در حال بارگذاری سامانه…
لطفاً چند لحظه منتظر بمانید.
راهنمای یکپارچهسازی
ویجت گفتوگوی نوروفای
ویجت نوروفای راه ارتباط مستقیم بازدیدکنندگان وبسایت شما با تیم پشتیبانی را فراهم میکند. نصب با یک اسکریپت سبک انجام میشود و ظاهر و رفتار ویجت از پنل نوروفای مدیریت خواهد شد.
- نسخه فعلی
- v1
- روش نصب
- JavaScript embed
- ارتباط امن
- HTTPS / WSS
پیشنیازها
قبل از شروع
برای نصب ویجت به دسترسی ویرایش HTML وبسایت و یک کلید عمومی فعال نیاز دارید. کلید عمومی از تنظیمات ویجت در پنل سازمان قابل دریافت است.
۱ویجت فعال
یک ویجت در فضای کاری نوروفای ایجاد و فعال شده باشد.
۲دامنه مجاز
دامنه دقیق وبسایت در فهرست دامنههای مجاز ثبت شده باشد.
۳HTTPS
صفحه production از اتصال امن HTTPS استفاده کند.
شروع سریع
نصب ویجت
کد زیر را پیش از بستهشدن تگ </body> در layout اصلی قرار دهید و مقدار placeholder را با کلید عمومی ویجت خود جایگزین کنید.
<script
src="https://norofy.com/widget/v1/norofy-chat.js?v=32"
data-widget-key="YOUR_PUBLIC_WIDGET_KEY"
data-api-url="https://norofy.com/backend-api"
async
></script>بررسی نصب
پس از انتشار، صفحه را روی دامنه ثبتشده باز کنید. نشانگر گفتوگو باید ظاهر شود. یک پیام آزمایشی ارسال کنید و دریافت آن را در پنل اپراتورها بررسی کنید.
پیکربندی
ویژگیهای تگ نصب
| ویژگی | الزامی | توضیح |
|---|---|---|
src | بله | نشانی نسخه منتشرشده Widget SDK نوروفای. |
data-widget-key | بله | کلید عمومی نصب که ویجت و تنظیمات سازمان را مشخص میکند. |
data-api-url | بله | نشانی عمومی API نوروفای برای ارتباط ویجت. |
async | پیشنهادی | بارگذاری اسکریپت را از رندر محتوای اصلی جدا میکند. |
ظاهر و متنها
رنگها، لوگو، محل نمایش، زبان، جهت متن، پیام خوشآمدگویی و فرم پیش از گفتوگو از پنل نوروفای مدیریت میشوند و به تغییر کد نصب نیاز ندارند.
کنترل سمت مرورگر
JavaScript API
پس از بارگذاری اسکریپت، تابع window.NorofyChat برای کنترل نمایش ویجت در دسترس است. از آن برای اتصال ویجت به دکمهها یا جریانهای رابط کاربری استفاده کنید.
// Open the conversation window
window.NorofyChat("open");
// Close the conversation window
window.NorofyChat("close");
// Hide or show the widget launcher
window.NorofyChat("hide");
window.NorofyChat("show");openپنجره گفتوگو را باز میکند.
closeپنجره را میبندد و launcher را نمایش میدهد.
showویجت را پس از پنهانشدن نمایش میدهد.
hideتمام سطح ویجت را موقتاً پنهان میکند.
اعتماد و امنیت
امنیت و حریم خصوصی
ویجت فقط روی دامنههای مجاز فعال میشود و ارتباط آن با نوروفای روی HTTPS و WebSocket امن انجام میگیرد. نشست بازدیدکننده در مرورگر همان کاربر نگهداری میشود و نباید توسط کد میزبان منتقل یا بازنویسی شود.
در production تمام ارتباطات روی HTTPS/WSS هستند.
کد نصب به credential مدیریتی نیاز ندارد.
فقط فیلدهای ضروری فرم را فعال کنید.
Content Security Policy
اگر وبسایت CSP محدودکننده دارد، مبدا نوروفای را برای اسکریپت، frame و ارتباط شبکه مجاز کنید. این مقادیر را با سیاست موجود خود ادغام کنید.
Content-Security-Policy:
script-src 'self' https://norofy.com;
connect-src 'self' https://norofy.com wss://norofy.com;
frame-src https://norofy.com;
img-src 'self' data: https://norofy.com;پشتیبانی
عیبیابی
ویجت نمایش داده نمیشود
فعالبودن ویجت، صحت کلید عمومی، ثبت دقیق origin شامل پروتکل و دامنه، و بارگذاری فایل JavaScript را بررسی کنید.
پیام ارسال نمیشود
اتصال HTTPS، دسترسی شبکه به دامنه نوروفای و خطاهای مرورگر را بررسی کنید. افزونههای مسدودکننده نیز ممکن است درخواست را متوقف کنند.
در staging کار میکند اما در production نه
دامنه production باید جداگانه در allowlist ثبت شود. زیردامنه و پروتکل باید دقیقاً با origin صفحه مطابقت داشته باشند.
به بررسی فنی بیشتری نیاز دارم
نشانی صفحه، زمان رخداد و پیام خطای مرورگر را بدون ارسال اطلاعات شخصی یا credential برای تیم پشتیبانی بفرستید.
پشتیبانی توسعهدهندگان
ارتباط با تیم فنیبرای یکپارچهسازی همراهتان هستیم.
اگر سناریوی نصب شما خارج از این راهنماست، با تیم فنی نوروفای تماس بگیرید.