नया गाइड: प्रतिष्ठा को नुकसान पहुँचाए बिना डेडिकेटेड IP को वार्म-अप कैसे करें। अभी पढ़ें →
MigoSMTP
Webhooks और इवेंट

जानें जैसे ही कुछ होता है

हर डिलीवरी, बाउंस, ओपन, क्लिक और शिकायत के हस्ताक्षरित इवेंट पाएँ, और जो छूट गया उसे रीप्ले करें।

AI इवेंट स्ट्रीम का सारांश बनाता है और असामान्य बाउंस पैटर्न दिखते ही फ़्लैग करता है।

एंडपॉइंट जोड़ें
URL
https://example.com/hook
सीक्रेट
••••••••••
सेव करें
एंडपॉइंट जोड़ा गया
सिर्फ़ HTTPS
सत्यापित
HTTPS एंडपॉइंट जोड़ेंहमें ऐसा URL दें जो POST अनुरोध प्राप्त कर सके। कोई भी असली इवेंट भेजने से पहले हम पुष्टि करते हैं कि वह जवाब देता है।
सब्सक्राइब किए गए इवेंट
deliveredसंदेश स्वीकार हुआ
bouncedहार्ड और सॉफ़्ट
complainedस्पैम रिपोर्ट
clickedलिंक गतिविधि
हर इवेंट के अनुसार
हर स्ट्रीम के अनुसार
अपने मनचाहे इवेंट चुनेंसिर्फ़ उन्हीं को सब्सक्राइब करें जिन पर आप कार्रवाई करते हैं: delivered, bounced, complained, opened या clicked।
डिलीवरी इवेंट
हस्ताक्षरित इवेंट
/hooks/mail
200 OK
एनालिटिक्स
200 OK
CRM सिंक
200 OK
रियल टाइम
एकाधिक एंडपॉइंट
इवेंट रियल टाइम में फ़ैन आउट होते हैंहर इवेंट सब्सक्राइब करने वाले हर एंडपॉइंट पर पोस्ट होता है, ताकि एनालिटिक्स, CRM और अलर्ट सब सिंक में रहें।
पेलोड
{ "event": "delivered" }
सिग्नेचर हेडर
sha256=9f2c41…
साझा सीक्रेट
टाइमस्टैम्प के साथ
Constant-time तुलना
सत्यापन में विफल किसी भी चीज़ को अस्वीकार करें
HMAC-SHA256
रीप्ले सुरक्षित
हर अनुरोध सत्यापित करेंहर अनुरोध में आपके सीक्रेट से बना HMAC सिग्नेचर होता है, ताकि आप साबित कर सकें कि वह हमारी ओर से आया।
एंडपॉइंट हेल्थ · /hooks/mail
AI
1 घंटा पहले
अभी
एरर बढ़ रहे हैंज़्यादातर विफलताएँ आपकी पिछली डिप्लॉयमेंट के बाद 502 हैं।
सुझाव: इवेंट क्यू करें, फिर /hooks/mail ठीक होने पर रीप्ले करें
विफलताओं को समूहित करता है
रोकें या रीप्ले करें
AI विफल होते एंडपॉइंट को जल्दी पकड़ता हैरीट्राई खत्म होने का इंतज़ार करने की जगह, AI देखता है कि आपके एंडपॉइंट की एरर रेट बढ़ रही है और विफलताओं को कारण के अनुसार समूहित करता है। वह सुधार सुझाता है और शोर करने वाले इवेंट को रोक सकता है।
Webhook हैंडलर
Node
Python
PHP
Go
PHP
app.post("/hook", (req, res) => {
verify(req, SECRET)
res.sendStatus(200)
})
200 OK
जल्दी ack करें
Idempotent
कुछ ही लाइनों में हैंडलरसिग्नेचर सत्यापित करें, जल्दी ack करें, बाद में प्रोसेस करें। भरोसेमंद कंज्यूमर को बस इतना ही चाहिए।
एंडपॉइंट
इवेंट
फ़ैन-आउट
सिग्नेचर
AI ट्रायाज
हैंडलर
SMTP रिलेREST APIवेबहुकडेडिकेटेड IPDKIM साइनिंगइनबाउंड पार्सटेम्पलेटएनालिटिक्ससप्रेशन लिस्टप्रतिष्ठा मॉनिटरिंगईमेल वैलिडेशनटीम भूमिकाएँ और ऑडिट लॉगSMTP रिलेREST APIवेबहुकडेडिकेटेड IPDKIM साइनिंगइनबाउंड पार्सटेम्पलेटएनालिटिक्ससप्रेशन लिस्टप्रतिष्ठा मॉनिटरिंगईमेल वैलिडेशनटीम भूमिकाएँ और ऑडिट लॉग
क्षमताएँ

भरोसेमंद इवेंट डिलीवरी

हर नतीजा

Delivered, deferred, bounced, opened, clicked, complained और unsubscribed।

हस्ताक्षरित पेलोड

सत्यापित करें कि हर अनुरोध MigoSMTP से आया।

बैकऑफ़ के साथ रीट्राई

विफल डिलीवरी अपने आप रीट्राई होती हैं।

रीप्ले

आउटेज के बाद लॉग से इवेंट दोबारा भेजें।

इवेंट फ़िल्टर

सिर्फ़ ज़रूरी इवेंट सब्सक्राइब करें।

डिलीवरी लॉग

हर प्रयास का अनुरोध, रिस्पॉन्स और स्टेटस देखें।

यह कैसे काम करता है

इवेंट होता हैकोई संदेश डिलीवर, डिफर, बाउंस होता है, खोला या क्लिक किया जाता है, या स्पैम रिपोर्ट होता है।
MigoSMTP हस्ताक्षर करके भेजता हैइवेंट को हस्ताक्षरित JSON पेलोड में लपेटकर आपके HTTPS एंडपॉइंट पर भेजा जाता है।
आपका एंडपॉइंट सत्यापित करता हैआपका हैंडलर सिग्नेचर जाँचता है, फिर 2xx रिस्पॉन्स से पावती देता है।
रीट्राई और रीप्लेविफल डिलीवरी रीट्राई होती हैं, और आउटेज के बाद आप लॉग से इवेंट रीप्ले कर सकते हैं।
चरण 1

एंडपॉइंट जोड़ें

अपना HTTPS URL डालें और इवेंट चुनें।

चरण 2

सिग्नेचर सत्यापित करें

हर अनुरोध पर सिग्नेचर हेडर जाँचें।

चरण 3

प्रोसेस करें और पावती दें

प्राप्ति की पुष्टि के लिए 2xx रिस्पॉन्स लौटाएँ।

इसे चलते देखें

पहले भेजने से इनबॉक्स तक, एक ही प्लेटफ़ॉर्म

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

app.migosmtp.com / sendनमूना डेटा
क्यू में
184,320
आज भेजे गए
6,418,905
रेट
412/s
स्वीकृतyou@example.com को संदेश
स्वीकृतteam@example.com को संदेश
क्यू में25,000 प्राप्तकर्ताओं का बैच
स्वीकृतops@example.com को संदेश
ऑपरेशंस

अपने सिस्टम को अपने ईमेल के साथ तालमेल में रखें

पोलिंग के बिना अपना डेटाबेस अपडेट करें, वर्कफ़्लो ट्रिगर करें और अपनी टीम को अलर्ट करें।

  • हर एंडपॉइंट के लिए अलग इवेंट चयन
  • ऑटोमैटिक रीट्राई और मैन्युअल रीप्ले
  • पूरे अनुरोध और रिस्पॉन्स के लॉग
  • रोटेट किए जा सकने वाले सीक्रेट
एक नज़र में
ट्रांसपोर्टHTTPS POST
फ़ॉर्मैटJSON
सुरक्षासिग्नेचर हेडर
रीट्राईऑटोमैटिक, बैकऑफ़ के साथ
ओवरव्यू

Webhooks और इवेंट क्या हैं?

ईमेल webhook HTTP कॉलबैक हैं जो आपके भेजे संदेश के साथ कुछ होने पर आपके एप्लिकेशन को सूचित करते हैं। MigoSMTP आपके HTTPS एंडपॉइंट पर हस्ताक्षरित JSON पेलोड भेजता है, जैसे delivered, deferred, bounced, opened, clicked, complained और unsubscribed इवेंट के लिए। आपका सिस्टम स्टेटस के लिए बार-बार API से पूछने की जगह तुरंत प्रतिक्रिया देता है। पेलोड में मैसेज ID, प्राप्तकर्ता, इवेंट प्रकार, टाइमस्टैम्प और विफलताओं के लिए रिसीविंग सर्वर का दिया कारण होता है। इन फ़ील्ड से आप बिना अतिरिक्त लुकअप या अंदाज़े के इवेंट को अपने रिकॉर्ड से मिला सकते हैं।

आप एक एंडपॉइंट रजिस्टर करते हैं, चुनते हैं कि उसे कौन-से इवेंट मिलें, और हर अनुरोध पर सिग्नेचर हेडर सत्यापित करते हैं। प्राप्ति की पुष्टि के लिए 2xx रिस्पॉन्स लौटाएँ। अगर आपका एंडपॉइंट विफल हो, तो डिलीवरी बैकऑफ़ के साथ रीट्राई होती हैं, और आउटेज के बाद आप लॉग से इवेंट रीप्ले कर सकते हैं। हर प्रयास के अनुरोध और रिस्पॉन्स का ब्योरा रखा जाता है ताकि आप जल्दी डीबग कर सकें। सीक्रेट रोटेट किए जा सकते हैं, और इवेंट फ़िल्टर हर एंडपॉइंट को केंद्रित रखते हैं। विफल प्रयासों में अनुरोध, रिस्पॉन्स और समय दिखता है, जिससे हैंडलर डीबग करना तेज़ और प्रमाण-आधारित बनता है।

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

उपयोग के मामले

Webhooks और इवेंट के आम उपयोग

अपने डेटाबेस को सिंक में रखना

डिलीवर होने पर ऑर्डर को नोटिफ़ाइड मार्क करें और हार्ड बाउंस आने पर कॉन्टैक्ट फ़्लैग करें। Webhook पोलिंग जॉब की ज़रूरत हटाते हैं और एप्लिकेशन की स्थिति सटीक रखते हैं।

ऑटोमैटिक सप्रेशन हैंडलिंग

बाउंस या शिकायत इवेंट पर पते को तुरंत अपनी do-not-mail टेबल में जोड़ें, ताकि उसी व्यक्ति को ईमेल करने वाले दूसरे सिस्टम भी रुक जाएँ।

सपोर्ट टीमों को अलर्ट करना

पासवर्ड रीसेट बाउंस होने पर Slack या टिकट अलर्ट भेजें। तब सपोर्ट ग्राहक के हार मानने से पहले किसी और चैनल से उनसे संपर्क कर सकता है। इससे मैन्युअल काम के घंटे बचते हैं।

डाउनटाइम के बाद रिकवरी

अगर डिप्लॉयमेंट के दौरान आपका एंडपॉइंट ऑफ़लाइन था, तो लॉग से छूटे हुए इवेंट रीप्ले करें और अपने रिकॉर्ड सही स्थिति में ले आएँ। इस बीच कुछ नहीं खोता।

ऑर्डर और टिकट स्टेटस अपडेट करें

डिलीवरी इवेंट आते ही ऑर्डर को नोटिफ़ाइड या सपोर्ट टिकट को उत्तरित मार्क करें।

अपने डेटा वेयरहाउस को फ़ीड करें

इवेंट को अपने एनालिटिक्स में स्ट्रीम करें, ताकि ईमेल नतीजे प्रोडक्ट और रेवेन्यू डेटा के साथ दिखें।

तरीका चुनना

Webhook या API पोलिंग?

दोनों आपको इवेंट डेटा देते हैं। वे अलग-अलग स्थितियों में फ़िट बैठते हैं।

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

कई टीमें लाइव अपडेट के लिए webhook और छूटी हुई चीज़ों को बैक-फ़िल करने के लिए API इस्तेमाल करती हैं।

AI फ़ीचर

AI-असिस्टेड webhook और इवेंट

कोपायलट

इवेंट स्ट्रीम सारांश

कोपायलट हज़ारों इवेंट को छोटे डाइजेस्ट में समेटता है, जैसे कौन-सा प्रोवाइडर डिफर कर रहा है और कौन-सा कैंपेन शिकायतें बढ़ा रहा है, हर बिंदु के पीछे के संदेशों के लिंक के साथ।

पूर्वानुमानित

इवेंट पर एनोमली डिटेक्शन

मॉडल सामान्य बाउंस, शिकायत और डिफ़रल दर सीखते हैं और स्ट्रीम के उनसे हटने पर आपको अलर्ट करते हैं। किसे सूचित किया जाए और कोई ऑटोमेशन चले या नहीं, यह आप तय करते हैं।

असिस्ट

पेलोड डीबगिंग असिस्टेंट

विफल डिलीवरी लॉग पेस्ट करें, और असिस्टेंट संभावित कारण समझाता है, जैसे सिग्नेचर मिसमैच या टाइमआउट, और टेस्ट करने के लिए सुधार सुझाता है। बदलाव आप करते हैं।

एजेंट-रेडी

एजेंट-रेडी इवेंट एक्सेस

MCP सर्वर के ज़रिए AI एजेंट रीड-ओनली स्कोप के साथ इवेंट हिस्ट्री और डिलीवरी लॉग पढ़ सकते हैं। राइट कार्रवाइयों के लिए स्पष्ट स्कोप चाहिए और, आप चाहें तो, मानवीय मंज़ूरी भी।

AI फ़ीचर सहायक हैं: वे सारांश बनाते और अलर्ट करते हैं, और कोई भी स्वचालित कार्रवाई आपकी टीम कॉन्फ़िगर और मंज़ूर करती है।

बेस्ट प्रैक्टिस

Webhook और इवेंट के लिए सर्वोत्तम अभ्यास

हर बार सिग्नेचर सत्यापित करें

जिन अनुरोधों का सिग्नेचर हेडर मेल नहीं खाता, उन्हें अस्वीकार करें। सीक्रेट को समय-समय पर रोटेट करें, और उजागर होने की आशंका हो तो तुरंत।

जल्दी जवाब दें, काम एसिंक्रोनस करें

पेलोड सुरक्षित सहेजते ही 2xx से पावती दें, फिर उसे क्यू से प्रोसेस करें। धीमे हैंडलर टाइमआउट और डुप्लिकेट रीट्राई पैदा करते हैं।

डुप्लिकेट और अव्यवस्था के लिए डिज़ाइन करें

डिलीवरी दोहराई जा सकती हैं और क्रम से बाहर आ सकती हैं। डुप्लिकेट हटाने और पुराने स्टेट बदलावों को अनदेखा करने के लिए मैसेज ID और टाइमस्टैम्प इस्तेमाल करें।

सिर्फ़ वही सब्सक्राइब करें जो आप इस्तेमाल करते हैं

हर एंडपॉइंट पर इवेंट फ़िल्टर करें। कम अप्रासंगिक अनुरोधों का मतलब है आपके सर्वर पर कम लोड और सरल मॉनिटरिंग। इंटीग्रेशन को हल्का और डीबग में तेज़ रखें।

अपने एंडपॉइंट को मॉनिटर करें

डिलीवरी लॉग में बार-बार की विफलताओं पर अलर्ट लगाएँ। चुपचाप आउटेज का मतलब है चुपचाप डेटा ड्रिफ़्ट, जब तक कोई उस अंतराल को रीप्ले न करे।

जल्दी पावती दें, बाद में प्रोसेस करें

2xx रिस्पॉन्स जल्दी लौटाएँ और भारी काम क्यू पर डालें, ताकि धीमे हैंडलर रीट्राई ट्रिगर न करें।

FAQ

Webhook और इवेंट: अक्सर पूछे जाने वाले प्रश्न

एंडपॉइंट जोड़ने में मदद चाहिए? लॉन्च से पहले हमारी टीम आपके साथ उसकी समीक्षा कर सकती है।

ईमेल webhook क्या है?

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

Webhook सिग्नेचर कैसे सत्यापित करूँ?

हर अनुरोध में आपके एंडपॉइंट के सीक्रेट से बना सिग्नेचर हेडर होता है। अपनी ओर से रॉ रिक्वेस्ट बॉडी से सिग्नेचर दोबारा निकालें और तुलना करें। अगर वे अलग हों तो अनुरोध अस्वीकार करें। डॉक्यूमेंटेशन में कोड नमूने हैं।

मुझे कौन-से इवेंट मिल सकते हैं?

Delivered, deferred, bounced, opened, clicked, complained और unsubscribed। आप हर एंडपॉइंट को उनके एक हिस्से के लिए सब्सक्राइब कर सकते हैं, ताकि एक सेवा को बाउंस मिलें और दूसरी को एंगेजमेंट इवेंट। सिर्फ़ वही चुनें जिन पर आपके सिस्टम कार्रवाई करते हैं, जैसे सप्रेशन के लिए बाउंस और एनालिटिक्स के लिए क्लिक, ताकि आपके एंडपॉइंट का ट्रैफ़िक छोटा और प्रासंगिक रहे।

मेरा एंडपॉइंट डाउन हो तो क्या होता है?

विफल डिलीवरी बैकऑफ़ के साथ रीट्राई होती हैं, और ठीक होने के बाद आप लॉग से इवेंट रीप्ले कर सकते हैं। हर प्रयास, अनुरोध और रिस्पॉन्स के साथ, दर्ज होता है ताकि आप देख सकें क्या विफल हुआ। जाँचें कि आपका हैंडलर जल्दी लौटता है और विफलताएँ लॉग करता है।

क्या webhook इवेंट क्रम में डिलीवर होते हैं?

सख़्त क्रम पर भरोसा न करें। मैसेज ID और टाइमस्टैम्प का उपयोग करके ऐसे हैंडलर बनाएँ जो डुप्लिकेट और क्रम से बाहर इवेंट सहन करें। इवेंट का क्रम प्रोवाइडर और रीट्राई के बीच अलग हो सकता है, और एक संदेश कई इवेंट पैदा कर सकता है।

बॉट ओपन क्या हैं?

कुछ मेल सिस्टम इमेज अपने आप फ़ेच करते हैं, जो ओपन के रूप में दर्ज होता है भले ही किसी व्यक्ति ने संदेश न पढ़ा हो। हम जहाँ संभव हो इन्हें मानवीय ओपन से अलग करते हैं, लेकिन ओपन ट्रैकिंग एक अनुमान ही रहती है। ओपन को मोटा संकेतक मानें। क्लिक और जवाबों को एंगेजमेंट का मज़बूत संकेत मानें।

Webhook एंडपॉइंट को कैसे टेस्ट करूँ?

डैशबोर्ड से अपने URL पर एक सैंपल इवेंट भेजें और जाँचें कि आपका हैंडलर सिग्नेचर सत्यापित करता है और 2xx लौटाता है। अनुरोध और अपना रिस्पॉन्स देखने के लिए डिलीवरी लॉग देखें। प्रोडक्शन से पहले टेस्ट सीक्रेट वाला स्टेजिंग एंडपॉइंट इस्तेमाल करें। प्रोडक्शन को एंडपॉइंट की ओर मोड़ने से पहले इसे चलाएँ।

AI webhook और इवेंट के साथ कैसे काम करता है?

AI इवेंट स्ट्रीम का सारांश बना सकता है, असामान्य बाउंस या शिकायत पैटर्न फ़्लैग कर सकता है और विफल डिलीवरी डीबग करने में मदद कर सकता है। वह कार्रवाइयाँ सुझाता है लेकिन आपका कॉन्फ़िगरेशन तब तक नहीं बदलता जब तक आप कोई नियम न बनाएँ। नए एंडपॉइंट जोड़ने से पहले हाल के लॉग देखें।

एंडपॉइंट को कैसे टेस्ट करूँ?

डैशबोर्ड से एक सैंपल इवेंट भेजें।

क्या क्रम की गारंटी है?

ऐसे हैंडलर बनाएँ जो डुप्लिकेट और क्रम से बाहर इवेंट सहन करें, डुप्लिकेट हटाने के लिए मैसेज ID और टाइमस्टैम्प इस्तेमाल करें।

मिनटों में भेजना शुरू करें।

खाता बनाएँ, अपना डोमेन जोड़ें और पहला ईमेल भेजें।