ارسال گروهی پوش نوتیفیکیشن با گزارش
ارسال گروهی همراه با امکان گزارش تحویل و کلیک.
POST
https://pushfa.com/api/webservices/send-group-message
کاربرد
وقتی لازم است وضعیت تحویل، کلیک و گیرندگان کمپین را پیگیری کنید از این وبسرویس استفاده کنید.
پارامترهای ورودی
| پارامتر | مقدار | اجباری |
|---|---|---|
| fcm_tokens[] | آرایهای از توکنهای گیرندگان پیام. در صورت استفاده از topic نباید ارسال شود | بله اگر topic وجود نداشته باشد |
| topic | نام تاپیک جهت ارسال به گیرندگان. اگر میخواهید به همه کاربران سرویس ارسال کنید مقدار all را وارد کنید | بله اگر fcm_tokens وجود نداشته باشد |
| device | محدود کردن ارسال به mobile، desktop یا all | خیر |
| api_public_key | شناسه عمومی سرویس | بله |
| api_private_key | شناسه خصوصی سرویس | بله |
| title | عنوان پوش نوتیفیکیشن | بله |
| body | توضیحات پوش نوتیفیکیشن | بله |
| link_url | لینک اصلی پوش نوتیفیکیشن | خیر |
| image_url | آدرس تصویر ضمیمه پوش نوتیفیکیشن | خیر |
| btn_left[title] | عنوان دکمه سمت چپ | اجباری در صورت مقدار داشتن پارامترهای دکمه چپ |
| btn_left[url] | لینک دکمه سمت چپ | اجباری در صورت مقدار داشتن پارامترهای دکمه چپ |
| btn_right[title] | عنوان دکمه سمت راست | اجباری در صورت مقدار داشتن پارامترهای دکمه راست |
| btn_right[url] | لینک دکمه سمت راست | اجباری در صورت مقدار داشتن پارامترهای دکمه راست |
| get_delivery_status | درخواست گزارش تحویل. در ارسال تکی مقدار 1/0 و در ارسال گروهی گزارشدار مقدار true/false پذیرفته میشود | خیر |
| webhook_url | سرویس بومرنگ: اگر گزارش تحویل را درخواست داده باشید، در صورت عدم تحویل نوتیفیکیشن، نتیجه به این آدرس ارسال میشود | خیر |
| get_click_status | درخواست گزارش کلیک روی پیام. در ارسال تکی مقدار 1/0 و در ارسال گروهی گزارشدار مقدار true/false پذیرفته میشود | خیر |
| sendTime | اگر پیام باید اکنون ارسال شود مقدار current و اگر زمانبندی شده است مقدار delay وارد شود | بله |
| time | اگر sendTime برابر delay باشد زمان ارسال را با فرمت Y-m-d H:i وارد کنید | بله اگر sendTime برابر delay باشد |
| ttl | عمر نوتیفیکیشن به ثانیه. در برخی وبسرویسها در صورت عدم ورود، پیشفرض 24 ساعت است | خیر |