वेबहूक

वेबहूक आपको जर्नी डेटा को बाहरी सेवाओं जैसे एनालिटिक्स, CRM सिस्टम और मार्केटिंग टूल में भेजने की सुविधा देते हैं। आप यह कर सकते हैं:

जब कोई ग्राहक जर्नी में कोई कार्रवाई करता है तो बाहरी सिस्टम को सूचित करें
एनालिटिक्स टूल में ग्राहक डेटा भेजें
विशिष्ट जर्नी इवेंट्स पर तृतीय-पक्ष ईमेल, SMS, या WhatsApp को ट्रिगर करें

वेबहूक एलिमेंट को कैसे सेटअप करें

वेबहूक एलिमेंट जोड़ें

वेबहूक (Webhook) एलिमेंट को कैनवास पर ड्रैग-एंड-ड्रॉप करें। वेबहूक (Webhook) को कहीं भी रखें जहाँ आप चाहें, यह ध्यान में रखते हुए कि आप कौन सी जर्नी जानकारी किसी तृतीय-पक्ष सेवा को भेजने जा रहे हैं।

कस्टमर जर्नी कैनवास जिसमें एंट्री और वेट एलिमेंट्स के बाद एक चयनित एम्प्लिट्यूड वेबहूक स्टेप है

वेबहूक स्टेप को नाम दें और अनुरोध URL और प्रकार निर्दिष्ट करें

स्टेप का नाम (STEP NAME) फ़ील्ड में, वेबहूक के लिए एक नाम दर्ज करें। वेबहूक को उन सेवाओं के अनुसार नाम देना आसान हो सकता है जिन्हें वे डेटा भेजते हैं या उपयोग के मामले के अनुसार।

इसके बाद, URL फ़ील्ड में, उस अनुरोध URL को निर्दिष्ट करें जिस पर डेटा भेजा जाना चाहिए। URL फ़ील्ड के आगे, अनुरोध प्रकार (REQUEST TYPE) ड्रॉपडाउन से अनुरोध प्रकार चुनें: GET या POST।

वेबहूक कॉन्फ़िगरेशन इंटरफ़ेस जो GET या POST विधि का चयन करने के लिए URL फ़ील्ड और REQUEST TYPE ड्रॉपडाउन दिखा रहा है

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

हेडर कॉन्फ़िगर करें

हेडर्स (HEADERS) सेक्शन में, सामग्री प्रकार सेट करें।

डिफ़ॉल्ट रूप से, सामग्री प्रकार application/json है। यदि वह सेवा जिसे आप वेबहूक भेज रहे हैं, किसी अन्य सामग्री प्रकार की आवश्यकता है, तो Content-Type हेडर मान में उपयुक्त एक दर्ज करें।

सामग्री प्रकार के उदाहरण हैं:

x-www-form-urlencoded
text/plain
text/xml

यदि आवश्यक हो तो + हेडर जोड़ें (+ ADD HEADER) पर क्लिक करके अतिरिक्त हेडर जोड़ें। आप किसी भी हेडर को उसके बगल में ‘x’ आइकन पर क्लिक करके हटा सकते हैं।

आपके एंडपॉइंट को जो भी प्रमाणीकरण हेडर की आवश्यकता हो, उसे जोड़ें, उदाहरण के लिए:

Authorization: Bearer <token>
X-Api-Key: <key>
Authorization: Basic <base64(user:pass)>

केवल एक हेडर में एक स्थिर सीक्रेट समर्थित है। Pushwoosh की ओर से OAuth2 टोकन-एक्सचेंज प्रवाह, mTLS, और अनुरोध हस्ताक्षर समर्थित नहीं हैं। आप हेडर सीक्रेट के बजाय, या उसके अतिरिक्त, एंडपॉइंट को Pushwoosh के IP पतों तक भी सीमित कर सकते हैं। Pushwoosh IP पते देखें।

विशेष रूप से HTTP बेसिक प्रमाणीकरण के लिए, निम्नलिखित करें:

एक सादा टेक्स्ट एडिटर खोलें और अपना उपयोगकर्ता नाम और पासवर्ड बिना किसी स्पेस के, एक कोलन द्वारा अलग करके टाइप करें। उदाहरण के लिए: <username>:<password>
इस स्ट्रिंग को Base64 में एन्कोड करें।
परिणामी Base64 स्ट्रिंग को कॉपी करें (उदाहरण के लिए, <base64-encoded-string>)।
वेबहूक सेटिंग्स में, मान के साथ एक Authorization हेडर जोड़ें: Basic <base64-encoded-string>। सुनिश्चित करें कि “Basic” शब्द के बाद एक स्पेस है।

वेबहूक सेटिंग्स में बेसिक प्रमाणीकरण के लिए प्राधिकरण हेडर का उदाहरण जो Content-Type और Authorization हेडर दिखा रहा है

हेडर मान को सीक्रेट के रूप में चिह्नित करें

किसी हेडर के मान को मास्क करने के लिए उसके बगल में स्थित आई आइकन पर क्लिक करें। Pushwoosh उस मान को हर जगह छिपा देता है जहाँ वह अन्यथा सेवा छोड़ देता: UI में, API प्रतिक्रियाओं में, और जर्नी के संस्करण इतिहास में।

एक मास्क्ड Authorization मान और एक अनमास्क्ड Content-Type मान के बगल में एक सक्रिय आई आइकन के साथ एक अक्षम आई आइकन वाली वेबहूक हेडर्स सूची

स्वचालित मास्किंग। जिन हेडर्स के नाम क्रेडेंशियल्स की तरह दिखते हैं, वे स्वचालित रूप से मास्क हो जाते हैं, भले ही आप कभी भी आई आइकन पर क्लिक न करें। इसमें Authorization, Proxy-Authorization, Cookie, Set-Cookie, और कोई भी नाम जिसमें token, secret, password, credential, auth, या api-key/api_key/apikey (एक हाइफ़न, एक अंडरस्कोर, या कोई विभाजक नहीं के साथ) शामिल है।
मास्क्ड मान बदलें। •••••••• दिखाने वाले फ़ील्ड में क्लिक करें और नया मान टाइप करें। संग्रहीत मान को प्रकट करने के लिए कोई बटन नहीं है। जब मास्क दिखाया जाता है तो आई आइकन लॉक रहता है। किसी हेडर से सीक्रेट फ़्लैग हटाने के लिए, पहले एक नया मान टाइप करें, फिर आइकन पर क्लिक करें।
मास्क्ड हेडर का नाम बदलें। किसी ऐसे हेडर का नाम बदलना जिसका मान वर्तमान में मास्क के रूप में दिखाया गया है, उस मान को साफ़ कर देता है। इसे नए नाम के तहत फिर से दर्ज करें। किसी ऐसे हेडर का नाम बदलना जिसमें वर्तमान में आपके द्वारा अभी टाइप किया गया मान है, उस मान को बनाए रखता है।

JSON अनुरोध बॉडी जोड़ें

डेटा (DATA) सेक्शन में, अपनी JSON अनुरोध बॉडी दर्ज करें। सुनिश्चित करें कि अनुरोध बॉडी सही JSON प्रारूप में है।

उदाहरण:

{
  "hwid": "{{device:hwid}}"
}

डायनामिक डेटा और मैक्रोज़ का उपयोग करें

डेटा बिल्डर (DATA BUILDER) पैनल आपको डायनामिक जानकारी (जैसे उपयोगकर्ता, डिवाइस, टैग, या ईवेंट डेटा) को सीधे अपनी JSON अनुरोध बॉडी में डालने की अनुमति देता है। डायनामिक डेटा के साथ, आप जर्नी के माध्यम से प्रगति करने वाले व्यक्तिगत उपयोगकर्ता के लिए विशिष्ट मान शामिल कर सकते हैं।

इसके लिए:

एक श्रेणी (category) चुनें। आप तीन श्रेणियों से डेटा खींच सकते हैं:

डिवाइस (Device): डिवाइस डेटा का उपयोग तब करें जब आपको उपयोगकर्ता के डिवाइस से जुड़ी तकनीकी जानकारी की आवश्यकता हो।
टैग (Tag): टैग डेटा का उपयोग तब करें जब आप उपयोगकर्ता प्रोफ़ाइल में संग्रहीत जानकारी भेजना चाहते हैं।
ईवेंट (Event): ईवेंट डेटा का उपयोग तब करें जब वेबहूक को जर्नी के ट्रिगरिंग ईवेंट से मान भेजना चाहिए।

ट्रिगरिंग ईवेंट से मान यात्री के साथ जर्नी के बाकी हिस्सों के लिए जुड़े रहते हैं, जिसमें टाइम डिले (Time Delay) भी शामिल है। वे केवल तभी खो जाते हैं जब यात्री जर्नी छोड़ देता है, उदाहरण के लिए एक रद्द ईवेंट पर, एक निकास पर, या जब जर्नी समाप्त होती है। यदि कोई यात्री एक ही वेबहूक (Webhook) स्टेप से एक से अधिक बार गुजरता है, तो नई प्रतिक्रिया पिछली बार मैप किए गए मान को ओवरराइट कर देती है।

एक पैरामीटर (parameter) चुनें (उदाहरण के लिए, HWID, पसंदीदा श्रेणी, आदि)।
Pushwoosh एक मैक्रो उत्पन्न करता है जो इस तरह दिखता है:

{{tag:Language}}

मैक्रो को कॉपी करें और इसे डेटा सेक्शन में अपनी JSON बॉडी में पेस्ट करें।

जब वेबहूक एक लाइव जर्नी में चलता है, तो Pushwoosh स्वचालित रूप से मैक्रो को उस उपयोगकर्ता के लिए वास्तविक मान से बदल देता है।

वेबहूक अनुरोध बॉडी में डायनामिक डेटा प्लेसहोल्डर डालें

अतिरिक्त प्लेसहोल्डर मैन्युअल रूप से टाइप करें

एक प्लेसहोल्डर एक मैक्रो है जिसे आप डेटा बिल्डर श्रेणी से उत्पन्न करने के बजाय हाथ से टाइप करते हैं। डेटा बिल्डर (DATA BUILDER) पैनल केवल डिवाइस (Device), टैग (Tag), और ईवेंट (Event) डेटा को कवर करता है। इन प्लेसहोल्डर्स को सीधे URL, हेडर्स (HEADERS), या डेटा (DATA) सेक्शन में टाइप करें। वे पैनल में दिखाई नहीं देते हैं:

प्लेसहोल्डर	मान
`{{application_code}}`	उस ऐप का एप्लिकेशन कोड जिससे यात्री संबंधित है।
`{{traveler:id}}`	वह आईडी जो Pushwoosh इस यात्री को इस जर्नी रन के लिए असाइन करता है।
`{{journey:uuid}}`	इस जर्नी का UUID।
`{{journey:name}}`	इस जर्नी का नाम।
`{{point:uuid}}`	इस वेबहूक (Webhook) स्टेप का UUID।
`{{point:name}}`	इस वेबहूक (Webhook) स्टेप का स्टेप का नाम (STEP NAME)।
`{{event:name}}`	उस ईवेंट का नाम जिसने इस यात्री के जर्नी में प्रवेश को ट्रिगर किया।
`{{device:platform}}`	डिवाइस का प्लेटफ़ॉर्म, उदाहरण के लिए `Android` या `iOS`।
`{{device:push_subscribed}}`	क्या यात्री पुश नोटिफिकेशन के लिए सब्सक्राइब है — `true` या `false`।
`{{now}}`	वर्तमान दिनांक और समय, ISO 8601, UTC।
`{{now:unix_ms}}`	वर्तमान समय यूनिक्स मिलीसेकंड के रूप में।
`{{tags:all}}`	यात्री के डिवाइस के लिए प्रत्येक टैग मान, एक JSON ऑब्जेक्ट के रूप में। इसे बिना उद्धरण के उपयोग करें, उदाहरण के लिए `"user_properties": {{tags:all}}`। इसे उद्धृत करने से ऑब्जेक्ट एक एस्केप्ड स्ट्रिंग में बदल जाता है।

JSON बॉडी में प्लेसहोल्डर का प्रकार बनाए रखें

उद्धरण चिह्नों के अंदर एक प्लेसहोल्डर हमेशा एक JSON स्ट्रिंग बन जाता है, चाहे मान का प्रकार कुछ भी हो। वही प्लेसहोल्डर अपने आप में, बिना किसी उद्धरण के, मान के अपने प्रकार को बनाए रखता है: एक संख्या एक संख्या बनी रहती है, true/false एक बूलियन बना रहता है, और एक सूची एक JSON ऐरे बन जाती है। एक बिना उद्धरण वाले प्लेसहोल्डर को फ़ील्ड का पूरा मान होना चाहिए — "age": {{tag:Age}} काम करता है, लेकिन "note": prefix{{tag:Age}}suffix नहीं, क्योंकि उद्धरण के बाहर सब कुछ ठीक वैसे ही लिखा जाता है जैसे टाइप किया गया है और अतिरिक्त वर्ण JSON को तोड़ देते हैं।

{
  "age": {{tag:Age}},
  "age_as_text": "{{tag:Age}}"
}

यहाँ age टैग का संख्यात्मक मान (34) भेजता है, जबकि age_as_text स्ट्रिंग "34" भेजता है। प्राप्त करने वाले छोर पर फ़ील्ड जो भी अपेक्षा करता है उसका उपयोग करें। यदि टैग का कोई मान नहीं है, तो एक बिना उद्धरण वाला प्लेसहोल्डर अभी भी एक खाली स्ट्रिंग में हल होता है, न कि एक संख्या या false में। JSON अनुरोध बॉडी जोड़ें के तहत नोट देखें।

एक दिनांक प्लेसहोल्डर अलग-अलग तरीके से प्रस्तुत होता है, यह इस बात पर निर्भर करता है कि आप इसे कहाँ रखते हैं। उद्धृत, यह YYYY-MM-DD HH:MM:SS लेआउट को बनाए रखता है जिसे मौजूदा इंटीग्रेशन पहले से ही पार्स करते हैं। बिना उद्धरण के, यह इसके बजाय ISO 8601 है, उदाहरण के लिए 2026-09-15T08:24:00Z। दोनों विनिमेय नहीं हैं। वह स्थिति चुनें जो आपके एंडपॉइंट के अपेक्षित प्रारूप से मेल खाती है।

वेबहूक प्रतिक्रिया डेटा को वेरिएबल्स में मैप करें

डेटा भेजने के अलावा, वेबहूक (Webhook) स्टेप आपकी सेवा द्वारा वापस भेजे गए उत्तर से मान रख सकता है। आप प्रत्येक मान को एक नाम (एट्रिब्यूट (Attribute)) देते हैं। बाद के स्टेप उस नाम का उपयोग उसी तरह कर सकते हैं जैसे वे अन्य वेबहूक प्रतिक्रिया मानों का उपयोग करते हैं। उदाहरण के लिए, उपयोगकर्ता प्रोफ़ाइल अपडेट करें (Update user profile) के साथ एक टैग सेट करें, या सेवा द्वारा लौटाई गई तारीख से टाइम डिले (Time Delay) शेड्यूल करें। एक पूर्ण जर्नी उदाहरण के लिए, अपनी जर्नी में वेबहूक प्रतिक्रिया डेटा का उपयोग करना देखें।

उदाहरण: CRM एक उपयोगकर्ता आईडी लौटाता है। आप इसे एट्रिब्यूट (Attribute) crm_user_id के रूप में संग्रहीत करते हैं। फिर उपयोगकर्ता प्रोफ़ाइल अपडेट करें (Update user profile) इसे एक टैग में लिखता है।

कुछ भी मैप करने से पहले, सेवा से एक नमूना प्रतिक्रिया प्राप्त करें। अपने डेवलपर से पूछें, या एक परीक्षण के बाद कॉल्स लॉग (Calls log) में एक सफल कॉल खोलें और प्रतिक्रिया बॉडी को देखें। आपको पाथ (Path) बनाने के लिए उस उत्तर से फ़ील्ड नामों की आवश्यकता है।

प्रतिक्रिया मैपिंग (RESPONSE MAPPING) सेक्शन में, + मैपिंग जोड़ें (+ ADD MAPPING) पर क्लिक करें और प्रत्येक मान के लिए दो फ़ील्ड भरें जिसे आप कैप्चर करना चाहते हैं:

पाथ (Path): प्रतिक्रिया JSON बॉडी के अंदर मान का स्थान, स्तरों के बीच डॉट्स के साथ
एट्रिब्यूट (Attribute): वह नाम जिसे आप बाद में जर्नी में उपयोग करेंगे

वेबहूक सेटिंग्स में पाथ और एट्रिब्यूट फ़ील्ड और ऐड मैपिंग बटन के साथ रिस्पांस मैपिंग सेक्शन

उदाहरण के लिए, यदि आपका CRM इसके साथ प्रतिक्रिया करता है:

{
  "data": {
    "user": {
      "id": "789xyz"
    }
  }
}

पाथ (Path) को data.user.id पर सेट करें।
एट्रिब्यूट (Attribute) को crm_user_id पर सेट करें।

एक उपयोगकर्ता द्वारा इस स्टेप को पास करने के बाद, बाद के एलिमेंट एट्रिब्यूट (Attribute) crm_user_id को उसी तरह चुन सकते हैं जैसे वे अन्य वेबहूक प्रतिक्रिया मानों को चुनते हैं।

कंडीशन स्प्लिट (Condition split) उनका सीधे उपयोग नहीं कर सकता है। मैप किए गए वेबहूक मानों का कोई प्रकार नहीं होता है। पहले मान को एक टैग के रूप में सहेजें, फिर उस टैग पर शाखा करें। कंडीशन स्प्लिट में एक वेबहूक मान की तुलना करें देखें।

एकल फ़ील्ड के लिए, पाथ (Path) और मान इस तरह काम करते हैं:

ऑब्जेक्ट नामों को डॉट्स के साथ लिखें: data.user.id।
एक सूची के लिए, एक आइटम लेने के लिए एक स्थिति संख्या का उपयोग करें। पहला आइटम 0 है, इसलिए results.0.code पहले आइटम का code फ़ील्ड है। एक सूची में प्रत्येक आइटम को मैप करने के लिए, एक ऐरे के प्रत्येक एलिमेंट को मैप करें देखें।
आप एक सूची में केवल कुछ आइटम मैप नहीं कर सकते हैं। एक सूची के लिए यह या तो एक स्थिति है या प्रत्येक आइटम है।
Pushwoosh मान को वैसे ही रखता है जैसे सेवा ने इसे भेजा था (टेक्स्ट, संख्या, या सही/गलत)। एक संख्या 100 एक संख्या बनी रहती है। टेक्स्ट "100" टेक्स्ट बना रहता है और जहाँ जर्नी एक संख्या की अपेक्षा करती है वहाँ काम नहीं करेगा। टाइम डिले (Time Delay) दिनांक के लिए, सेवा को एक प्रारूप लौटाना होगा जिसे टाइम डिले (Time Delay) स्वीकार करता है। 19.99 जैसा दशमलव मूल्य (Price) प्रकार के टैग में जा सकता है।
यदि उत्तर मान्य JSON नहीं है, या पाथ (Path) किसी भी फ़ील्ड से मेल नहीं खाता है, तो वह एट्रिब्यूट इस उपयोगकर्ता के लिए नहीं बनाया गया है। वेबहूक (Webhook) स्टेप अभी भी सामान्य रूप से समाप्त होता है। कोई त्रुटि बैनर नहीं है। कॉल्स लॉग (Calls log) में प्रतिक्रिया बॉडी की जाँच करें और यदि मान डाउनस्ट्रीम में गायब है तो पाथ (Path) को ठीक करें।

एक ऐरे के प्रत्येक एलिमेंट को मैप करें

कभी-कभी एक वेबहूक प्रतिक्रिया में केवल एक मान नहीं होता है। इसमें एक सूची होती है, जैसे एक ऑर्डर में प्रत्येक उत्पाद, एक कार्ट में प्रत्येक आइटम, या एक खोज से प्रत्येक परिणाम। प्रतिक्रिया मैपिंग सामान्य रूप से प्रति फ़ील्ड एक मान कैप्चर करती है, इसलिए इसके बिना आपको उस सूची से केवल एक मैप किया गया मान मिलेगा, और बाकी खो जाएगा।

पाथ (Path) फ़ील्ड में * डालें जहाँ सूची है। Pushwoosh तब सूची में प्रत्येक आइटम से एक मान पकड़ता है, न कि केवल एक स्थिति से। उदाहरण के लिए, यदि सूची को items कहा जाता है और प्रत्येक आइटम में item_name है, तो पाथ (Path) को items.*.item_name पर सेट करें।

प्रतिक्रिया मैपिंग (RESPONSE MAPPING) में, + मैपिंग जोड़ें (+ ADD MAPPING) पर क्लिक करें और दो फ़ील्ड को सामान्य रूप से भरें, जिसमें * सूची को चिह्नित करता है:

पाथ (Path): प्रतिक्रिया के अंदर मान का स्थान, जहाँ सूची है वहाँ * के साथ। उदाहरण: items.*.item_name।
एट्रिब्यूट (Attribute): वह नाम जिसे आप बाद में उपयोग करेंगे। आप यहाँ जो लिखते हैं वह तय करता है कि आपको परिणाम कैसे वापस मिलते हैं:
- नाम में {n} शामिल करें, उदाहरण के लिए item_{n}, प्रत्येक आइटम को अपने स्वयं के मान के रूप में प्राप्त करने के लिए, 1 से क्रमांकित: item_1, item_2, item_3, और इसी तरह। {n} नाम में कहीं भी बैठ सकता है, उदाहरण के लिए item_{n}_sku।
- {n} को छोड़ दें, उदाहरण के लिए item_names, प्रत्येक आइटम को एक मान में जोड़ने के लिए, अल्पविराम द्वारा अलग किया गया: Sofa, Lamp, Rug।

$रिस्पांस मैपिंग पंक्ति जिसमें पाथ items.*.item_name पर और एट्रिब्यूट item_{n} पर सेट है$

पाथ सूची की स्थिति 0 से शुरू होती है (items.0.item_name पहला आइटम है)। {n} के साथ बनाए गए एट्रिब्यूट नाम 1 से शुरू होते हैं (item_1 वह पहला आइटम है)। ये दो अलग-अलग क्रमांकन हैं।

यदि आपको सूची से केवल एक आइटम की आवश्यकता है, तो पाथ (Path) में * के बजाय एक संख्या का उपयोग करें, उदाहरण के लिए items.0.item_name।

उदाहरण

यदि आपका CRM इसके साथ प्रतिक्रिया करता है:

{
  "items": [
    { "item_name": "Sofa" },
    { "item_name": "Lamp" },
    { "item_name": "Rug" }
  ]
}

तीन अलग-अलग मान प्राप्त करने के लिए पाथ (Path) को items.*.item_name और एट्रिब्यूट (Attribute) को item_{n} पर सेट करें: item_1 सोफा है, item_2 लैंप है, item_3 रग है।
एक मान प्राप्त करने के लिए इसके बजाय एट्रिब्यूट (Attribute) को item_names पर सेट करें: item_names Sofa, Lamp, Rug है।

यदि सूची में एक आइटम में वह फ़ील्ड नहीं है जिसे आप ढूंढ रहे हैं (उदाहरण के लिए, कोई item_name नहीं), तो उस आइटम को छोड़ दिया जाता है। क्रमांकन उसके लिए एक अंतर नहीं छोड़ता है। उदाहरण: तीन पंक्तियाँ जहाँ बीच वाली में कोई item_name नहीं है, केवल item_1 और item_2 बन जाती हैं।

एक सूची में केवल पहले 50 आइटम कैप्चर किए जाते हैं। उसके बाद कुछ भी छोड़ दिया जाता है। यात्री अभी भी जर्नी में जारी रहता है। केवल अनमैप्ड मान गायब हैं।

आप मैप किए गए मानों को बाद में जर्नी में किसी अन्य वेबहूक प्रतिक्रिया एट्रिब्यूट की तरह उपयोग कर सकते हैं:

उपयोगकर्ता प्रोफ़ाइल अपडेट करें (Update user profile): एक मान को एक टैग में सहेजें
टाइम डिले (Time Delay): प्रतिक्रिया से एक तारीख तक प्रतीक्षा करें
डायनामिक कंटेंट (Dynamic Content): संदेश सामग्री को वैयक्तिकृत करें

अपनी जर्नी में वेबहूक प्रतिक्रिया डेटा का उपयोग करना

टाइमआउट, पुनः प्रयास, और विफल अनुरोध

Pushwoosh एक प्रतिक्रिया के लिए 10 सेकंड तक प्रतीक्षा करता है। अनुरोध भेजने और प्रतिक्रिया को संसाधित करने सहित पूरा वेबहूक (Webhook) स्टेप 30 सेकंड पर सीमित है।

पुनः प्रयास

500, 502, 503, या 504 प्रतिक्रिया पर, या कनेक्शन विफलता जैसे नेटवर्क त्रुटि पर, Pushwoosh हार मानने से पहले एक बार अनुरोध को पुनः प्रयास करता है। एक अनुरोध जो टाइम आउट हो जाता है, उसे पुनः प्रयास नहीं किया जाता है — नीचे जब कोई अनुरोध विफल होता है तो क्या होता है देखें। किसी भी अन्य गैर-2xx प्रतिक्रिया को भी पुनः प्रयास नहीं किया जाता है।

दर सीमाएँ

Pushwoosh यह सीमित करता है कि एक खाता प्रति सेकंड कितने वेबहूक अनुरोध भेज सकता है। सीमा वास्तविक ट्रैफ़िक चोटियों से काफी ऊपर आकार की है, इसलिए सामान्य जर्नी प्रभावित नहीं होती हैं। इसे पार करने वाला एक बर्स्ट विफल होने से पहले कमरे के लिए संक्षिप्त रूप से प्रतीक्षा करता है।

एंडपॉइंट कूलडाउन

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

जब कोई अनुरोध विफल होता है तो क्या होता है

वेबहूक (Webhook) एलिमेंट में विफल अनुरोधों के लिए कोई अलग शाखा नहीं है। निम्नलिखित में से कोई भी यात्री को इस स्टेप पर जर्नी से हटा देता है:

कारण	यह क्या ट्रिगर करता है
अवरुद्ध एंडपॉइंट पता	URL निजी, आंतरिक, लूपबैक, या लिंक-लोकल है, जिसमें क्लाउड मेटाडेटा एंडपॉइंट्स भी शामिल हैं
दर सीमा	खाते की प्रति-सेकंड वेबहूक अनुरोध सीमा पार हो गई है और संक्षिप्त प्रतीक्षा के दौरान कोई जगह नहीं खुलती है
एंडपॉइंट कूलडाउन	एंडपॉइंट लगातार कई बार विफल रहा और Pushwoosh अस्थायी रूप से इसे छोड़ रहा है
टाइमआउट	10 सेकंड के भीतर कोई प्रतिक्रिया नहीं, या स्टेप अपनी 30-सेकंड की सीमा से अधिक हो जाता है
नेटवर्क त्रुटि	अनुरोध एंडपॉइंट तक बिल्कुल नहीं पहुंच सका
गैर-2xx प्रतिक्रिया	एंडपॉइंट ने एक त्रुटि स्थिति लौटाई जिसे पुनः प्रयास नहीं किया जाता है, या एक बार पुनः प्रयास किया गया और फिर से विफल हो गया

अनुरोध त्रुटि देखें।

यदि आप यहाँ यात्रियों को खोने का जोखिम नहीं उठा सकते हैं, तो अपने एंडपॉइंट को हमेशा एक 2xx प्रतिक्रिया लौटाने के लिए कहें और इसके बजाय प्रतिक्रिया बॉडी में किसी भी विफलता की स्थिति डालें, उदाहरण के लिए एक मान के रूप में जिसे आपकी प्रतिक्रिया मैपिंग उठा सकती है।

यह हर वेबहूक (Webhook) स्टेप पर लागू होता है, जिसमें पहले बनाए गए भी शामिल हैं। एक एंडपॉइंट पता जो अब ऊपर दिए गए अवरुद्ध-पते के नियम से मेल खाता है, उसी तरह विफल होना शुरू हो जाएगा।

एक विफल अनुरोध के विपरीत, एक प्रतिक्रिया जो आती है लेकिन साफ-सुथरी रूप से मैप नहीं होती है, जैसे अमान्य JSON, एक अनसुलझा पाथ (Path), या 64 KB से अधिक की बॉडी, यात्री को नहीं हटाती है। ऊपर प्रतिक्रिया मैपिंग के तहत नोट देखें।

वेबहूक का परीक्षण करें

यह सत्यापित करने के लिए वेबहूक का परीक्षण करें (Test webhook) पर क्लिक करें कि आपका वेबहूक कॉन्फ़िगरेशन सही है और अनुरोध सफलतापूर्वक भेजा गया है।

यदि कोई हेडर अभी भी संग्रहीत मास्क दिखाता है, तो Pushwoosh परीक्षण अनुरोध के लिए वास्तविक, सहेजे गए मान में भरता है। मान आपके ब्राउज़र में कभी दिखाई नहीं देता है।

यह प्रतिस्थापन केवल इस सटीक स्टेप पर पहले से सहेजे गए हेडर के लिए काम करता है। एक स्टेप जिसे आपने अभी तक सहेजा नहीं है, या जिसे आपने अभी कॉपी किया है, उसके मास्क के पीछे कोई सहेजा गया मान नहीं है, इसलिए Pushwoosh उस हेडर के बिना परीक्षण अनुरोध भेजता है।

एक सफल परीक्षण (या एक लाइव कॉल) के बाद, कॉल्स लॉग (Calls log) खोलें, पंक्ति का विस्तार करें, और प्रत्येक पाथ (Path) के साथ प्रतिक्रिया बॉडी की तुलना करें। फ़ील्ड ठीक वैसे ही मौजूद होना चाहिए जैसे पाथ (Path) में है। यदि अनुरोध सफल होता है लेकिन बाद के स्टेप में कोई मान नहीं है, तो पाथ (Path) आमतौर पर प्रतिक्रिया से मेल नहीं खाता है। वेबहूक (Webhook) स्टेप उसके लिए कोई त्रुटि नहीं दिखाएगा।

अपनी कॉन्फ़िगरेशन सहेजें

अपनी वेबहूक कॉन्फ़िगरेशन को सहेजने के लिए सहेजें (Save) पर क्लिक करें।

कॉल्स लॉग

पॉइंट के ड्रॉअर में कॉल्स लॉग (Calls log) टैब खोलें यह देखने के लिए कि Pushwoosh ने वास्तव में इस स्टेप के लिए क्या भेजा: समय, उपयोगकर्ता, परिणाम, और अवधि, 30 दिन पीछे जाकर।

परिणाम (सफलता (Success), HTTP त्रुटि (HTTP error), कोई प्रतिक्रिया नहीं (No response)) द्वारा फ़िल्टर करें या सटीक उपयोगकर्ता आईडी या HWID द्वारा खोजें। अनुरोध (विधि, URL, और बॉडी) और, परिणाम के आधार पर, या तो प्रतिक्रिया (स्थिति और बॉडी) या त्रुटि टेक्स्ट देखने के लिए एक पंक्ति पर क्लिक करें। अवधि (Duration) पूरे स्टेप को कवर करती है, जिसमें एक स्वचालित पुनः प्रयास पर खर्च किया गया समय भी शामिल है।

4 KB से अधिक के अनुरोध और प्रतिक्रिया बॉडी काट दिए जाते हैं, जिन्हें …[truncated] के साथ चिह्नित किया जाता है। कोई भी मान जो Pushwoosh ने एक हेडर में भेजा है, जैसे कि एक बियरर टोकन या API कुंजी, को [redacted] से बदल दिया जाता है जहाँ भी वह अन्यथा दिखाई देता: URL में, बॉडी में, और त्रुटि टेक्स्ट में, न कि केवल एक हेडर्स फ़ील्ड में।