ایران ناتیفیکیشن

ساخت اتوماسیون پوش

یک پوش رویدادمحور تعریف می‌کند.

POSThttps://api.irnoti.com/v1/sdk-apps/{id}/automations
scope: broker.write

اجراها با همان فرایند ارسال عادی می‌روند (بررسی پلن، رسید، تحلیل).

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ اپ.
name *بدنهstringنام (≤۸۰).
triggerEvent *بدنهstringرویدادی که اپ گزارش می‌دهد و اجرا را آغاز می‌کند.
cancelOnEventبدنهstringرویدادی که اجرای در انتظار را لغو می‌کند (مثلاً خرید).
delaySecondsبدنهintegerتأخیر تا ارسال.
capHoursبدنهintegerحداقل فاصلهٔ دو ارسال برای یک دستگاه (ساعت، حداکثر ۲۱۶۰).
message *بدنهobjectمحتوای پوش.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400validation_errorورودی نامعتبر است (جزئیات در پاسخ).

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/sdk-apps/8/automations' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "سبد رهاشده",
  "message": {
    "body": "خرید را کامل کنید",
    "title": "سبدتان منتظر است"
  },
  "capHours": 24,
  "delaySeconds": 3600,
  "triggerEvent": "cart_abandoned",
  "cancelOnEvent": "purchase"
}'
پاسخ نمونه200 OK
{
  "id": "3",
  "status": "active"
}
ساخت اتوماسیون پوش — مستندات API | ایران ناتیفیکیشن