इनबाउंड ईमेल API आपके किसी एड्रेस या डोमेन पर भेजा गया मेल प्राप्त करता है, उसे पार्स करता है, और एक स्ट्रक्चर्ड HTTP POST के रूप में आपके एप्लिकेशन को डिलीवर करता है। मेल सर्वर चलाने और IMAP से मेलबॉक्स पोल करने के बजाय, आप अपने डोमेन के MX रिकॉर्ड्स को प्रोवाइडर की ओर पॉइंट करते हैं, और हर इनकमिंग मैसेज आपके एंडपॉइंट पर हेडर, बॉडी और अटैचमेंट्स के साथ JSON में पार्स होकर पहुँचता है।
इनबाउंड ईमेल कैसे काम करता है?
रूटिंग DNS से शुरू होती है। आप किसी डोमेन या सबडोमेन (जैसे reply.yourapp.com) के MX रिकॉर्ड्स को इनबाउंड प्रोवाइडर के मेल सर्वर की ओर पॉइंट करते हैं। जब कोई उस डोमेन के किसी एड्रेस पर मैसेज भेजता है, तो वह आपके बजाय प्रोवाइडर के इंफ्रास्ट्रक्चर पर पहुँचता है। प्रोवाइडर मैसेज स्वीकार करता है, उसे पार्स करता है, और आपके रजिस्टर किए हुए URL पर पार्स की गई सामग्री के साथ एक POST रिक्वेस्ट भेजता है।
पार्स किए गए पेलोड में आम तौर पर सेंडर और रिसिपिएंट, सब्जेक्ट, प्लेन-टेक्स्ट और HTML बॉडी, पूरा हेडर सेट, और अटैचमेंट्स (अक्सर base64-एन्कोडेड या URL से रेफ़रेंस किए हुए) शामिल होते हैं। आपका ऐप उस JSON को पढ़ता है और उस पर कार्रवाई करता है, बिना किसी SMTP या IMAP कोड को मेंटेन किए। डिलीवरी मैकेनिज़्म एक webhook है, इसलिए वही नियम लागू होते हैं: एक त्वरित 2xx के साथ रिस्पॉन्ड करें, फिर मैसेज को असिंक्रोनस तरीके से प्रोसेस करें।
इसका उपयोग किसलिए किया जाता है?
इनबाउंड ईमेल प्राप्त मैसेज को एप्लिकेशन इवेंट्स में बदलता है। सामान्य पैटर्न में शामिल हैं:
- रिप्लाई हैंडलिंग।
notifications@yourapp.comसे एक नोटिफिकेशन भेजें, और जब यूज़र रिप्लाई करता है, तो रिप्लाई एक POST के रूप में आती है ताकि आप उसे वापस किसी कन्वर्सेशन में थ्रेड कर सकें। - सपोर्ट टिकटिंग।
support@yourapp.comपर आने वाला मेल एक नई टिकट बन जाता है, जिसमें सेंडर और बॉडी सीधे आपके हेल्प डेस्क में मैप हो जाते हैं। - पार्स टू डेटाबेस। फ़ॉर्वर्ड की गई रसीदें या स्ट्रक्चर्ड ईमेल पार्स होकर सीधे टेबल में लिख दिए जाते हैं, बिना मैन्युअल एंट्री के।
- ईमेल टू एक्शन। किसी विशेष एड्रेस पर भेजा गया मैसेज एक वर्कफ़्लो ट्रिगर करता है: एक रिकॉर्ड बनाएँ, कोई जॉब शुरू करें, किसी चैनल में पोस्ट करें।
यह मेल भेजने से कैसे अलग है?
आउटबाउंड और इनबाउंड अलग-अलग कार्य हैं। आउटबाउंड का मतलब है कि आपका ऐप SMTP या किसी HTTP सेंड API के ज़रिए प्राप्तकर्ताओं को मेल डिलीवर करता है। इनबाउंड इसका उलटा है: बाहरी सेंडर आपके ऐप को मेल डिलीवर करते हैं। एक पूर्ण ईमेल इंटीग्रेशन आम तौर पर दोनों काम करता है, नोटिफ़िकेशन बाहर भेजना और रिप्लाइज़ वापस प्राप्त करना, लेकिन दोनों स्वतंत्र रूप से कॉन्फ़िगर किए जाते हैं और इनबाउंड पक्ष वह है जो आपके MX रिकॉर्ड्स पर निर्भर करता है।
IMAP से मेलबॉक्स पोल क्यों नहीं करना चाहिए?
आप किसी असली मेलबॉक्स के लिए IMAP पोलर चला सकते हैं, लेकिन इसकी निरंतर लागत होती है। आप क्रेडेंशियल्स मैनेज करते हैं, कितनी बार पोल करना है यह तय करते हैं (जिससे विलंब और आइडल कनेक्शन बढ़ते हैं), रॉ MIME खुद पार्स करते हैं, और ट्रैक करते हैं कि कौन-से मैसेज आप पहले ही प्रोसेस कर चुके हैं। एक इनबाउंड API इसमें से अधिकांश हटा देता है: प्रोवाइडर MIME पार्स करता है, हर मैसेज को क्लीन JSON के रूप में एक बार पुश करता है, और आप लगभग रियल टाइम में रिएक्ट करते हैं। अंतर्निहित प्रोटोकॉल की तुलना के लिए देखें SMTP vs. IMAP।
अक्सर पूछे जाने वाले प्रश्न
मुझे कौन-से DNS बदलाव करने होंगे?
जिस डोमेन या सबडोमेन पर आप मेल प्राप्त करना चाहते हैं, उसके MX रिकॉर्ड्स को अपने इनबाउंड प्रोवाइडर की ओर पॉइंट करें। प्रोपेगेशन के बाद, उस डोमेन के किसी भी एड्रेस पर आने वाला मेल प्रोवाइडर तक पहुँचता है, जो उसे पार्स करके आपके एंडपॉइंट पर पोस्ट करता है। एक डेडिकेटेड सबडोमेन का उपयोग करने से इनबाउंड रूटिंग आपके मुख्य डोमेन के मेल से अलग रहती है।
अटैचमेंट्स कैसे हैंडल किए जाते हैं?
पार्स किए गए पेलोड में अटैचमेंट्स शामिल होते हैं, आम तौर पर या तो base64-एन्कोडेड इनलाइन या ऐसे URL के रूप में जिन्हें आप अलग से फ़ेच करते हैं। आपका हैंडलर उन्हें डिकोड या डाउनलोड करता है और जहाँ भी आप फ़ाइलें रखते हैं वहाँ स्टोर करता है। बड़े अटैचमेंट्स को आम तौर पर URL से रेफ़रेंस किया जाता है ताकि पेलोड छोटा रहे।
क्या इनबाउंड ईमेल और webhook एक ही चीज़ हैं?
डिलीवरी एक webhook का उपयोग करती है: प्रोवाइडर हर मैसेज के लिए आपके ऐप को एक HTTP POST भेजता है। अंतर यह है कि पेलोड किसी जेनेरिक इवेंट के बजाय एक पूरी तरह पार्स किया हुआ ईमेल होता है। किसी भी webhook की तरह इसे वेरिफ़ाई करें, जल्दी रिस्पॉन्ड करें, और असिंक्रोनस तरीके से प्रोसेस करें।
यह देखने के लिए कि Bird ईमेल की दोनों दिशाओं को कैसे हैंडल करता है, ईमेल प्रोडक्ट ओवरव्यू और ईमेल इवेंट्स गाइड से शुरू करें, जो उस इवेंट डिलीवरी मॉडल को कवर करती है जिस पर आपका इनबाउंड हैंडलर बनेगा।