एजेंट मेलबॉक्स

एजेंट मेलबॉक्स एक पता-योग्य इनबॉक्स है जिसे आपका कोड API के ज़रिए मैनेज करता है। इसके थ्रेड्स पढ़ें और फ़िल्टर करें, मैसेज का जवाब दें, या नया मेल कंपोज़ करें, बिना IMAP सर्वर चलाए या रॉ MIME पार्स किए।

मेलबॉक्स शेयर्ड inbox.ai डोमेन पर रहता है, या आपके अपने रिसीविंग-सक्षम सेंडिंग डोमेन पर। इसका पता बनाते ही क्लेम हो जाता है और आपका बना रहता है: लोकल पार्ट आपके वर्कस्पेस के लिए आरक्षित होता है और मेलबॉक्स हटाने के बाद भी कभी किसी और को नहीं दिया जाता।

पते

हर मेलबॉक्स का एक पता होता है, {local_part}@inbox.ai। आप दो तरीकों से पता पा सकते हैं:

जेनरेटेड: लोकल पार्ट छोड़ दें और हम आपके लिए एक कॉलिज़न-फ़्री पार्ट जेनरेट कर देंगे (a7f3k2@inbox.ai)। हमेशा उपलब्ध।
कस्टम: कोई विशेष लोकल पार्ट माँगें (support@inbox.ai)। कस्टम हैंडल वैश्विक रूप से अद्वितीय हैं, पहले आओ पहले पाओ के आधार पर, और पेड-प्लान अलाउंस का हिस्सा हैं; फ़्री वर्कस्पेस जेनरेटेड पते इस्तेमाल करता है।

पता बनने के बाद अपरिवर्तनीय होता है। बदलने के लिए नया मेलबॉक्स बनाएँ और पुराना हटा दें। पुराना लोकल पार्ट 30 दिन (उसकी रिस्टोर विंडो) तक होल्ड रहता है, उसके बाद ही फिर से क्लेम किया जा सकता है, और आपके वर्कस्पेस के लिए आरक्षित बना रहता है।

थ्रेड्स और मैसेज

प्राप्त और भेजे गए मेल को थ्रेड्स में समूहित किया जाता है, हर बातचीत के लिए एक। थ्रेड में भाग लेने वाले पते, अपठित संख्या, उसके नवीनतम मैसेज की दिशा (inbound या outbound), और सबसे हालिया गतिविधि का टाइमस्टैम्प होता है। जवाब उसी थ्रेड में जुड़ जाते हैं; नया कंपोज़ एक नया थ्रेड शुरू करता है।

हर मैसेज हेडर, उद्धृत इतिहास हटाकर निकाला गया प्लेन टेक्स्ट, और अटैचमेंट दिखाता है। मूल बॉडी 30 दिन तक उपलब्ध रहती है; रॉ MIME केवल प्राप्त मैसेज के लिए उपलब्ध है। मैसेज ID दिशा के अनुसार प्रीफ़िक्स्ड होते हैं: प्राप्त मैसेज के लिए rem_, आपके भेजे हुए के लिए em_।

क्या अंदर आएगा, यह तय करना

इनबॉक्स के सामने दो नियंत्रण हैं, दोनों जालसाज़ी-योग्य From: हेडर की बजाय एनवेलप सेंडर के विरुद्ध जाँचे जाते हैं:

रिसीव पॉलिसी: मेलबॉक्स-व्यापी डिफ़ॉल्ट।
- open ब्लॉक नियमों के बाद मेल स्वीकार करता है। SPF और DKIM के परिणाम इस प्रवेश नीति को नहीं बदलते।
- replies_only केवल वह मेल स्वीकार करता है जो मेलबॉक्स में पहले से मौजूद किसी थ्रेड को जारी रखता है।
- allowlist केवल उन्हीं सेंडर्स को स्वीकार करता है जिन्हें आपके नियम अनुमति देते हैं, साथ ही मौजूदा थ्रेड के जवाब भी।
- drop सब कुछ रद्द करता है, कोई अपवाद नहीं।
रिसीव रूल्स: प्रति-सेंडर अनुमति या ब्लॉक एंट्रीज़, जो पूरे पते या डोमेन पर मैच होती हैं (डोमेन रूल उसके सबडोमेन से भी मैच करता है)। ब्लॉक हमेशा अनुमति पर भारी पड़ता है।

जो मेल किसी नियम द्वारा ब्लॉक होती है वह मेलबॉक्स में संग्रहीत रहती है और पढ़ी जा सकती है। उसे इनबॉक्स से बाहर फ़ाइल किया जाता है और कोई webhook नहीं भेजा जाता। एकमात्र अपवाद वह मेलबॉक्स है जो drop पर सेट है, जो फ़ाइल करने के बजाय सब कुछ तुरंत त्याग देता है।

भेजना

मेलबॉक्स API के ज़रिए दो तरीकों से भेजता है: किसी मैसेज का जवाब दें (आउटबाउंड मैसेज उसी थ्रेड में जुड़ जाता है) या नया मैसेज कंपोज़ करें (जो एक नया थ्रेड शुरू करता है)। डैशबोर्ड में कोई मैसेज खोलें और Forward चुनें ताकि उसकी मूल बॉडी और अटैचमेंट नए प्राप्तकर्ताओं को भेजे जा सकें, मूल कंटेंट की 30-दिन की विंडो के भीतर। मेल मेलबॉक्स के अपने पते से भेजा जाता है, उस पर कॉन्फ़िगर किए गए डिस्प्ले नेम और डिफ़ॉल्ट Reply-To के साथ। डिलीवरी स्टेटस भेजे गए मैसेज पर वापस दिखता है, ताकि आप देख सकें कि जवाब डिलीवर हुआ या बाउंस।

इवेंट्स

बिना पोलिंग के एजेंट चलाने के लिए email_mailbox.* webhook फ़ैमिली सब्सक्राइब करें: email_mailbox.message_received (इनबाउंड मेल इनबॉक्स में पहुँचा), email_mailbox.thread_created, और आपके भेजे गए संदेशों के डिलीवरी-स्टेटस इवेंट। केवल इनबॉक्स मेल ही फैलता है; स्पैम और नियम-अवरुद्ध मेल चुपचाप संग्रहीत होता है, ताकि एक भरा हुआ मेलबॉक्स webhooks की बाढ़ में न बदले। इनबॉक्स मेल मानक email.received इवेंट भी ट्रिगर करता है, जिससे मौजूदा इनबाउंड इंटीग्रेशन काम करता रहे। दोनों इवेंट प्रमाणीकरण परिणाम साथ लाते हैं। स्वचालित रूटिंग से पहले उन फ़ील्ड की जाँच करें: इनबॉक्स डिलीवरी का मतलब यह नहीं कि प्रेषक सत्यापित था।

रिटेंशन और मिटाना

मेलबॉक्स का रिटेंशन टियर नियंत्रित करता है कि आप संदेश हेडर, निकाला गया टेक्स्ट और मेलबॉक्स अटैचमेंट कितने समय तक पढ़ सकते हैं, जो भेजने या प्राप्त होने से मापा जाता है। डिफ़ॉल्ट 30 दिन है। अगर आपके प्लान में 90-दिन या 365-दिन का रिटेंशन शामिल है, तो बनाते या अपडेट करते समय retention_tier सेट करें। जो टियर आपके प्लान में शामिल नहीं है उसे E17048 के साथ अस्वीकार किया जाता है।

सामग्री या कार्य	रिटेंशन विंडो
संदेश हेडर, निकाला गया टेक्स्ट, और मेलबॉक्स अटैचमेंट	चयनित टियर: 30, 90, या 365 दिन
मूल HTML और plain-text बॉडी	हर टियर पर 30 दिन
प्राप्त संदेशों के लिए रॉ MIME	हर टियर पर 30 दिन; भेजे गए संदेशों का कोई संग्रहीत रॉ MIME नहीं
डैशबोर्ड में संदेश फ़ॉरवर्ड करना	मूल सामग्री उसकी 30-दिन की विंडो के भीतर आवश्यक
निकाला गया टेक्स्ट पढ़ना या नई सामग्री से जवाब देना	जब तक संदेश रिटेन है तब तक उपलब्ध

उदाहरण के लिए, 40वें दिन 90-दिन के मेलबॉक्स में मौजूद संदेश का निकाला गया टेक्स्ट अभी भी पढ़ने योग्य, खोजने योग्य है और अटैचमेंट रिटेन हैं। आप नई सामग्री से जवाब दे सकते हैं, लेकिन मूल बॉडी नहीं खोल सकते, उसका रॉ MIME डाउनलोड नहीं कर सकते, या उसे फ़ॉरवर्ड नहीं कर सकते। निकाला गया टेक्स्ट प्रति संदेश 64 KiB तक सीमित है और मूल के कुछ हिस्से छूट सकते हैं। विस्तारित अटैचमेंट रिटेंशन सक्षम होने से पहले संग्रहीत अटैचमेंट अपनी मूल समाप्ति लगभग 31 दिन बनाए रखते हैं; टियर बदलने से उनका माइग्रेशन नहीं होता। टियर बढ़ाने से पहले से हटाई गई सामग्री वापस नहीं आ सकती।

रिटेंशन समाप्त होने पर API संदेश लौटाना बंद कर देता है। एक प्रति-घंटा स्वीप बैकग्राउंड में डिलीशन प्रोसेस करता है; फ़िज़िकल क्लीनअप API की समाप्ति से पीछे रह सकता है।

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

आपके प्लान में शामिल टियर तक बढ़ाना किसी भी समय स्वीकार किया जाता है, भले ही पहला बदलाव अभी लागू हो रहा हो। बैकग्राउंड अपडेट दस-मिनट की पूर्ववत विंडो से स्वतंत्र है। दूसरी बार घटाना तब स्वीकार किया जाता है जब पहला बदलाव हर संग्रहीत संदेश को अपडेट कर चुका हो। अपडेट हर दस मिनट में शुरू होता है और बड़े मेलबॉक्स के लिए घंटों लग सकते हैं। पूरा होने तक API E17050 लौटाता है; बाद में फिर से प्रयास करें।

अगर आपका प्लान एक सीमित मेलबॉक्स स्टोरेज अलाउंस सेट करता है, तो एक ही अलाउंस हर सक्रिय या पुनर्स्थापन योग्य मेलबॉक्स द्वारा साझा किया जाता है। हर मेलबॉक्स अपना हिस्सा size_bytes के रूप में रिपोर्ट करता है। बिना सीमित अलाउंस वाले प्लान में असीमित मेलबॉक्स स्टोरेज होता है। जब सभी मेलबॉक्स मिलकर सीमित अलाउंस तक पहुँच जाते हैं, तो भेजना E17049 के साथ अस्वीकार कर दिया जाता है जब तक आप किसी भी मेलबॉक्स में जगह खाली नहीं करते।

मेलबॉक्स हटाने से वह तुरंत मेल प्राप्त करना बंद कर देता है। 30 दिनों तक मेलबॉक्स पुनर्स्थापित किया जा सकता है, जबकि सामान्य संदेश-रिटेंशन समाप्ति जारी रहती है। 30 दिनों के बाद स्थायी मिटाना मेलबॉक्स और उसके शेष संदेशों को हटा देता है। एक बार स्थायी मिटाना शुरू होने पर, भले ही क्लीनअप अभी चल रहा हो, पुनर्स्थापन अस्वीकार कर दिया जाता है। पता आपके वर्कस्पेस के लिए आरक्षित रहता है।

अगले कदम

अपना पहला मेलबॉक्स क्लेम करें: बनाने से लेकर जवाब देने तक का API हैपी पाथ।
AI के साथ बनाएँ: MCP सर्वर के ज़रिए एजेंट से मेलबॉक्स चलाएँ।

संबंधित संसाधन