نصب چت‌بات روی سایت با یک خط اسکریپت
ویجت پلکسیت یک تگ اسکریپت است که روی هر صفحهٔ HTML کار می‌کند. کد آماده با کلید سایت شما در تب «نصب» هر دستیار است؛ آن را یک بار در قالب سایت بگذارید تا ویجت در همهٔ صفحه‌ها ظاهر شود.
ویجت سایت با یک خط اسکریپت، قدم‌به‌قدم
- ۱
دستیار را آماده کنید
دستیار را بسازید، سند اضافه کنید و در گفت‌وگوی آزمایشی بسنجید.
- ۲
تب نصب را باز کنید
نام، رنگ، لوگو، پیام خوش‌آمد و سمت صفحه را تنظیم کنید و دامنهٔ سایت را مجاز کنید.
- ۳
کد را کپی کنید
کد آماده را با دکمهٔ «کپی کد» بردارید؛ کلید سایت شما داخل آن است.
- ۴
پیش از </body> بگذارید
کد را درست پیش از بسته‌شدن تگ body در قالب مشترک همهٔ صفحه‌ها قرار دهید.
کد را کپی کنید، کلید خودتان را بگذارید
مقدار wk_… را با کلید سایتی که در تب «نصب» پنل می‌بینید جایگزین کنید؛ یا کد کامل را مستقیم از همان‌جا کپی کنید.
ساختار کد نصب
<script
src="https://widget.plexit.ir/loader.js"
data-site-key="wk_کلید_سایت_شما"
data-position="right"
async
></script>کد دقیق را از تب «نصب» کپی کنید. اگر در کد پنل ویژگی‌های data-widget-src و data-api-base هم آمده، آن‌ها را حذف نکنید.
نسخهٔ کامل ویجت
<script
src="https://widget.plexit.ir/loader.js"
data-site-key="wk_کلید_سایت_شما"
data-ui="elements"
async
></script>با data-ui="elements" نسخهٔ کامل بارگذاری می‌شود که پاسخ‌ها را با قالب‌بندی Markdown و منابع نشان می‌دهد؛ بدون آن، نسخهٔ سبک با کمترین حجم.
پیش از انتشار بدانید
- اسکریپت async بارگذاری می‌شود و ویجت در iframe جداگانه اجرا می‌شود.
- data-position سمت اولیهٔ حباب را تعیین می‌کند: right یا left.
- اگر اسکریپت دو بار در صفحه قرار بگیرد، ویجت فقط یک بار نمایش داده می‌شود.
- بدون data-site-key ویجت بارگذاری نمی‌شود و خطا در کنسول مرورگر ثبت می‌شود.
پرسش‌های رایج: ویجت سایت با یک خط اسکریپت
کد را کجای صفحه بگذارم؟
درست پیش از بسته‌شدن تگ body، در قالب یا فایلی که در همهٔ صفحه‌ها مشترک است؛ مثل فوتر سایت. این‌طور ویجت در همهٔ صفحه‌ها ظاهر می‌شود.
کلید سایت (site key) محرمانه است؟
خیر؛ کلید سایت در کد HTML عمومی قرار می‌گیرد و قرار نیست مخفی بماند. برای جلوگیری از استفادهٔ دیگران، دامنه‌های مجاز را در تب نصب تعیین کنید. کلید سایت با کلید API فرق دارد.
تغییر رنگ یا پیام خوش‌آمد نیاز به تغییر کد دارد؟
خیر؛ ظاهر و رفتار ویجت از پنل خوانده می‌شود و تغییرات بدون دست زدن به کد سایت روی ویجت همهٔ بازدیدکنندگان اعمال می‌شود.
ویجت جلوی بارگذاری سایت را می‌گیرد؟
خیر؛ اسکریپت با async بارگذاری می‌شود و پنجرهٔ گفت‌وگو جدا از صفحهٔ شما اجرا می‌شود.
بعد از نصب، دستیار چه کاری انجام دهد؟
کد نصب اختصاصی شما در پنل آماده است
ثبت‌نام رایگان است و به کارت بانکی نیاز ندارد. اسنادتان را بارگذاری کنید، در زمین تمرین امتحانش کنید و با یک خط کد روی سایت بگذارید.