आउटसिस्टम्स

Pushwoosh प्लगइन इंस्टॉल करना

OutSystems Forge से Pushwoosh प्लगइन इंस्टॉल करके शुरू करें। ऐसा करने का सबसे तेज़ तरीका यह है कि आप अपने डेवलपमेंट एनवायरनमेंट में आउटसिस्टम्स टैब पर जाएं और इसे वहां से इंस्टॉल करें।

Pushwoosh को कॉन्फ़िगर करना

आपको उन सभी प्लेटफॉर्मों के लिए Pushwoosh को कॉन्फ़िगर करना होगा जिनका आप समर्थन करेंगे। एक बार जब आपका कॉन्फ़िगरेशन हो जाता है, तो आपके पास Pushwoosh से एक एप्लिकेशन कोड होगा जिसका उपयोग आपके प्लगइन के साथ किया जाएगा।

iOS के लिए

iOS के लिए Pushwoosh को कैसे कॉन्फ़िगर करें जानें।

Android के लिए

Android के लिए Pushwoosh को कैसे कॉन्फ़िगर करें जानें।

अपने एप्लिकेशन में Pushwoosh प्लगइन जोड़ना

अपने एप्लिकेशन में, Pushwoosh प्लगइन का संदर्भ जोड़ने के लिए “Manage Dependencies…” का उपयोग करें।

“PushwooshNotifications” ब्लॉक को इसमें जोड़ें:
- यदि आपके एप्लिकेशन में कोई लॉगिन नहीं है तो “Layout” ब्लॉक
- यदि आपके एप्लिकेशन में लॉगिन है तो “LayoutBlank” ब्लॉक
“PushwooshNotifications” ब्लॉक जोड़ते समय, इसे प्लेसहोल्डर्स के अंदर जोड़ने से बचें, क्योंकि कुछ केवल डिज़ाइन समय पर उपलब्ध होते हैं और, रनटाइम पर, Pushwoosh काम नहीं करेगा।
PushwooshNotifications में निम्नलिखित पैरामीटर सेट करें:
- PushwooshApplicationCode: Pushwoosh कोड जो आपने Pushwoosh में एप्लिकेशन बनाने के बाद प्राप्त किया था।
- FCMSenderId: पहचान संख्या जो आपने Android को कॉन्फ़िगर करते समय प्राप्त की थी। यदि आपका एप्लिकेशन केवल iOS के लिए उपलब्ध है तो आप इसे खाली छोड़ सकते हैं।
- NotificationReceivedEvent (वैकल्पिक): एक इवेंट जो तब कॉल किया जाता है जब एप्लिकेशन फोरग्राउंड स्थिति में होने पर एक सूचना प्राप्त होती है।
- NotificationOpenedEvent (वैकल्पिक): एक इवेंट जो तब कॉल किया जाता है जब कोई उपयोगकर्ता अपने डिवाइस पर किसी सूचना पर क्लिक करता है।

यदि आप अपने Android ऐप में Pushwoosh प्लगइन का उपयोग कर रहे हैं, तो निम्नलिखित करें:

Firebase से google-services.json प्राप्त करें। Google सेवाओं से पैकेज का नाम बनाए जा रहे OutSystems एप्लिकेशन के ऐप पहचानकर्ता से मेल खाना चाहिए।
रूट में google-services.json वाली एक ज़िप फ़ाइल बनाएँ।
पिछले चरण से “google-services.zip” फ़ाइल को अपने OutSystems एप्लिकेशन पर अपलोड करें और सुनिश्चित करें कि:
- “नाम” को “google-services.zip” के रूप में सेट करें
- “Deploy to Target Directory” को “google-services” के रूप में सेट करें

बिल्ड समय पर एप्लिकेशन कोड सेट करना (अनुशंसित)

Pushwoosh प्लगइन कंपोनेंट संस्करण 4.7.0 के साथ शुरू (अपडेट करने के लिए: फोर्ज से नया संस्करण इंस्टॉल करें, मैनेज डिपेंडेंसीज में डिपेंडेंसी को रिफ्रेश करें, और एक नया नेटिव बिल्ड जेनरेट करें), एप्लिकेशन कोड और डिवाइस एपीआई टोकन को सीधे नेटिव बिल्ड में लिखा जा सकता है। उन्हें अपने एप्लिकेशन की एक्सटेंसिबिलिटी कॉन्फ़िगरेशन प्रॉपर्टी में वरीयताओं के रूप में जोड़ें:

{
  "preferences": {
    "global": [
      { "name": "PW_APPID", "value": "XXXXX-XXXXX" },
      { "name": "PW_API_TOKEN", "value": "your Device API token" }
    ]
  }
}

इसके साथ, SDK किसी भी जावास्क्रिप्ट के चलने से पहले कॉन्फ़िगर हो जाता है, इसलिए जब ऐप नहीं चल रहा हो तो डिलीवर किए गए पुश सही ढंग से संभाले जाते हैं और पुश आँकड़े खो नहीं जाते हैं। वरीयता नाम केस-संवेदी होते हैं — उन्हें ठीक वैसे ही लिखें जैसा दिखाया गया है। PW_API_TOKEN वैकल्पिक है; टोकन को SetApiToken क्लाइंट एक्शन के साथ रनटाइम पर भी सेट किया जा सकता है।

PushwooshNotifications ब्लॉक के माध्यम से एप्लिकेशन कोड पास करना काम करता रहता है; जब दोनों सेट होते हैं, तो रनटाइम मान जीतता है।

डिवाइस को पंजीकृत करना

आपके डिवाइस को पुश सूचनाएं प्राप्त करने के लिए, आपको इसे पंजीकृत करना होगा। यदि आपके उपयोगकर्ताओं को एप्लिकेशन का उपयोग करने के लिए लॉगिन करने की आवश्यकता है, तो “लॉगिन” स्क्रीन पर जाएं और “लॉगिन” क्रिया को संपादित करें।

“DoLogin” क्रिया के बाद डिवाइस को पंजीकृत करने के लिए कोड जोड़ें। यह कुछ इस तरह दिखना चाहिए:

यदि आपके एप्लिकेशन में लॉगिन नहीं है, तो आप इस कोड को PushwooshNotifications ब्लॉक में OnInitializeOver इवेंट में जोड़ सकते हैं।

इस इवेंट हैंडलर में, RegisterDevice क्रिया को कॉल करें।

यदि आप एक डेवलपर प्रमाणपत्र का उपयोग करके एक iOS मोबाइल ऐप बना रहे हैं, तो आपको अपने OutSystems मॉड्यूल की एक्सटेंसिबिलिटी कॉन्फ़िगरेशन प्रॉपर्टी में एक वरीयता जोड़ने की आवश्यकता होगी:

{
  "preferences": {
    "global": [
      {
        "name": "aps-environment",
        "value": "development"
      }
    ]
  }
}

यह वरीयता आपकी एंटाइटेलमेंट फ़ाइल में जोड़ दी जाएगी (Apple डेवलपर दस्तावेज़ीकरण में एंटाइटेलमेंट के बारे में और जानें)।

यदि आप एक उत्पादन प्रमाणपत्र का उपयोग करके एक iOS मोबाइल ऐप बना रहे हैं, तो आपको कोई वरीयता निर्दिष्ट करने की आवश्यकता नहीं होगी, क्योंकि OutSystems में aps-environment वरीयता का डिफ़ॉल्ट मान production है।

आपका एप्लिकेशन अब पुश सूचनाएं प्राप्त करने के लिए तैयार है। अपने मोबाइल ऐप को कॉन्फ़िगर और जेनरेट करें और इसे अपने डिवाइस पर इंस्टॉल करें। इस बिंदु पर, आप अपने ऐप को सूचनाएं भेजने के लिए Pushwoosh इंटरफ़ेस का उपयोग कर सकते हैं और सुनिश्चित कर सकते हैं कि सब कुछ ठीक से कॉन्फ़िगर किया गया है। ध्यान दें कि यदि ऐप चल रहा है तो आपको कोई सूचना नहीं दिखाई देगी। इसके बजाय, NotificationReceivedEvent इवेंट तुरंत उठाया जाता है।

सूचनाएं भेजना

सूचनाएं भेजने के लिए, आपको एक Pushwoosh API एक्सेस टोकन की आवश्यकता है। Pushwoosh कंसोल तक पहुंच कर, “API एक्सेस” पर जाकर, और “नया एक्सेस टोकन जेनरेट करें” पर क्लिक करके एक बनाएं।

सभी डिवाइसों को एक सूचना भेजने के लिए, SendPushNotificationToAll क्रिया का उपयोग करें।

यह क्रिया निम्नलिखित पैरामीटर लेती है:

PushwooshApplicationCode: Pushwoosh कोड जो आपने Pushwoosh में एप्लिकेशन बनाने के बाद प्राप्त किया था।
ApiAccessToken: पहले प्राप्त किया गया Pushwoosh API एक्सेस टोकन।
Message: वह संदेश पाठ जो आप भेजना चाहते हैं।
Badge: एक संख्या जो iOS एप्लिकेशन आइकन पर प्रदर्शित होती है।
Deeplink: सूचना के साथ भेजने के लिए एक डीप लिंक। डीप लिंक कैसे परिभाषित करें जानें।
InboxDays (वैकल्पिक, 4.7.0 से): संदेश उपयोगकर्ता के इनबॉक्स में कितने दिनों तक रखा जाता है, 30 तक। इसके बिना (और InboxDate के बिना) पुश इनबॉक्स में सहेजा नहीं जाता है।
InboxDate (वैकल्पिक, 4.7.0 से): वह तारीख जब तक संदेश उपयोगकर्ता के इनबॉक्स में रखा जाता है। InboxDays का एक विकल्प।
InboxImage (वैकल्पिक, 4.7.0 से): इनबॉक्स में संदेश के बगल में दिखाई गई एक कस्टम छवि का URL।

दो सिबलिंग सर्वर एक्शन समान पैरामीटर लेते हैं: SendPushNotificationToToken एक डिवाइस को उसके पुश टोकन द्वारा पहचाने गए एकल डिवाइस को भेजता है, और SendPushNotificationToUserId एक दिए गए यूजर आईडी के तहत पंजीकृत सभी डिवाइसों को भेजता है (SetUserId क्लाइंट एक्शन के साथ सेट)।

उदाहरण के लिए, यदि आप इस क्रिया का उपयोग “PushTest” नामक एप्लिकेशन को “Hello from OutSystems” संदेश भेजने के लिए करते हैं, तो iOS में निम्नलिखित दिखाया जाएगा:

अतिरिक्त जानकारी

यदि आपका ऐप चल रहा है, तो सूचना डिवाइस पर नहीं दिखती है। इसके बजाय, यह ऐप को भेजी जाती है, और NotificationReceivedEvent इवेंट उठाया जाता है। आपको यह परिभाषित करना होगा कि आप उस स्थिति में ऐप से क्या करवाना चाहते हैं।
पुश सूचनाओं को सक्रिय होने में थोड़ा समय लग सकता है। यदि आपको सूचनाएं नहीं मिल रही हैं, तो आगे की समस्या निवारण से पहले कुछ मिनट प्रतीक्षा करें।

अपनी प्रतिक्रिया हमारे साथ साझा करें

आपकी प्रतिक्रिया हमें एक बेहतर अनुभव बनाने में मदद करती है, इसलिए यदि आपको SDK एकीकरण प्रक्रिया के दौरान कोई समस्या आती है तो हम आपसे सुनना पसंद करेंगे। यदि आपको कोई कठिनाई आती है, तो कृपया इस फ़ॉर्म के माध्यम से अपने विचार हमारे साथ साझा करने में संकोच न करें।