Gmail से OTP कैसे निकालें: अपने ऐप का API से परीक्षण

Gmail API और Mailera के OTP API में क्या अंतर है?

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

Google का Gmail API scopes दस्तावेज़ बताता है कि ऐप को कितने दायरे की पहुँच मिलेगी। उसके users.messages.list संदर्भ के अनुसार सूची में संदेश के केवल id और threadId आते हैं; अतिरिक्त विवरण messages.get से मिलता है। सूची माँगना अपने आप OTP निकालना नहीं है।

जुड़े मेलबॉक्स से सामान्य संदेश पढ़ने के लिए GET /mailboxes/{id}/messages या सीधे नवीनतम कोड के लिए GET /mailboxes/{id}/otp इस्तेमाल करें। कनेक्शन की ज़रूरतें Gmail प्रदाता पेज पर हैं। दूसरे मेलबॉक्स के लिए यही काम करना हो तो अपने इनबॉक्स से OTP पढ़ने की सामान्य गाइड देखें।

परीक्षण वाला Gmail मेलबॉक्स कैसे जोड़ें?

पहले ऐसा Gmail खाता चुनें जो आपका हो और परीक्षण के लिए रखा गया हो। उसे अलग Mailera समूह में रखें, ताकि बाद में API कुंजी को केवल उसी समूह तक पहुँच दी जा सके।

1. Google खाते की तैयारी करें। ऐप पासवर्ड (app password) के लिए दो-चरणीय सत्यापन चालू होना चाहिए। Google के ऐप पासवर्ड निर्देश देखें। केवल security keys वाला दो-चरणीय सत्यापन, संगठन का खाता या Advanced Protection होने पर यह विकल्प नहीं दिख सकता। संगठन के खाते में दो-चरणीय सत्यापन चालू नहीं कर पा रहे हों तो Google के निर्देशों के अनुसार व्यवस्थापक से सहायता लें।
2. मेलबॉक्स जोड़ने का फ़ॉर्म खोलें। Admin या Leader भूमिका से मेलबॉक्स → मेलबॉक्स जोड़ें खोलें और एक मेलबॉक्स टैब चुनें। ईमेल पता में अपना परीक्षण पता भरें। Mailera प्रदाता को अपने-आप पहचानता है; न पहचाने जाने पर या प्रदाता चुनें से Gmail चुनें। इसके बाद जारी रखें दबाएँ।
3. ऐप पासवर्ड दर्ज करें। कनेक्शन विवरण के पासवर्ड फ़ील्ड में सामान्य Google पासवर्ड नहीं, ऐप पासवर्ड दें। मेलबॉक्स समूह में परीक्षण वाला समूह चुनें और जाँचें और कनेक्ट करें दबाएँ। यह कनेक्शन की जाँच है; इससे कोई ईमेल नहीं भेजा जाता।
4. पहली लोडिंग की पुष्टि करें। सफल कनेक्शन के बाद Mailera अपनी संदेश-संग्रह अवधि के भीतर के संदेश नए से पुराने क्रम में लोड करता है। अपने ऐप से परीक्षण ईमेल भेजें और एकीकृत इनबॉक्स में उसके दिखने का इंतज़ार करें।

यदि प्राप्ति की जाँच सफल है लेकिन भेजने की जाँच विफल होती है, तो Mailera केवल प्राप्ति मोड में सहेजें का विकल्प देता है। इस गाइड के लिए यह पर्याप्त है, क्योंकि आपको अपने ऐप का भेजा हुआ मेल पढ़ना है, Mailera से सत्यापन ईमेल भेजना नहीं।

Google किसी ऐप में उपलब्ध होने पर “Sign in with Google” इस्तेमाल करने की सलाह देता है। Mailera में Gmail को इस तरह जोड़ने के लिए ऐप पासवर्ड लगता है। अलग-अलग प्रदाताओं का अंतर एजेंट मेलबॉक्स के ऐप पासवर्ड वाली गाइड में देखें। इसे Outlook पर लागू न करें: Outlook के लिए OAuth वाला मार्ग अलग है।

API से सही मेलबॉक्स का सत्यापन कोड कैसे लें?

1. परीक्षण समूह तक सीमित कुंजी बनाएँ

सेटिंग्स में API key टैब खोलें और API key बनाएँ चुनें। पहचानने योग्य नाम दें, मेलबॉक्स का दायरा केवल परीक्षण समूह तक रखें और read अनुमति चुनें। पढ़ने के इस काम के लिए send, move या manage न जोड़ें।

कुंजी केवल एक बार दिखाई जाती है: API key बन गई — अभी कॉपी करें। उसे सुरक्षित पर्यावरण चर $MAILERA_API_KEY में रखें, साझा नोट या स्रोत कोड में नहीं। API के उपयोग का परिचय डेवलपर पेज पर और endpoint संदर्भ API दस्तावेज़ों में है।

2. मेलबॉक्स की पहचान करें

यह अनुरोध उस कुंजी के दायरे में उपलब्ध मेलबॉक्स की सूची माँगता है:

curl --get 'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY"

उत्तर की data सूची में अपने परीक्षण पते का email पहचानें और उसी प्रविष्टि का id पर्यावरण चर $MAILBOX_ID में रखें। पहली प्रविष्टि को बिना पता देखे न चुनें। सूची का last_sync_at आगे सिंक की जाँच में भी काम आएगा।

3. अपने ऐप से नया सत्यापन ईमेल भेजें

उसी परीक्षण पते पर नया कोड माँगें और अनुरोध का समय दर्ज करें। पहली जाँच में एक समय पर एक ही सत्यापन प्रक्रिया चलाएँ। इससे एक ही प्रेषक और विषय वाले कई संदेशों के बीच भ्रम कम होगा।

4. OTP अनुरोध में फ़िल्टर दें

नीचे verify@example.com और Test verification उदाहरण हैं। इन्हें अपने परीक्षण ऐप के वास्तविक प्रेषक और विषय से बदलें। since_minutes=5 इस उदाहरण की खोज अवधि है, कोई डिफ़ॉल्ट या OTP की वैधता अवधि नहीं।

curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/otp" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verify@example.com' \
  --data-urlencode 'subject=Test verification' \
  --data-urlencode 'since_minutes=5'

--data-urlencode से विषय में मौजूद खाली जगहों जैसे अक्षरों को URL पैरामीटर में भेजा जा सकता है। तीनों फ़िल्टर अलग गलतियों को कम करने के लिए हैं:

कोड मिलने के बाद उसे अपने परीक्षण ऐप की उसी सत्यापन प्रक्रिया में दें। परीक्षण तभी सफल मानें जब ऐप उसे स्वीकार करे। नवीनतम कोड मिल जाना पर्याप्त नहीं: सही सत्र और कोड की समाप्ति की जाँच जारी करने वाले ऐप को करनी है।

आम गलतियाँ: OTP नहीं मिल रहा या पुराना मिल रहा है?

पहले पता करें कि संदेश Gmail तक नहीं पहुँचा, Mailera में अभी सिंक नहीं हुआ, या आपका अनुरोध गलत संदेश खोज रहा है। हर स्थिति में नया OTP माँगते रहना जाँच को और उलझा सकता है।

स्थिति के लिए GET /mailboxes/{id}/status उपलब्ध है। Gmail के मामले में यह नवीनतम सिंक पर आधारित है, उसी क्षण किया गया सीधा Google साइन-इन परीक्षण नहीं। इसलिए इसे last_sync_at के साथ पढ़ें।

संदेश का स्थान जाँचने के लिए OTP अनुरोध वाले फ़िल्टर ही इस्तेमाल कर सकते हैं:

curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/placement" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verify@example.com' \
  --data-urlencode 'subject=Test verification' \
  --data-urlencode 'since_minutes=5'

Spam में संदेश मिले तो केवल परीक्षण आगे बढ़ाने के इरादे से उसे Inbox में स्थानांतरित न करें, क्योंकि इससे असली placement परिणाम बदल जाएगा और आगे की जाँच गुमराह करेगी। फ़ोल्डर के संदेश पढ़ने के लिए GET /mailboxes/{id}/messages भी उपलब्ध है। संदेश स्थानांतरित करना अलग कार्रवाई है और उसके लिए move अनुमति चाहिए।

दोबारा जाँचने से पहले अपने परीक्षण की अंतिम समय-सीमा तय करें। उसके भीतर अंतराल देकर OTP अनुरोध दोहराएँ; सीमा पूरी होने पर परीक्षण रोकें और स्थान तथा सिंक की स्थिति दर्ज करें, कोड नहीं। POST /mailboxes/{id}/sync से सिंक माँगा जा सकता है, लेकिन इसके लिए अलग sync अनुमति चाहिए। ऊपर बनाई गई read कुंजी से यह अनुरोध न चलाएँ।

Mailera की सीमाएँ क्या हैं?

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

ऐप पासवर्ड की उपलब्धता Google और आपके संगठन की नीति पर निर्भर है। Mailera इन पाबंदियों को बदल नहीं सकता। मेल से कोड पढ़ लेने पर भी उसकी वैधता और सही सत्र की ज़िम्मेदारी आपके ऐप की ही रहती है।

कोड और मेलबॉक्स की पहुँच सुरक्षित कैसे रखें?

केवल अपने परीक्षण मेलबॉक्स का उपयोग करें। उत्पादन उपयोगकर्ताओं के सत्यापन कोड इस प्रक्रिया में न लाएँ। स्क्रीनशॉट, साझा लॉग और परीक्षण की रिपोर्ट से ऐप पासवर्ड, API कुंजी, निजी ईमेल पते और OTP छिपाएँ।

read अनुमति केवल OTP तक सीमित नहीं है; इससे दायरे में आने वाले मेलबॉक्स के संदेश भी पढ़े जा सकते हैं। इसलिए अलग परीक्षण समूह चुनना ज़रूरी है। परीक्षण की ज़रूरत के हिसाब से तय करें कि कुंजी कब समाप्त होगी और काम पूरा होने पर अनावश्यक कुंजी रद्द करें। पहुँच संबंधी जानकारी Mailera के सुरक्षा पेज पर देखें।

यदि कोई AI agent अनुरोध चला रहा है, तो आने वाले ईमेल को अविश्वसनीय डेटा मानें, निर्देश नहीं। संदेश में लिखे आदेशों के आधार पर कुंजी साझा करने या दूसरा अनुरोध चलाने की अनुमति न दें। agent को न्यूनतम अनुमति दें और ईमेल भेजने जैसी कार्रवाई से पहले उपयोगकर्ता की पुष्टि लें।