نصب در وردپرس
- ۱. فایل ZIP را دانلود و از «افزونهها ← افزودن» نصب کنید.
- ۲. در «تنظیمات ← همراهیار» کلید عمومی را وارد کنید.
- ۳. دامنه وردپرس را در Allowed Origins ویجت ثبت کنید.
- ۴. موقعیت، رنگ و زمان خوشآمدگویی را انتخاب و ذخیره کنید.
افزونه آماده وردپرس یا یک تکه کد جاوااسکریپت؛ با همان برند، دانش، صف کارشناسان و امنیت فضای کاری شما.
کلید را از پنل «برند و ویجت» بردارید. این کلید Secret نیست و فقط فضای پشتیبانی را مشخص میکند.
کد زیر را یکبار، ترجیحاً پیش از بستهشدن تگ body قرار دهید. ویجت بهصورت Async و Lazy بارگذاری میشود.
<script
async
src="https://help.aa0.ir/api/widget/YOUR_PUBLIC_KEY/script"
data-position="bottom-right"
data-launcher-text="پشتیبانی آنلاین"
data-delay="4500"
></script>برای اتصال مکالمه به CRM یا ERP، مشخصات شناختهشده و اطلاعات غیرمحرمانه صفحه را بعد از رویداد Loaded ارسال کنید. رمز عبور، Token یا داده بانکی را هرگز در Context قرار ندهید.
<script
async
src="https://help.aa0.ir/api/widget/YOUR_PUBLIC_KEY/script"
data-position="bottom-right"
data-launcher-text="پشتیبانی آنلاین"
data-delay="4500"
></script>
<script>
window.addEventListener('hamrahyar:loaded', function () {
HamrahyarChat.identify({
name: 'نام مشتری',
email: 'customer@example.com',
externalId: 'crm-user-123'
});
HamrahyarChat.setContext({
product: 'ERP مدارس',
plan: 'enterprise',
orderId: 'ORDER-1024'
});
}, { once: true });
</script>API سراسری همراهیار امکان کنترل پنجره و بهروزرسانی Context در تغییر مسیر را میدهد.
// بعد از تغییر Route در React / Vue / Angular
window.HamrahyarChat?.setContext({
route: window.location.pathname,
pageTitle: document.title
});
// کنترل برنامهای
window.HamrahyarChat?.open();
window.HamrahyarChat?.close();
window.HamrahyarChat?.hide();
window.HamrahyarChat?.show();
// رویدادها
window.HamrahyarChat?.on('open', () => {
console.log('Support chat opened');
});برای جلوگیری از استفاده غیرمجاز، دامنه سایت را در بخش «دامنههای مجاز ویجت» ثبت کنید. Token نشست در سرور امضا میشود و داخل وردپرس هیچ کلید محرمانهای قرار نمیگیرد.