Verify का अवलोकन
Bird Verify पुष्टि करता है कि कोई उपयोगकर्ता किसी ईमेल पते या फ़ोन नंबर को नियंत्रित करता है। Bird से एक बार इस्तेमाल होने वाला सत्यापन कोड भेजने को कहें, उसे अपने ऐप में लें, और Bird से पूछें कि वह मेल खाता है या नहीं। यह फ़्लो दो API कॉल इस्तेमाल करता है: POST /v1/verify/verifications कोड भेजता है, और POST /v1/verify/verifications/check उसे जाँचता है। Bird के साझा सेंडर के लिए सेंडर रजिस्ट्रेशन या टेम्पलेट सेटअप की ज़रूरत नहीं होती। ईमेल, SMS और WhatsApp डिफ़ॉल्ट रूप से Bird Verify, Authifly या आपके वर्कस्पेस का अपना सेंडर इस्तेमाल कर सकते हैं; Telegram अपने सत्यापित नोटिफ़िकेशन खाते का उपयोग करता है। यह चुनाव सेंडर और ब्रांडिंग में समझाया गया है।
सत्यापन कैसे काम करता है
आप एक प्राप्तकर्ता के साथ सत्यापन बनाते हैं: ईमेल पता, फ़ोन नंबर, या दोनों। Bird एक संख्यात्मक सत्यापन कोड बनाता है और उसे प्राप्तकर्ता के चैनलों पर पहुँचाता है। ईमेल पते पर कोड ईमेल से जाता है; फ़ोन नंबर पर वह SMS या WhatsApp से जाता है, उस क्रम और उपलब्धता के अनुसार जो आपका देश कॉन्फ़िगरेशन गंतव्य देश के लिए तय करता है। उपयोगकर्ता आपके ऐप में कोड टाइप करता है, और आप उसे चेक एंडपॉइंट पर भेजते हैं, जो कारण के साथ success: true या false जवाब देता है।
हर सत्यापन एक छोटे जीवनचक्र से गुज़रता है: वह pending से शुरू होता है, और verified (सही कोड समय पर आया), failed (बहुत ज़्यादा गलत प्रयास) या expired (समय सीमा बीत गई) पर खत्म होता है। सत्यापन पेज हर सत्यापन और उसकी स्थिति दिखाता है; हर स्थिति और कारण सत्यापन भेजना में समझाया गया है।
डैशबोर्ड में Verify ऐप
डैशबोर्ड में Verify वर्कस्पेस के ऐप्स में से एक है। इसके पेज, और हर पेज की गाइड कहाँ है:
| पेज | यह किसलिए है |
|---|---|
| सत्यापन | आपके वर्कस्पेस में बनाया गया हर सत्यापन, उसकी स्थिति, प्राप्तकर्ता, चैनल और समय के साथ; देखें सत्यापन भेजना |
| देश | हर देश के लिए डिलीवरी: कौन-से चैनल इस्तेमाल होते हैं, किस क्रम में, और कोई देश सक्षम है या नहीं; देखें देश कॉन्फ़िगरेशन |
| कॉन्फ़िगर करें | कोड की वैधता अवधि, प्रयास सीमाएँ, दोबारा भेजने का कूलडाउन, और हर चैनल का सेंडर; देखें सत्यापन भेजना और सेंडर और ब्रांडिंग |
दृश्यता
सत्यापन पेज वर्कस्पेस के हर सत्यापन की सूची दिखाता है, और हर सत्यापन के प्राप्तकर्ता, चैनल योजना और समय का विवरण खोलता है। प्रोग्राम के ज़रिए, चेक प्रतिक्रिया में सत्यापन की मौजूदा स्थिति होती है। सत्यापन बनने, डिलीवरी और सफल सत्यापन की सूचनाएँ पाने के लिए Verify इवेंट की सदस्यता लें। सूची और पढ़ने वाले एंडपॉइंट डैशबोर्ड के लिए उपलब्ध हैं, लेकिन सार्वजनिक API में नहीं।
चैनल
Verify चार चैनलों से कोड भेजता है। किसी प्राप्तकर्ता को कौन-सा चैनल मिलेगा, यह प्राप्तकर्ता के प्रकार पर और फ़ोन नंबरों के लिए आपके देश कॉन्फ़िगरेशन पर निर्भर करता है।
| चैनल | प्राप्तकर्ता | डिलीवरी कैसे होती है |
|---|---|---|
| ईमेल | ईमेल पता | Bird Verify या Authifly के साझा पते से भेजा जाता है; आप इसे कभी भी अपने सत्यापित भेजने वाले डोमेन पर सेट कर सकते हैं |
| SMS | फ़ोन नंबर | Bird द्वारा प्रबंधित सेंडर या आपके Sender ID से डिलीवर किया जाता है, गंतव्य के सेंडर नियमों के अधीन |
| फ़ोन नंबर | Bird द्वारा प्रबंधित नंबर या स्वीकृत ऑथेंटिकेशन टेम्पलेट वाले आपके कनेक्ट किए गए नंबर से भेजा जाता है | |
| Telegram | फ़ोन नंबर | Telegram Gateway द्वारा, उसके अपने सत्यापित नोटिफ़िकेशन अकाउंट से, Telegram पर रजिस्टर्ड नंबर पर डिलीवर किया जाता है |
फ़ोन प्राप्तकर्ता के लिए ज़्यादातर देशों में पहले WhatsApp आज़माया जाता है और SMS विकल्प के रूप में काम करता है, हालाँकि कुछ देशों में डिफ़ॉल्ट रूप से पहले SMS आता है। प्लेटफ़ॉर्म के फ़ॉलबैक क्रम में Telegram, SMS के बाद और ईमेल से पहले आता है। आप हर देश के लिए क्रम बदल सकते हैं या कोई चैनल बंद कर सकते हैं। अगर भेजना विफल होता है, तो डिलीवरी योजना के अगले चैनल पर चली जाती है। जब कोई उपयोगकर्ता बताए कि कोड नहीं पहुँचा, तब आप भी डिलीवरी को अगले चैनल पर ले जा सकते हैं; देखें कोड किसी दूसरे चैनल पर भेजें। सेंडर और ब्रांडिंग में हर संदेश और उपलब्ध सेंडर नियंत्रण दिखाए गए हैं।
डिफ़ॉल्ट और सीमाएँ
आपका वर्कस्पेस कोड (लंबाई, वैधता अवधि), जाँच की प्रयास सीमा और दोबारा भेजने के कूलडाउन के लिए Bird के प्लेटफ़ॉर्म डिफ़ॉल्ट से शुरू होता है। इनमें से हर एक को डैशबोर्ड में Configure के अंतर्गत बदला जा सकता है, और कोड की लंबाई को हर अनुरोध में भी; मान और सीमाएँ सत्यापन सेटिंग्स में दी गई हैं। इनके ऊपर दुरुपयोग से बचाव के ऐसे नियम लागू होते हैं जिन्हें आप कॉन्फ़िगर नहीं करते: प्रति प्राप्तकर्ता भेजने और जाँचने की सीमाएँ, जो दुरुपयोग से बचाव में दी गई हैं। कोड वाला संदेश डिफ़ॉल्ट रूप से प्राप्तकर्ता के फ़ोन नंबर की भाषा में होता है, जो 40 अंतर्निहित अनुवादों में से एक है, और options.language हर अनुरोध में इसे बदल देता है। देखें संदेश की भाषा।
आगे क्या करें
| पेज | इसमें क्या है |
|---|---|
| सत्यापन भेजना | भेजने और जाँचने वाले कॉल, स्थितियाँ, सेटिंग्स और सीमाएँ |
| देश कॉन्फ़िगरेशन | देशों को सक्षम करना और हर देश के लिए चैनल क्रम और सेंडर सेट करना |
| सेंडर और ब्रांडिंग | कोड वाले संदेश कैसे दिखते हैं और अपने डोमेन से कैसे भेजें |
| इवेंट | सत्यापन का जीवनचक्र और डिलीवरी इवेंट, और उनके वेबहुक पेलोड |
| प्रमाणीकरण | API कुंजियाँ और क्षेत्रीय होस्ट |
| API संदर्भ: सत्यापन बनाएँ | भेजने वाले एंडपॉइंट का स्कीमा और त्रुटियों का विवरण |
| API संदर्भ: कोड जाँचें | जाँच एंडपॉइंट का स्कीमा और त्रुटियों का विवरण |
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।