Notify

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

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

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

अनुरोध बॉडी एक NotifyRequest है जिसमें ठीक दो में से एक प्रकार होता है:

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

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, ...] }	केवल इन यूज़र IDs को भेजें।
push_tokens	{ "list": [string, ...] }	केवल इन पुश टोकन को भेजें।
payload	Payload	पुश / SMS / टेलीग्राम / काकाओ पेलोड।
email_payload	EmailPayload	ईमेल पेलोड।
return_unknown_identifiers	bool	जब true होता है, तो प्रतिक्रिया का unknown_identifiers उन पहचानकर्ताओं को सूचीबद्ध करता है जो नहीं मिले थे।
use_latest_user_device	bool	केवल तब लागू होता है जब आप users को लक्षित करते हैं। जब true होता है, तो संदेश प्रत्येक उपयोगकर्ता के सबसे हाल ही में सक्रिय डिवाइस पर वितरित किया जाता है — वह जिसमें नवीनतम लास्ट एप्लिकेशन ओपन होता है — उस यूज़र ID से जुड़े सभी उपकरणों के बजाय। डिफ़ॉल्ट रूप से false होता है (हर डिवाइस पर भेजें)।
campaign, frequency_capping, send_rate, message_type, dynamic_content_placeholders, meta_data		ऊपर NotifySegment देखें।

test_devices, hwids, users, और push_tokens परस्पर अनन्य हैं। ठीक एक सेट होना चाहिए।

उदाहरण: यूज़र IDs द्वारा ट्रांसेक्शनल

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": []
  }
}

फ़ील्ड	प्रकार	विवरण
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"
}

फ़ील्ड	प्रकार	विवरण
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.

MessageType एनम

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

संबंधित

रद्द करें

पेलोड संदर्भ

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

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