مستندات پوشفا

ارسال بی‌صدا (Silent)

نوتیفیکیشن را بدون صدا و بدون لرزش ارسال کنید؛ پیام روی دستگاه نمایش داده می‌شود اما کاربر را با هشدار صوتی یا لرزشی مزاحم نمی‌شود.

ارسال بی‌صدا چیست؟

وقتی فیلد silent را فعال کنید، نوتیفیکیشن همچنان روی دستگاه نمایش داده می‌شود اما بدون پخش صدا و بدون لرزش. این گزینه برای پیام‌های کم‌اهمیت یا ارسال‌های پرتعداد مناسب است تا تجربه کاربر مختل نشود. توجه کنید که مرورگرها (کروم/فایرفاکس) همچنان نمایش بصری نوتیفیکیشن را الزامی می‌دانند؛ بنابراین ارسال نوتیفیکیشن کاملاً نامرئی ممکن نیست.

استفاده از پنل

در فرم ارسال پوش نوتیفیکیشن، گزینه «ارسال بی‌صدا (بدون صدا و لرزش)» را تیک بزنید. این گزینه برای ارسال تکی، گروهی و تاپیک در دسترس است.

لرزش فقط روی دستگاه‌های Android معنا دارد؛ روی دسکتاپ و iOS اساساً لرزشی وجود ندارد.

پارامتر API

فیلد silent در تمام endpoint‌های ارسال پوشفا پشتیبانی می‌شود:

فیلد توضیح اجباری
silent boolean — اگر true باشد نوتیفیکیشن بدون صدا و بدون لرزش نمایش داده می‌شود (پیش‌فرض false) خیر

نمونه درخواست API

ارسال تکی بی‌صدا:

curl -X POST https://pushfa.com/api/webservices/send-single-message \
  -H "Content-Type: application/json" \
  -d '{
    "api_public_key": "YOUR_PUBLIC_KEY",
    "api_private_key": "YOUR_PRIVATE_KEY",
    "fcm_token": "USER_FCM_TOKEN",
    "title": "به‌روزرسانی موجودی",
    "body": "سبد خرید شما به‌روز شد",
    "silent": true,
    "sendTime": "current"
  }'

محدودیت‌های مرورگر

پشتیبانی از حالت بی‌صدا بسته به مرورگر متفاوت است:

اگر همزمان collapse_id با renotify فعال باشد، برخی مرورگرها (کروم) برای جلب توجه دوباره هشدار می‌دهند و ممکن است حالت بی‌صدا نادیده گرفته شود.
مرورگر وضعیت نکته
Chrome / Edge (Chromium) ✅ کامل گزینه silent اعمال می‌شود (بدون صدا و لرزش)
Firefox ✅ کامل بدون صدا و لرزش نمایش داده می‌شود
Samsung Internet / Android ✅ کامل لرزش نیز حذف می‌شود
Safari iOS ⚠️ محدود رفتار صدا توسط سیستم‌عامل کنترل می‌شود