آموزش API ارسال پوش نوتیفیکیشن گروهی
در مقاله قبل در مورد راهنمای وب سرویس پوش نوتیفیکیشن صحبت کردیم در این مقاله به معرفی وب سرویس ارسال گروهی پوش نوتیفیکیشن میپردازیم.
علاوه بر ارسال پیام جابک، شما میتوانید از طریق API پوشنوتیفیکیشن ارسال کنید. این کار از دو متد پست notifyUsers و notifyUser انجام میشود.
ارسال به گروهی از کاربران (notifyUsers)
در این متد (notifyUsers) میتوانید برای گروهی از کاربران (سگمنت) یا همه کاربران پوشنوتیفیکیشن از طریق API ارسال کنید.
نکته: توجه داشته باشید که در متد notifyUsers میتوانید از payload متدهای toUsers و byQuery هم استفاده کنید.
ساختار درخواست
لینک پایه: https://sandbox.push.adpdigital.com/api/push/notifyUsers
نمونه cURL:
curl -X POST \
“https://sandbox.push.adpdigital.com/api/push/notifyUsers?access_token=<ACCESS_TOKEN>” \
-H “accept: application/json” \
-H “Content-Type: application/json” \
-d “@payload.json”
پارامترها
پارامترها | توضیح | نوع مقدار | مثال |
target * | سگمنت مورد نظر یا * برای کانال عمومی | string | یک سگمنت-id موجود یا فیلترهای سگمنت جدید |
content * | متن پیام | string | سلام |
trackId | تعیین شناسه ردگیری جداگانه برای رصد پیام | string | adp-1397-6-11 |
live | فقط کاربرانی که در لحظه ارسال، برنامه را باز دارند دریافت میکنند (زنده) | boolean | false |
autoNotify | نمایش پیام توسط گوگل صورت میگیرد | boolean | false |
useAsAlert | استفاده متن پیام به عنوان متن اعلان | boolean | true |
پارامترهای اعلان (Notification)
پارامترها | توضیح | نوع مقدار | مثال |
title * | عنوان اعلان | string | ثبت درخواست |
body | متن اعلان | string | سفارش شما ثبت شد |
groupId | برای گروهبندی شخصی اعلانها | string | news |
icon | تصویر اعلان | string | نام تصویر |
sound | صدای اعلان (به فرمت صدا دقت داشته باشید) | string | نام صدا |
clickUrl | لینک هنگام کلیک | string | لینک |
ledColor | تنظیم رنگ led (فقط اندروید) | string | کد رنگ HEX |
smallIcon | آیکون کوچک اعلان (فقط اندروید) | string | نام آیکون |
(id (action | شناسه اکشن | string | check |
(title (action | عنوان اکشن | string | status |
(options (action | رفتار اکشن (فقط آیاواس) | number | 1 |
(icon (action | نام آیکون در فولدر drawable (فقط اندروید) | string | نام آیکون |
mediaType | نوع رسانه | string | jpeg |
mediaUrl | لینک رسانه | string | لینک |
contentAvailable | برای انجام یک آپدیت بیصدا در بکگراند یا فورگراند مقدار 1 را بگذارید | boolean | 1 |
mutableContent | برای پشتیبانی از اعلان چندرسانهای مقدار 1 را حتما قرار دهید | boolean | 1 |
category | شناسه اعلان برای ذخیره آن | string | delivery |
نکته : نماد * در جدول پارامترها به معنی الزامی بودن پارامتر است و بدون آن درخواست شما صورت نمیگیرد. (برای پوشنوتیفیکیشن عمومی در قسمت target به جای سگمنت، {} را خالی بگذارید.)
نکته : در پارامترهای اعلان، پارامتر options یا همان رفتار اکشن (فقط در آیاواس) میتوانید عدد ۱ برای اکشن Authentication Required (اکشن در صورت قفل نبودن دستگاه اجرا میشود)، ۲ برای اکشن Destructive (اکشن تسک مخرب انجام میدهد)، ۴ برای اکشن Foreground (اکشن موجب باز شدن اپ در فورگراند میشود) و جمع این اعداد را برای ترکیب آنها با هم قرار دهید.
پاسخ
پاسخ درخواستهای ارسال پیام به صورت تعداد دستگاههایی که پیام به آنها ارسال میشود، میباشد.
{
“count”: number
}
مثال
به مثال زیر از متد notifyUsers توجه کنید:
درخواست
بسته به نوع نوتیفیکیشنی که میخواهید ارسال کنید میتوانید از انواع پارامترها استفاده کنید. به عنوان مثال میخواهید یک نوتیفیکیشنی را برای اعلام انتشار نسخه جدید اپلیکیشن خود به همه کاربران، ارسال کنید.
curl -X POST \
“https://sandbox.push.adpdigital.com/api/push/notifyUsers?access_token=<ACCESS_TOKEN>” \
-H “accept: application/json” \
-H “Content-Type: application/json” \
-d “{ \”target\”: \”{}\”, \”content\”: \”نسخه جدید اپلیکیشن رسید!\”}”
نکته : در قسمت سگمنت، فیلترهای پیشفرض چابک installDate (اولین بازدید یا نصب) ، launchTime (آخرین بازدید) ، launchCount (تعداد بازدید) ، clientVersion (نسخه برنامه) ، osVersion (نسخه سیستمعامل) ، deviceType (نوع دستگاه) ، tags (تگها) ، nearBy (موقعیت مکانی) میباشند. درصورت اضافه کردن سگمنت از سوی خودتان هم فقط کافیست نام آن را وارد نمایید.
پاسخ
همانطور که میبینید درخواست شما با موفقیت انجام شد و نوتیفیکیشن شما به ۶۴۰ (count: 640) دستگاه ارسال شد.
حالا میتوانید در پنل بخش پیامها قسمت پیامها جزئیات ارسال و تحویل پیام خود را مشاهده کنید.
نکته : برای تست کردن این عمل میتوانید به این لینک مراجعه کنید.
در این مقاله در مورد وب سرویس ارسال گروهی پوش نوتیفیکیشن توضیح دادیم در مقاله بعد در مورد وب سرویس ارسال نوتیفیکیشن خصوصی توضیح میدهیم.