رفتن به محتوای اصلی
مستندات نجوا

دریافت توکن کاربر

با اسکریپت پوش نجوا، توکن اختصاصی هر کاربر را در مرورگر بگیرید تا بتوانید بعداً برای او پوش هدفمند بفرستید.

برای ارسال پوش نوتیفیکیشن به یک کاربر مشخص (نه همهٔ اعضا)، اول باید توکن اختصاصی او را داشته باشید. این توکن را اسکریپت پوش نجوا — که روی وب‌سایت شما نصب است — در سمت کلاینت (مرورگر) در اختیارتان می‌گذارد؛ معیار یکتا بودن آن، همان دستگاهی است که کاربر با آن در سرویس پوش عضو (subscribe) شده است.

منبع این راهنما

این محتوا از صفحهٔ عمومی مستندات فنی وب‌سرویس‌های نجوا منتقل شده، نه از کد اسکریپت پوش. اگر رفتاری که می‌بینید با این‌جا فرق داشت، به نسخهٔ فعلی اسکریپت (window.NAJVA) اعتماد کنید و از طریق تیکت پشتیبانی خبر دهید تا این صفحه به‌روزرسانی شود.

پیش‌نیاز

سرویس پوش نوتیفیکیشن باید از پنل نجوا فعال و اسکریپت آن روی وب‌سایت شما نصب شده باشد (از مسیر «تنظیمات ← تنظیمات اسکریپت» در پنل).

دو راه برای گرفتن توکن

نجوا در scope اختصاصی خودش در window، دو تابع جدا در اختیار شما می‌گذارد:

۱. رویداد لحظهٔ عضویت — najvaUserSubscribed

این تابع دقیقاً یک بار، بلافاصله بعد از عضو شدن کاربر، اجرا می‌شود و توکن را به‌عنوان پارامتر ورودی می‌گیرد. کد زیر را در <head> وب‌سایت خود قرار دهید:

<script>
  window.NAJVA.najvaUserSubscribed = function (najva_user_token) {
    // در این بخش می‌توانید از توکن کاربر استفاده نمایید. به عنوان مثال:
    alert(najva_user_token)
  }
</script>

مناسب زمانی است که می‌خواهید همان لحظهٔ عضویت، توکن را به سرور خودتان بفرستید (مثلاً برای پیوند دادن به شناسهٔ کاربری داخلی‌تان).

۲. خواندن توکن هر زمان دیگر — getUserToken

این تابع در لحظهٔ فراخوانی، اگر کاربر عضو باشد توکن را برمی‌گرداند و در غیر این صورت null:

<script>
  const userToken = await window.NAJVA.getUserToken()
  // در این بخش می‌توانید از توکن کاربر استفاده نمایید. به عنوان مثال:
  alert(userToken)
</script>

از این تابع برای خواندن توکن در هر جای دیگر کد خودتان — نه فقط لحظهٔ عضویت — استفاده کنید؛ مثلاً وقتی کاربر وارد حساب کاربری‌اش می‌شود و می‌خواهید توکن پوش را به شناسهٔ کاربری‌اش وصل کنید.

توکن را در سرور خودتان ذخیره کنید

هیچ‌کدام از این دو تابع، توکن را خودکار به سرور شما نمی‌فرستند — این کار برعهدهٔ خود شماست. توکن را از مرورگر به بک‌اند خودتان بفرستید و آن‌جا (نه در کد کلاینت) ذخیره کنید، چون برای ارسال به توکن خاص به آن نیاز خواهید داشت.

گام بعدی

توکن‌های ذخیره‌شده را نگه دارید تا هر وقت خواستید پیام هدفمند بفرستید: