Notify

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

एक एकल संदेश बनाता है और शेड्यूल करता है।

अनुरोध संरचना

अनुरोध का मुख्य भाग एक NotifyRequest है जिसमें ठीक दो में से एक प्रकार होता है:

• segment: सेगमेंट कोड, एक seglang एक्सप्रेशन, या एक संरचित फ़िल्टर एक्सप्रेशन द्वारा एक ऑडियंस सेगमेंट को लक्षित करें।
• transactional: hwids, यूजर आईडी, पुश टोकन, या परीक्षण उपकरणों की एक स्पष्ट सूची में भेजें।

Shape

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

NotifySegment

उन उपयोगकर्ताओं को लक्षित करता है जो एक ऑडियंस सेगमेंट या फ़िल्टर एक्सप्रेशन से मेल खाते हैं।

फ़ील्ड	प्रकार	विवरण
schedule	Schedule	कब और कैसे भेजना है। आवश्यक।
application	string	एप्लिकेशन कोड।
platforms	array of Platform	प्लेटफ़ॉर्म जिन्हें संदेश लक्षित करता है।
code	string	सेगमेंट कोड। expression और filter_expression के साथ परस्पर अनन्य।
expression	string	Seglang एक्सप्रेशन।
filter_expression	FilterExpression	संरचित फ़िल्टर एक्सप्रेशन (उन्नत)।
payload	Payload	पुश / SMS / टेलीग्राम / काकाओ पेलोड। 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

प्राप्तकर्ताओं की एक स्पष्ट सूची में भेजता है।

फ़ील्ड	प्रकार	विवरण
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	पुश / SMS / टेलीग्राम / काकाओ पेलोड।
email_payload	EmailPayload	ईमेल पेलोड।
return_unknown_identifiers	bool	जब true होता है, तो प्रतिक्रिया का unknown_identifiers उन पहचानकर्ताओं को सूचीबद्ध करता है जो नहीं मिले थे।
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
    }
  }'

प्रतिक्रिया

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

फ़ील्ड	प्रकार	विवरण
message_code	string	अद्वितीय संदेश कोड। इसे /getMessageDetails और संदेश सांख्यिकी एंडपॉइंट के साथ उपयोग करें।
unknown_identifiers	array of string	खाते पर पहचानकर्ता नहीं मिले। केवल तब पॉप्युलेट होता है जब transactional प्रकार पर return_unknown_identifiers: true सेट किया गया था।

साझा प्रकार

शेड्यूल

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

फ़ील्ड	प्रकार	विवरण
at	timestamp	पूर्ण भेजने का समय (RFC 3339)। यदि अतीत में है, तो संदेश तुरंत भेजा जाता है। भविष्य में अधिकतम 14 दिन।
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" है।

प्लेटफ़ॉर्म एनम

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

संदेश प्रकार एनम

• MESSAGE_TYPE_UNSPECIFIED: MESSAGE_TYPE_MARKETING के बराबर।
• MESSAGE_TYPE_MARKETING: नियंत्रण-समूह फ़िल्टरिंग और आवृत्ति कैपिंग के अधीन।
• MESSAGE_TYPE_TRANSACTIONAL: नियंत्रण-समूह फ़िल्टरिंग और आवृत्ति कैपिंग को छोड़ देता है। ऑर्डर पुष्टिकरण, OTP, और इसी तरह के महत्वपूर्ण प्रवाह के लिए उपयोग करें।

संबंधित

पेलोड संदर्भ

ईमेल पेलोड संदर्भ

v1 से माइग्रेशन