Notify

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

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

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

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

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

आकार

{
  "segment": { ... },      // OR
  "transactional": { ... },
  "transaction_id": "unique-uuid"
}

फील्ड	प्रकार	विवरण
transaction_id	string	वैकल्पिक। अनुरोध के लिए Idempotency कुंजी — segment और transactional दोनों के साथ काम करती है। 5 मिनट के भीतर समान transaction_id के साथ एक दोहराया गया कॉल डुप्लिकेट संदेश भेजने के बजाय मूल message_code लौटाता है। प्रति तार्किक भेजने के लिए एक UUID या किसी अन्य अद्वितीय मान का उपयोग करें।

टिप

बनाए गए संदेश को एंड-टू-एंड ट्रेसिंग के लिए अपने अनुरोध के साथ सहसंबंधित करने के लिए एक X-Request-ID हेडर पास करें — Request ID देखें।

केवल कुंजी की जाँच की जाती है, पेलोड की नहीं

डिडुप्लीकेशन केवल transaction_id पर मेल खाता है। यदि कोई पुन: प्रयास समान transaction_id का पुन: उपयोग करता है, लेकिन एक अलग segment / transactional बॉडी भेजता है, तो मूल message_code अभी भी लौटाया जाता है और नई बॉडी चुपचाप छोड़ दी जाती है — इसकी पहले अनुरोध से तुलना नहीं की जाती है। तार्किक रूप से भिन्न संदेशों में कभी भी transaction_id का पुन: उपयोग न करें।

टिप

यह लीगेसी Messages API पर transactionId के समान डिडुप्लीकेशन तंत्र है, जो समान 5-मिनट की स्टोरेज विंडो साझा करता है, इसलिए एक पुन: प्रयास किए गए अनुरोध को /createMessage और Notify दोनों में डिडुप्लीकेट किया जाता है। यह PW_Conversion राजस्व घटनाओं पर transaction_id विशेषता से असंबंधित है, जिसे Pushwoosh वैसे ही संग्रहीत करता है और डिडुप्लीकेशन के लिए उपयोग नहीं करता है।

NotifySegment

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

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

उदाहरण: एक सेगमेंट को भेजें

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 / Telegram / Kakao / LINE / WhatsApp / Viber पेलोड।
email_payload	EmailPayload	ईमेल पेलोड।
return_unknown_identifiers	bool	जब true होता है, तो प्रतिक्रिया का unknown_identifiers उन पहचानकर्ताओं को सूचीबद्ध करता है जो नहीं मिले थे।
use_latest_user_device	bool	केवल तब लागू होता है जब आप users को लक्षित करते हैं। ऊपर NotifySegment के समान व्यवहार — प्रति डिवाइस एक के बजाय प्रति उपयोगकर्ता एक संदेश डिलीवर करता है, जो platforms तक सीमित है। डिफ़ॉल्ट रूप से 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": []
  }
}

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

फ्रीक्वेंसी कैपिंग

मार्केटिंग भेजने के लिए प्रति-उपयोगकर्ता आवृत्ति सीमाएँ। कैपिंग को अक्षम करने के लिए, frequency_capping को पूरी तरह से छोड़ दें, या days: 0 को count: 0 के साथ भेजें।

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

• days (int, 1–30, या 0 कैपिंग को अक्षम करने के लिए): लुक-बैक विंडो। count के साथ भेजा जाना चाहिए — यदि एक 0 है, तो दूसरा भी 0 होना चाहिए; एक को 0 के रूप में भेजना जबकि दूसरा गैर-शून्य है, 400 लौटाता है।
• count (int, 1 या अधिक, या 0 कैपिंग को अक्षम करने के लिए): days के भीतर अनुमत अधिकतम संदेश। ऊपर days के समान युग्मन नियम।
• exclude (bool): उन उपयोगकर्ताओं को हार्ड-एक्सक्लूड करें जो पहले ही कैप तक पहुंच चुके हैं।
• avoid (bool): उन उपयोगकर्ताओं से सॉफ्ट-अवॉइड करें जो पहले ही कैप तक पहुंच चुके हैं (वे अभी भी एनालिटिक्स में गिने जाते हैं)।

महत्वपूर्ण

असंगत शून्यता के साथ days और count भेजना (जैसे {"days": 0, "count": 5}) 400 लौटाता है। यह सत्यापन Notify में एक ब्रेकिंग चेंज है — वे क्लाइंट जो पहले एक अकेले 0 को चुपचाप अनदेखा किए जाने पर निर्भर थे, अब इसके बजाय एक त्रुटि प्राप्त करेंगे।

भेजने की दर

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

भेजने को थ्रॉटल करता है। value प्रति bucket संदेश है; सामान्य bucket "1s" है।

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

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

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

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

संबंधित

Notify बैच

रद्द करें

पेलोड संदर्भ

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

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