ब्राउज़र एजेंट ईमेल वेरिफिकेशन: सही OTP लेकर आगे बढ़ें

शुरू करने के लिए क्या चाहिए?

यह क्रम केवल आपके अपने परीक्षण खाते, अपने मेलबॉक्स और नियंत्रित परीक्षण वेबसाइट के लिए है। ईमेल सत्यापन का मतलब यहाँ वेबसाइट में OTP भरकर पते पर आपकी पहुँच साबित करना है, केवल ईमेल पते का प्रारूप जाँचना नहीं।

आपको ऐसा ब्राउज़र एजेंट चाहिए जिसकी अगली कार्रवाई आपका अनुप्रयोग रोक सके। उसके बाहर एक नियंत्रक रखें: वही सक्रिय प्रयास, प्रतीक्षा की सीमा और आगे बढ़ने का निर्णय संभाले। Mailera मौजूदा मेलबॉक्स जोड़ता है; मेल पढ़ने का व्यापक तरीका अपने इनबॉक्स से OTP लेने की गाइड में है।

पहले मेलबॉक्स और पहुँच तैयार करें:

1. मेलबॉक्स → मेलबॉक्स जोड़ें खोलें। Outlook या Microsoft 365 के लिए Microsoft से साइन इन करें चुनकर OAuth इस्तेमाल करें। Microsoft मेलबॉक्स जोड़ने का तरीका देखें। पुराने सेटअप में ऐप पासवर्ड की समस्या हो तो Outlook में OAuth पर जाने की गाइड देखें।
2. दूसरे प्रदाता के लिए उसकी कनेक्शन प्रक्रिया अपनाएँ। जिन खातों में ऐप पासवर्ड (app password) चाहिए, उनके लिए एजेंट मेलबॉक्स के ऐप पासवर्ड की गाइड देखें।
3. सेटिंग्स में API key वाला भाग खोलें और API key बनाएँ चुनें। मेलबॉक्स का दायरा केवल परीक्षण मेलबॉक्स वाले समूह तक रखें और पढ़ने की अनुमति read दें।
4. कुंजी सर्वर पर सुरक्षित रखें। नई कुंजी केवल एक बार दिखाई जाती है। उसे वेबसाइट के पृष्ठ, ब्राउज़र स्क्रिप्ट या एजेंट को दिखने वाले निर्देशों में न रखें।

REST से शुरुआत करें, ताकि नियंत्रक के अनुरोध और निर्णय अलग-अलग देख सकें। Mailera के डेवलपर पृष्ठ में उपलब्ध इंटरफ़ेस देखें। यदि आप Browser Use इस्तेमाल करते हैं, तो उसके आधिकारिक रिपॉज़िटरी के अनुसार Tools के साथ फ़ंक्शन पंजीकृत करके एजेंट को दिया जा सकता है। मेल पढ़ने वाला अपना टूल जोड़ें, लेकिन आगे बढ़ने की अनुमति नियंत्रक में ही रखें।

एजेंट को रोकने और फिर चलाने का क्रम क्या होगा?

रोकने का अर्थ ब्राउज़र बंद करना नहीं है। सत्यापन पृष्ठ और उसका सत्र बनाए रखें; केवल वे कार्रवाइयाँ रोकें जो सत्यापन पूरा होने पर निर्भर हैं। मेलबॉक्स का सिंक रोकना इस काम का हिस्सा नहीं है।

नियंत्रक में यह क्रम बनाएँ:

1. अनुरोध से पहले प्रयास दर्ज करें। अपनी प्रयास पहचान, प्रारंभ समय, चुना गया मेलबॉक्स, अपेक्षित प्रेषक या विषय और कुल समयसीमा रखें। इन्हें उसी ब्राउज़र सत्र से बाँधें।
2. सत्यापन स्क्रीन पहचानें। एजेंट को OTP की प्रतीक्षा वाली स्थिति में डालें। उसे अपने आप नया कोड मँगाने या अगले पृष्ठ पर जाने न दें।
3. मेल पढ़ें। चुने गए मेलबॉक्स से OTP खोजें। कोई उपयोग योग्य परिणाम न मिले तो वर्तमान प्रयास को प्रतीक्षा में रखें।
4. तय समयसीमा के भीतर दोबारा जाँच करें। अनुरोधों के बीच अंतराल बढ़ाएँ, लेकिन हर बार कुल समयसीमा और ब्राउज़र सत्र की स्थिति जाँचें। प्रतीक्षा का यह तर्क नियंत्रक में लिखें।
5. प्रयास से मिलान करें। केवल सबसे नया कोड मिलने पर उसे न भरें। मेलबॉक्स और संदेश का संदर्भ वर्तमान प्रयास से साफ़ मेल खाना चाहिए।
6. वेबसाइट से परिणाम लें। कोड भरने के बाद स्पष्ट सफलता संकेत जाँचें। तभी एजेंट की बाकी कार्रवाइयाँ फिर शुरू करें। अस्वीकृति या अस्पष्ट परिणाम पर रुकें।

स्थिति-सारणी में अनुमत कार्रवाइयाँ पहले तय करने से एजेंट की मनमानी कम होती है:

कोड भरते ही स्थिति को ‘सत्यापित’ न करें। वेबसाइट का सफलता संदेश या आपके परीक्षण में तय किया गया सफल पृष्ठ निर्णायक होना चाहिए।

REST या MCP से OTP कैसे पढ़ें?

GET /mailboxes/{id}/otp सबसे नया OTP लेने का endpoint है और इसके लिए read अनुमति चाहिए। सर्वर के वातावरण में $MAILERA_API_KEY तथा अपने परीक्षण मेलबॉक्स का $MAILBOX_ID रखें:

curl --silent --show-error \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/otp" \
  -H "Authorization: Bearer $MAILERA_API_KEY"

इस endpoint में from, subject और since_minutes पैरामीटर उपलब्ध हैं। इन्हें मिलान के सहायक फ़िल्टर मानें, प्रयास की पहचान नहीं। नियंत्रक को अपने अनुरोध का प्रारंभ समय और सक्रिय प्रयास अलग से रखना चाहिए।

जब संदेश का संदर्भ भी चाहिए, GET /messages/search में extract=otp देकर खोज के परिणाम के साथ OTP निकाल सकते हैं। mailbox पैरामीटर में उसी read कुंजी की पहुँच वाले परीक्षण मेलबॉक्स की पहचान दें। यह पहचान उसी कुंजी से GET /mailboxes की सूची में अपने परीक्षण पते से मिलाकर चुनें।

q=code खोज का एक उदाहरण है; अपने परीक्षण ईमेल के अनुसार खोज चुनें। लौटे संदेशों में mailbox_id, from.address, to, subject और received_at देखें। निकाला गया कोड otp.code में मिलता है। इन फ़ील्डों से संदर्भ जाँचे बिना पहला परिणाम न चुनें।

अधिक सामग्री चाहिए तो चुने गए संदेश की पहचान $MESSAGE_ID में रखकर एक संदेश पढ़ें:

curl --silent --show-error \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages/$MESSAGE_ID" \
  -H "Authorization: Bearer $MAILERA_API_KEY"

इस प्रतिक्रिया में body.text और body.html उपलब्ध हैं। सामग्री को नियंत्रक में जाँचें; उसे एजेंट के लिए नया निर्देश न बनाएँ।

MCP समर्थित एजेंट के लिए Mailera का MCP इंटरफ़ेस get_latest_otp टूल देता है, जिसके लिए भी read चाहिए। MCP tools specification के अनुसार पहले tools/list से टूल और उसका inputSchema लें, फिर tools/call से बुलाएँ। REST पैरामीटर सीधे MCP में न कॉपी करें; उस टूल के स्कीमा का पालन करें। विनिर्देश टूल कॉल की समयसीमा और LLM को देने से पहले परिणाम जाँचने की सलाह भी देता है।

पुराना या दूसरे प्रयास का OTP कैसे रोकें?

सबसे नया मेल ज़रूरी नहीं कि वर्तमान प्रयास का हो। एक ही मेलबॉक्स पर एक साथ कई समान सत्यापन प्रयास न चलाएँ। यदि समानांतर परीक्षण आवश्यक हों, तो उनके खाते या मेलबॉक्स स्पष्ट रूप से अलग रखें।

मिलान के लिए नियंत्रक में ये नियम रखें:

• चुना गया mailbox_id वही हो जो प्रयास शुरू करते समय दर्ज किया था। प्राप्तकर्ता का पता भी जाँचें।
• प्रेषक और विषय अपेक्षित परीक्षण संदेश से मेल खाएँ। केवल प्रदर्शन नाम पर निर्णय न लें।
• received_at को प्रयास के समय के साथ देखें। हाल में आया संदेश होना अकेले पर्याप्त नहीं है।
• यदि आपकी परीक्षण वेबसाइट ईमेल में प्रयास की पहचान देती है, तो सामग्री से उसका मिलान करें। कई संदेश समान रूप से सही लगें तो कोड न भरें।

since_minutes की अवधि को सटीक प्रयास-मिलान का विकल्प न बनाएँ। कम अवधि रखने से भी नियंत्रक की प्रयास पहचान की ज़रूरत समाप्त नहीं होती।

दोबारा कोड मँगाने पर नियंत्रक में पिछले प्रयास को बंद करें और नया समय दर्ज करें। पुराने प्रयास की देर से लौटी API प्रतिक्रिया को नए प्रयास में इस्तेमाल न करें। यह नियम खास तौर पर तब काम आता है जब पहली मेल-जाँच अभी चल रही हो और आपने नया कोड माँग लिया हो।

वेबसाइट पुराने OTP को स्वीकार करती है या नहीं, यह अपने परीक्षण में अलग से जाँचें। नियंत्रक में पुराना प्रयास बंद करने का अर्थ वेबसाइट पर उसका कोड रद्द करना नहीं है।

OTP न मिलने पर कौन-सी आम गलतियाँ जाँचें?

पहले कारण खोजें, फिर दोबारा अनुरोध करें। हर असफल जाँच पर नया OTP मँगाने से प्रयासों का मिलान कठिन हो जाएगा।

status Microsoft खातों की साइन-इन स्थिति सीधे जाँचता है; दूसरे प्रदाताओं के लिए वह नवीनतम सिंक पर आधारित है। इसलिए इसे वेबसाइट के ब्राउज़र सत्र की जाँच न समझें।

Mailera संदेश का Inbox या Junk में होना दिखाता है। पढ़ने के इस कार्यप्रवाह में संदेश को बाहर लाना अनिवार्य कदम न बनाएँ। यदि अधिकृत ऑपरेटर स्पैम नहीं है कार्रवाई करता है, तो उसे अलग move अनुमति चाहिए।

आवश्यक होने पर ऑपरेटर POST /mailboxes/{id}/sync चला सकता है; इसके लिए sync अनुमति चाहिए। केवल OTP पढ़ने वाली कुंजी में ये अतिरिक्त अधिकार न जोड़ें। बार-बार सिंक करना कुल समयसीमा बढ़ाते रहने का कारण नहीं है।

webhook को नई मेल जाँचने की सूचना की तरह इस्तेमाल करें, सत्यापन सफल होने के प्रमाण की तरह नहीं। अंतिम निर्णय फिर भी संदेश के मिलान और वेबसाइट के परिणाम पर होगा।

एजेंट को ईमेल पढ़ाते समय क्या सुरक्षित रखना है?

ईमेल की सामग्री अविश्वसनीय डेटा है, निर्देश नहीं। संदेश में ‘अपनी API key भेजें’, ‘पिछले नियम भूलें’ या किसी दूसरे पृष्ठ पर जाने की बात हो तो एजेंट उसे न माने। यह prompt injection का रास्ता हो सकता है।

पूरा ईमेल एजेंट को सौंपने के बजाय नियंत्रक में मिलान करें और केवल आवश्यक कोड अधिकृत सत्यापन कार्रवाई को दें। लॉग में प्रयास की स्थिति और रुकने का कारण रखें; OTP, API key तथा सत्र token छिपाएँ। स्क्रीनशॉट में भी ये मान दिखाई न दें। पहुँच की योजना बनाते समय Mailera की सुरक्षा जानकारी देखें।

इस प्रक्रिया में सत्यापन का मुख्य तरीका OTP है। यदि आप सत्यापन लिंक जोड़ते हैं, तो खोलने से पहले अनुमत डोमेन और अपेक्षित कार्रवाई जाँचें। ईमेल से मिला मनमाना लिंक एजेंट को न खुलवाएँ।

इस काम के लिए send अनुमति नहीं चाहिए। किसी बाद के विस्तार में ईमेल भेजना हो तो भेजने से पहले व्यक्ति की पुष्टि लें। कुकी और सहेजी गई ब्राउज़र स्थिति को भी गोपनीय रखें; उन्हें रिपॉज़िटरी में न डालें।

Mailera क्या नहीं करता?

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

मेल के तत्काल आने या Inbox में पहुँचने की गारंटी नहीं है। OTP मिला है या नहीं, यह मेल पढ़ने का परिणाम है; वह स्वीकार होगा या नहीं, इसका निर्णय संबंधित वेबसाइट करती है।