نصب کمتر از پنج دقیقه

پشتیبانی هوشمند را به هر سایتی اضافه کنید

افزونه آماده وردپرس یا یک تکه کد جاوااسکریپت؛ با همان برند، دانش، صف کارشناسان و امنیت فضای کاری شما.

بدون دستکاری قالببارگذاری Lazyسازگار با موبایلنشست امضاشده
کلید عمومی ویجت

کد آماده مخصوص برند شما

کلید را از پنل «برند و ویجت» بردارید. این کلید Secret نیست و فقط فضای پشتیبانی را مشخص می‌کند.

نصب در وردپرس

  1. ۱. فایل ZIP را دانلود و از «افزونه‌ها ← افزودن» نصب کنید.
  2. ۲. در «تنظیمات ← همراه‌یار» کلید عمومی را وارد کنید.
  3. ۳. دامنه وردپرس را در Allowed Origins ویجت ثبت کنید.
  4. ۴. موقعیت، رنگ و زمان خوش‌آمدگویی را انتخاب و ذخیره کنید.
دانلود افزونه وردپرس

نصب در هر سایت دیگری

کد زیر را یک‌بار، ترجیحاً پیش از بسته‌شدن تگ 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>

شناسایی مشتری و ارسال Context

برای اتصال مکالمه به 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>

React، Vue، Angular و SPA

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 نشست در سرور امضا می‌شود و داخل وردپرس هیچ کلید محرمانه‌ای قرار نمی‌گیرد.