API پیام‌رسان در مرورگر

پیام‌رسان با همان یک خط کد کار می‌کند؛ این‌ها برای وقتی است که سایتتان بخواهد با آن حرف بزند: از دکمهٔ خودتان بازش کنید، کاربر واردشده را معرفی کنید، یا بدانید کِی پیام نخوانده دارد.

ویژگی‌های تگ

<script src="https://goya24.com/widget.js"
  data-key="d24_pk_..."
  data-lang="fa"
  data-position="right"
  data-horizontal-padding="24"
  data-vertical-padding="24"
  defer></script>

• data-key — کلید عمومی فضای کاری، از «تنظیمات → نصب».
• data-lang — زبان رابط پیام‌رسان: fa یا en.
• data-position — left یا right؛ فاصله از لبه‌ها با data-horizontal-padding و data-vertical-padding به پیکسل.
• data-user — کاربر واردشده به‌شکل JSON: id، hash، email، name، phone، plan. با id و hash (امضای سرور شما) هویت اثبات‌شده حساب می‌شود؛ بدون آن‌ها فقط یک ادعاست.

متدها

window.goya24.open();      // باز کردن پنل از دکمهٔ خودتان
window.goya24.close();
window.goya24.toggle();
window.goya24.identify({ user: { id: "42", name: "سارا" }, userHash: "…" });
window.goya24.getState();  // { open, unread, ready }
window.goya24.destroy();   // برداشتن کامل، برای اپ‌های تک‌صفحه‌ای

رویدادها

const off = window.goya24.on("unread", (count) => {
  document.title = count ? `(${count}) پشتیبانی` : "پشتیبانی";
});
// ready · open · close · unread · error
off(); // یا window.goya24.off("unread", handler)