वेरिफ़िकेशन मोटे तौर पर बीच से बँटा हुआ है। डेवलपर टूल और SaaS ज़्यादातर ईमेल कोड भेजते हैं। जो कुछ भी पैसे, पहचान या फ़ोन-आधारित अकाउंट से जुड़ा है, वह SMS भेजता है। जो एजेंट इनमें से सिर्फ़ एक कर सकता है, वह आधे इंटरनेट पर अटक जाता है।
आम जवाब है दो वेंडर: एक ईमेल API और एक SMS API। यानी दो ऑथ मॉडल, दो रिस्पॉन्स स्वरूप, दो पोलिंग रणनीतियाँ, दो विफलता के तरीके, और ढेर सारा ग्लू कोड जिसका इकलौता काम है उन्हें एजेंट के सामने एक जैसा दिखाना। ग्लू ही समस्या है — यह वह हिस्सा है जिसकी ज़िम्मेदारी कोई नहीं लेना चाहता और जिसे हर किसी को लिखना पड़ता है।
वही स्वरूप, दोनों चैनल
apumail दोनों को एक ही लेयर से चलाता है। ईमेल फ़्लो:
# provision an inbox — no auth
INBOX=$(curl -sS -X POST https://api.apumail.com/api/v1/inboxes)
ADDR=$(echo "$INBOX" | jq -r .address)
TOK=$(echo "$INBOX" | jq -r .token)
# block until it lands, read the extracted code
curl -sS -H "Authorization: Bearer $TOK" \
"https://api.apumail.com/api/v1/inbox/$ADDR/wait?timeout=120" \
| jq -r '.messages[0].otp'और SMS फ़्लो:
# buy a real dedicated number, on demand
PHONE=$(curl -sS -X POST https://api.apumail.com/api/v1/phones \
-H "Authorization: Bearer $TOK" \
-d '{"country_code":"US"}')
# same wait, same extract, different channelप्रोविज़न, इंतज़ार, एक्सट्रैक्ट। वही क्रियाएँ, वही ऑथ, वही JSON। MCP में यह समरूपता शाब्दिक है —
wait_for_mail / extract_latest_otp के ठीक बगल में
wait_for_sms / extract_latest_sms_otp। जिस एजेंट ने एक सीख लिया,
उसने दूसरा भी सीख लिया।
ऑन-डिमांड नंबर
दूसरी जगहों पर एजेंटों के लिए SMS को जो चीज़ अटपटा बनाती है, वह है नंबर हासिल करना। ज़्यादातर फ़्लो
मानकर चलते हैं कि सामने इंसान है: पूल से नंबर चुनो, उपलब्धता का इंतज़ार करो, नए क्षेत्र के लिए सपोर्ट को
ईमेल करो। country_code के साथ एक POST /api/v1/phones वहीं उसी पल एक असली
डेडिकेटेड नंबर ख़रीद लेता है — किसी पूल का इंतज़ार नहीं, किसी इंसान को ईमेल नहीं। जब तक उसका भुगतान होता
है, वह एजेंट का अपना नंबर है, कोई साझा नंबर नहीं जिस पर किसी और का कोड आ जाए।
यही ईमानदार समझौता भी है: यह पेड टियर है। US/CA में एक नंबर $20/वर्ष से शुरू होता है, क़ीमत देश के हिसाब से ($PROWL में $16), और भेजने की लागत प्रीपेड क्रेडिट से $0.07/SMS है। ईमेल इनबॉक्स मुफ़्त हैं; फ़ोन नंबरों में पैसा लगता है क्योंकि कैरियर पैसा लेते हैं। अगर आपको सिर्फ़ ईमेल कोड चाहिए, तो आप इसे कभी नहीं छूते और कभी भुगतान नहीं करते।
सिर्फ़ प्राप्त करना नहीं, भेजना भी
दोनों चैनल दो-तरफ़ा हैं, जो जितना लगता है उससे ज़्यादा मायने रखता है। वेरिफ़िकेशन हमेशा एक कोड नहीं
होता — कभी-कभी यह जवाब देकर पुष्टि करना होता है, और कभी-कभी जिस फ़्लो को आप ऑटोमेट कर रहे हैं वह कोड
के बाद भी उसी चैनल पर जारी रहता है। जो एजेंट सिर्फ़ प्राप्त कर सकता है, उसे पहले जवाब पर ही इंसान को
सौंपना पड़ता है। send_mail और send_sms उसे लूप में बनाए रखते हैं, और
from एजेंट के अपने पते या नंबर पर लॉक रहता है ताकि लीक हुए टोकन से किसी का रूप न धरा जा सके।
इसका निष्कर्ष
जो समस्या आमतौर पर दो की होती है, उसके लिए एक वेंडर होना अपने आप में कोई गुण नहीं — यह तब गुण है जब दोनों हिस्से सच में एक ही स्वरूप साझा करते हों, और यहाँ वे करते हैं। ईमेल फ़्लो से शुरू करें, जो मुफ़्त है और बस एक POST लेता है। जब कोई फ़्लो नंबर माँगे, तब नंबर जोड़ें।