ईमेल प्राप्त करना
प्राप्त ईमेल Email > Emails > Receiving में, inbound-messages API के ज़रिए, और email.received webhooks में उपलब्ध है। आप जिस पते पर मेल प्राप्त करना चाहते हैं, उसके आधार पर दो सेटअप तरीकों में से चुनें।
- फ़ॉरवर्डिंग एड्रेस एक मेलबॉक्स है जो हम आपके लिए जनरेट करते हैं, जैसे mfzxq2lom5uxi3lb@eu1.inbound.bird.com (US रीजन में @us1.inbound.bird.com)। कोई डोमेन नहीं, कोई DNS नहीं: आप अपने मौजूदा इनबॉक्स का फ़ॉरवर्डिंग नियम इस पर सेट करें, और हम उसके द्वारा फ़ॉरवर्ड किया गया हर संदेश प्राप्त करते हैं।
- अपने डोमेन पर प्राप्त करना आपके नियंत्रण वाले एक सबडोमेन (मान लें inbound.acme.com) के लिए MX रिकॉर्ड्स प्रकाशित करता है, जिसके बाद उस सबडोमेन पर किसी भी पते पर भेजा गया मेल एक इनबाउंड संदेश के रूप में पहुँचता है।
अगर आप प्राप्त करने की सुविधा आज़माना चाहते हैं, या किसी मौजूदा सपोर्ट इनबॉक्स का मेल फ़ॉरवर्ड करना चाहते हैं, तो फ़ॉरवर्डिंग पते से शुरू करें। जब आप चाहते हैं कि मेल सीधे आपके अपने डोमेन पर आए, तो डोमेन रिसीविंग सेट अप करें।
फ़ॉरवर्डिंग पते
Email > Domains > Forwarding में, Add forwarding address चुनें और Support inbox जैसा कोई नाम दर्ज करें। हम एक स्थायी, रैंडम पता बनाते हैं। आप बाद में इसका लेबल बदल सकते हैं। किसी एक फ़ॉरवर्डिंग पते को हटाने से उस पते पर मेल आना बंद हो जाता है, बाकी पतों पर कोई असर नहीं पड़ता।
प्रोग्रामैटिक रूप से, POST /v1/email/inbound-addresses वही काम करता है (CLI: bird email inbound-addresses create)। रिस्पॉन्स में जनरेट किया गया address, उसका id, और आपका लेबल होता है।
फिर उस पते को फ़ॉरवर्डिंग टारगेट के रूप में वहाँ सेट करें जहाँ मेल आज मौजूद है: Gmail या Google Workspace फ़ॉरवर्डिंग नियम, Outlook नियम, या आपके हेल्पडेस्क की फ़ॉरवर्डिंग सेटिंग। जो भी फ़ॉरवर्ड किया जाता है उसे हम प्राप्त करते हैं, पार्स करते हैं, और इनबाउंड संदेश के रूप में स्टोर करते हैं।
अपने डोमेन पर प्राप्त करना
डोमेन रिसीविंग एक सेंडिंग डोमेन की क्षमता है, इसलिए डोमेन पहले रजिस्टर और DKIM-सत्यापित होना ज़रूरी है। एक समर्पित सबडोमेन (inbound.acme.com) का उपयोग करें, कभी अपने apex डोमेन का नहीं: रिसीविंग डोमेन के अपने रजिस्ट्रेशन पर इनेबल होती है, और apex MX रिकॉर्ड्स आपके कॉर्पोरेट मेल को कैप्चर कर लेंगे।
Email > Domains खोलें, फिर अपना डोमेन चुनें। Receiving (Optional) में, रिसीविंग चालू करें और सूचीबद्ध MX रिकॉर्ड्स प्रकाशित करें। जब तक DKIM सत्यापित नहीं हो जाता, आप रिसीविंग इनेबल नहीं कर सकते। जो डोमेन पहले से किसी अन्य संगठन के लिए मेल प्राप्त करता है, वह भी उपलब्ध नहीं होता।
इनेबल होने के बाद, रिसीविंग स्टेटस सेंडिंग रिकॉर्ड्स के समान लाइफ़साइकल से गुज़रता है: pending जब हम MX रिकॉर्ड्स के लिए DNS जाँचते हैं, फिर verified जब वे सही रिज़ॉल्व हो जाते हैं। उसके बाद, डोमेन पर किसी भी लोकल-पार्ट को भेजा गया मेल (support@, orders@, कुछ भी) इनबाउंड संदेश के रूप में डिलीवर होता है। टॉगल बंद करने से इनबाउंड मेल की डिलीवरी रुक जाती है। MX रिकॉर्ड्स संदर्भ के लिए डोमेन पर सूचीबद्ध रहते हैं, उनका स्टेटस pending पर वापस आ जाता है।
इनबाउंड संदेश का आकार
Bird हर क्षेत्र में हर रिसीविंग डोमेन पर अटैचमेंट सहित 20 MB तक के इनबाउंड संदेश सपोर्ट करता है। बड़े संदेश समर्थित सीमा से बाहर हैं, भले ही भेजने वाले सर्वर को SMTP स्वीकृति रिस्पॉन्स मिले। उनकी डिलीवरी पर भरोसा न करें।
एक ओवरसाइज़ संदेश SMTP ट्रांज़ैक्शन के दौरान 552 5.3.4 message size limit exceeded के साथ अस्वीकार किया जा सकता है। भेजने वाला सर्वर यह अस्वीकृति प्राप्त करता है और अपने प्रेषक को सूचित कर सकता है। Bird किसी संदेश को आकार सीमा में फ़िट करने के लिए कभी काटता नहीं है।
प्राप्त मेल पढ़ना
Receiving टैब प्राप्त संदेशों को नवीनतम पहले दिखाता है, प्रेषक, प्राप्तकर्ता, विषय और प्राप्ति समय के साथ। सटीक प्रेषक पते से खोजें या तारीख से फ़िल्टर करें। कोई पंक्ति चुनें और Rendered, Text, Details, और Raw व्यू खोलें। हेडर संदेश आने पर रिकॉर्ड किए गए SPF, DKIM, और DMARC परिणाम दिखाता है।
प्राप्त ईमेल 30 दिनों तक रखे जाते हैं।
वही डेटा API (CLI: bird email inbound-messages) के ज़रिए भी उपलब्ध है:
- GET /v1/email/inbound-messages संदेशों की सूची देता है, प्रेषक, इनबाउंड पते और प्राप्ति समय से फ़िल्टर करने योग्य।
- GET /v1/email/inbound-messages/{id} एक संदेश का पार्स किया गया मेटाडेटा लौटाता है: एड्रेसिंग, विषय, थ्रेडिंग रेफ़रेंस, प्रमाणीकरण परिणाम, और अटैचमेंट मेटाडेटा।
- GET /v1/email/inbound-messages/{id}/body HTML और प्लेन-टेक्स्ट बॉडी लौटाता है।
- GET /v1/email/inbound-messages/{id}/attachments अटैचमेंट की सूची देता है; हर एक को अलग से डाउनलोड किया जा सकता है।
- GET /v1/email/inbound-messages/{id}/raw मूल संदेश को ठीक वैसे ही लौटाता है जैसे प्राप्त हुआ था, RFC 5322 (MIME) फ़ॉर्मैट में।
प्राप्त मेल पर प्रतिक्रिया: email.received webhook
मेल आते ही उसे प्रोसेस करने के लिए (सपोर्ट अनुरोध रूट करना, जवाब इनजेस्ट करना, एजेंट ट्रिगर करना), एक webhook एंडपॉइंट को email.received इवेंट पर सब्सक्राइब करें। हम हर संदेश को प्राप्त और पार्स करने के बाद इसे फ़ायर करते हैं। पेलोड में inbound_message_id, संदेश के From हेडर से प्रेषक, प्राप्तकर्ता, विषय, और in_reply_to रेफ़रेंस शामिल होता है। इसमें एक समग्र authentication निर्णय (pass, fail, या unknown) और व्यक्तिगत SPF, DKIM, और DMARC परिणाम भी शामिल होते हैं; प्रमाणीकरण परिणामों का उपयोग बताता है कि इनमें से कौन-से आज पॉपुलेट होते हैं। यह जानकारी फ़ॉलो-अप कॉल के बिना रूटिंग और ट्राइएज को सपोर्ट करती है। जब आपको बॉडी या अटैचमेंट चाहिए, तो इवेंट के inbound_message_id का उपयोग करके inbound-messages API से उन्हें फ़ेच करें। संदेश इवेंट भेजे जाने से पहले स्टोर हो जाता है, इसलिए वह id इवेंट आपके पास पहुँचते ही रिज़ॉल्व हो जाती है: अपने हैंडलर से सीधे /raw या /body फ़ेच करें, बिना किसी प्रतीक्षा या पोलिंग के।
प्रमाणीकरण परिणामों का उपयोग
SPF और DKIM की जाँच तब होती है जब कोई संदेश Bird तक पहुँचता है। प्रेषक द्वारा जोड़े गए हेडर, जैसे उनका अपना Authentication-Results, इन परिणामों को नहीं बदलते।
spf_pass और dkim_pass फ़ील्ड प्रत्येक true, false, या null होती हैं। null का अर्थ है कि कोई परिणाम रिकॉर्ड नहीं हुआ, जिसमें वे स्थितियाँ भी शामिल हैं जब कोई जाँच पूरी नहीं हो सकी। एक पासिंग DKIM सिग्नेचर dkim_pass को true बनाता है, भले ही संदेश पर कोई अन्य सिग्नेचर फ़ेल हो। ये फ़ील्ड विस्तृत रिज़ल्ट टोकन, साइनिंग डोमेन, या सेलेक्टर एक्सपोज़ नहीं करती हैं।
DMARC परिणाम अभी उपलब्ध नहीं हैं। जब तक ये उपलब्ध नहीं होते, dmarc_pass और spam_score हमेशा null रहते हैं, और authentication, जो dmarc_pass का अनुसरण करता है, हमेशा unknown रहता है। आज dmarc_pass === true या authentication === "pass" पर रूटिंग न करें: कोई भी संदेश किसी भी शर्त को पूरा नहीं करता।
अभी स्वचालित रूटिंग को गेट करने के लिए, dkim_pass === true या spf_pass === true अनिवार्य करें, और false, null, तथा अनुपस्थित मानों को असत्यापित मानें। SPF और DKIM पास इस बात की पुष्टि नहीं करते कि साइनिंग या सेंडिंग डोमेन दृश्य From हेडर के डोमेन से मेल खाता है। इनका उपयोग अनप्रमाणित मेल फ़िल्टर करने के लिए करें, इस प्रमाण के रूप में नहीं कि किसने भेजा।
DMARC संदेश के From हेडर में डोमेन के साथ अलाइनमेंट जाँचता है। email.received में from फ़ील्ड उस हेडर एड्रेस को रखती है, और जब हेडर पढ़ा नहीं जा सकता तो रिले के पार्स किए गए प्रेषक और फिर एनवेलप प्रेषक फ़ॉलबैक के रूप में उपयोग होते हैं। email_mailbox.message_received में from एनवेलप प्रेषक रखता है, जो एक अलग बाउंस एड्रेस हो सकता है। दृश्य प्रेषक का उपयोग करने वाली मेलबॉक्स रूटिंग के लिए, इवेंट के message_id का उपयोग करके प्राप्त संदेश का मेटाडेटा फ़ेच करें। DMARC पास एक डोमेन को प्रमाणित करता है; यह यह स्थापित नहीं करता कि किसी विशेष व्यक्ति ने संदेश भेजा।
अगले कदम
- सेंडिंग डोमेन: जिस डोमेन पर आप मेल प्राप्त करना चाहते हैं उसे रजिस्टर और सत्यापित करें।
- Webhooks: email.received के लिए एंडपॉइंट, सिग्नेचर, और फिर से प्रयास।
- ईमेल लॉग: Emails पेज का सेंडिंग हिस्सा।
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।