নোটিফাই

POST https://api.pushwoosh.com/messaging/v2/notify

একটি একক বার্তা তৈরি এবং সময়সূচী করে।

অনুরোধের কাঠামো

অনুরোধের বডিটি একটি NotifyRequest যার দুটি ধরনের মধ্যে ঠিক একটি থাকে:

• segment: সেগমেন্ট কোড, একটি seglang এক্সপ্রেশন, বা একটি স্ট্রাকচার্ড ফিল্টার এক্সপ্রেশন দ্বারা একটি অডিয়েন্স সেগমেন্টকে টার্গেট করুন।
• transactional: hwids, ইউজার আইডি, পুশ টোকেন, বা টেস্ট ডিভাইসের একটি সুস্পষ্ট তালিকায় পাঠান।

Shape

{
  "segment": { ... }       // OR
  "transactional": { ... }
}

NotifySegment

যে ব্যবহারকারীরা একটি অডিয়েন্স সেগমেন্ট বা ফিল্টার এক্সপ্রেশনের সাথে মেলে তাদের টার্গেট করে।

Field	Type	Description
schedule	Schedule	কখন এবং কিভাবে পাঠাতে হবে। আবশ্যক।
application	string	অ্যাপ্লিকেশন কোড।
platforms	array of Platform	প্ল্যাটফর্ম যা বার্তাটি টার্গেট করে।
code	string	সেগমেন্ট কোড। expression এবং filter_expression-এর সাথে পারস্পরিকভাবে স্বতন্ত্র।
expression	string	Seglang এক্সপ্রেশন।
filter_expression	FilterExpression	স্ট্রাকচার্ড ফিল্টার এক্সপ্রেশন (অ্যাডভান্সড)।
payload	Payload	পুশ / এসএমএস / টেলিগ্রাম / কাকাও পেলোড। email_payload-এর সাথে পারস্পরিকভাবে স্বতন্ত্র।
email_payload	EmailPayload	ইমেল পেলোড।
campaign	string	এই বার্তাটিকে অ্যাট্রিবিউট করার জন্য ক্যাম্পেইন কোড।
frequency_capping	FrequencyCapping	প্রতি-ব্যবহারকারী ফ্রিকোয়েন্সি সীমা।
send_rate	SendRate	পাঠানোর জন্য থ্রোটলিং।
message_type	MessageType	MESSAGE_TYPE_MARKETING (ডিফল্ট) বা MESSAGE_TYPE_TRANSACTIONAL। কন্ট্রোল-গ্রুপ ফিল্টারিং নিয়ন্ত্রণ করে।
dynamic_content_placeholders	map<string, string>	কন্টেন্টে প্লেসহোল্ডার প্রতিস্থাপন করে।
meta_data	object	ফ্রি-ফর্ম মেটাডেটা যা ডাউনস্ট্রিম অ্যানালিটিক্সে ফরোয়ার্ড করা হয়।

উদাহরণ: একটি সেগমেন্টে পাঠান

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "code": "active_users",
      "payload": {
        "content": {
          "localized_content": {
            "en": {
              "ios":     { "body": "Hello!" },
              "android": { "body": "Hello!" }
            }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" },
      "message_type": "MESSAGE_TYPE_MARKETING"
    }
  }'

NotifyTransactional

প্রাপকদের একটি সুস্পষ্ট তালিকায় পাঠায়।

Field	Type	Description
schedule	Schedule	আবশ্যক।
application	string	অ্যাপ্লিকেশন কোড।
platforms	array of Platform	প্ল্যাটফর্ম যা বার্তাটি টার্গেট করে।
test_devices	bool	যদি true হয়, তবে শুধুমাত্র অ্যাপের টেস্ট ডিভাইসগুলিতে পাঠান।
hwids	{ "list": [string, ...] }	শুধুমাত্র এই hwids-গুলিতে পাঠান।
users	{ "list": [string, ...] }	শুধুমাত্র এই ইউজার আইডি-গুলিতে পাঠান।
push_tokens	{ "list": [string, ...] }	শুধুমাত্র এই পুশ টোকেন-গুলিতে পাঠান।
payload	Payload	পুশ / এসএমএস / টেলিগ্রাম / কাকাও পেলোড।
email_payload	EmailPayload	ইমেল পেলোড।
return_unknown_identifiers	bool	যখন true, প্রতিক্রিয়ার unknown_identifiers সেই আইডেন্টিফায়ারগুলিকে তালিকাভুক্ত করে যা পাওয়া যায়নি।
use_latest_user_device	bool	শুধুমাত্র যখন আপনি users টার্গেট করেন তখন প্রযোজ্য। যখন true, বার্তাটি প্রতিটি ব্যবহারকারীর সবচেয়ে সম্প্রতি সক্রিয় ডিভাইসে — সর্বশেষ অ্যাপ্লিকেশন খোলার সময় সহ — পাঠানো হয়, সেই ইউজার আইডির সাথে যুক্ত সমস্ত ডিভাইসের পরিবর্তে। ডিফল্ট false (প্রতিটি ডিভাইসে পাঠান)।
campaign, frequency_capping, send_rate, message_type, dynamic_content_placeholders, meta_data		উপরের NotifySegment দেখুন।

test_devices, hwids, users, এবং push_tokens পারস্পরিকভাবে স্বতন্ত্র। ঠিক একটি সেট করতে হবে।

উদাহরণ: ইউজার আইডি দ্বারা ট্রানজ্যাকশনাল

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "transactional": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "users": { "list": ["user-123", "user-456"] },
      "payload": {
        "content": {
          "localized_content": {
            "en": { "ios": { "body": "Your order has shipped." } }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" },
      "message_type": "MESSAGE_TYPE_TRANSACTIONAL",
      "return_unknown_identifiers": true,
      "use_latest_user_device": true
    }
  }'

প্রতিক্রিয়া

{
  "result": {
    "message_code": "XXXXX-XXXXX-XXXXX",
    "unknown_identifiers": []
  }
}

Field	Type	Description
message_code	string	অনন্য বার্তা কোড। এটি /getMessageDetails এবং বার্তা পরিসংখ্যান এন্ডপয়েন্টের সাথে ব্যবহার করুন।
unknown_identifiers	array of string	অ্যাকাউন্টে পাওয়া যায়নি এমন আইডেন্টিফায়ার। শুধুমাত্র যখন transactional কাইন্ডে return_unknown_identifiers: true সেট করা হয়েছিল তখন এটি পূরণ করা হয়।

শেয়ার্ড টাইপ

Schedule

{
  "at": "2026-05-01T12:00:00Z",
  "follow_user_timezone": true,
  "past_timezones_behaviour": "PAST_TIMEZONES_BEHAVIOUR_SEND_IMMEDIATELY"
}

Field	Type	Description
at	timestamp	পরম পাঠানোর সময় (RFC 3339)। যদি অতীতে হয়, বার্তাটি অবিলম্বে পাঠানো হয়। ভবিষ্যতে সর্বোচ্চ ১৪ দিন।
after	duration	at-এর বিকল্প। “এখন” থেকে এই অফসেটের পরে পাঠান (যেমন "3600s")।
follow_user_timezone	bool	যখন true, প্রতিটি ডিভাইস তার স্থানীয় টাইমজোনে at-এ বার্তাটি গ্রহণ করে।
past_timezones_behaviour	enum	PAST_TIMEZONES_BEHAVIOUR_SEND_IMMEDIATELY (ডিফল্ট), PAST_TIMEZONES_BEHAVIOUR_DO_NOT_SEND, বা PAST_TIMEZONES_BEHAVIOUR_NEXT_DAY। শুধুমাত্র যখন follow_user_timezone true হয় তখন অর্থপূর্ণ।

FrequencyCapping

মার্কেটিং পাঠানোর জন্য প্রতি-ব্যবহারকারী ফ্রিকোয়েন্সি সীমা।

{ "days": 7, "count": 3, "exclude": false, "avoid": true }

• days (int, 1–30): লুক-ব্যাক উইন্ডো।
• count (int): days-এর মধ্যে অনুমোদিত সর্বোচ্চ বার্তা।
• exclude (bool): যারা ইতিমধ্যে ক্যাপে পৌঁছেছে তাদের হার্ড-এক্সক্লুড করুন।
• avoid (bool): যারা ইতিমধ্যে ক্যাপে পৌঁছেছে তাদের সফট-অ্যাভয়েড করুন (তারা এখনও অ্যানালিটিক্সের জন্য গণনা করা হয়)।

SendRate

{ "value": 500, "bucket": "1s", "avoid": false }

পাঠানোকে থ্রোটল করে। value হল প্রতি bucket-এ বার্তা; সাধারণ bucket হল "1s"।

Platform enum

IOS, ANDROID, OSX, WINDOWS, AMAZON, SAFARI, CHROME, FIREFOX, IE, EMAIL, BAIDU_ANDROID, HUAWEI_ANDROID, SMS, WEB, KAKAO, TELEGRAM, LINE, WHATS_APP।

MessageType enum

• MESSAGE_TYPE_UNSPECIFIED: MESSAGE_TYPE_MARKETING-এর সমতুল্য।
• MESSAGE_TYPE_MARKETING: কন্ট্রোল-গ্রুপ ফিল্টারিং এবং ফ্রিকোয়েন্সি ক্যাপিং-এর অধীন।
• MESSAGE_TYPE_TRANSACTIONAL: কন্ট্রোল-গ্রুপ ফিল্টারিং এবং ফ্রিকোয়েন্সি ক্যাপিং এড়িয়ে যায়। অর্ডার কনফার্মেশন, ওটিপি এবং অনুরূপ গুরুত্বপূর্ণ ফ্লো-এর জন্য ব্যবহার করুন।

সম্পর্কিত

বাতিল

পেলোড রেফারেন্স

ইমেল পেলোড রেফারেন্স

v1 থেকে মাইগ্রেশন