Verify लॉग
Verify log, जो Verify > Verifications के अंतर्गत Verifications पेज पर दिखता है, आपके वर्कस्पेस के हर सत्यापन सत्र का रिकॉर्ड है। सबसे नए सत्यापन सबसे ऊपर दिखते हैं। इसका उपयोग यह पुष्टि करने के लिए करें कि सत्यापन बनाया गया, हर चैनल प्रयास और जाँच को देखने के लिए, और रूपांतरण का समय तथा प्रति प्रयास लागत जाँचने के लिए। जनरेट किया गया एक बार का सत्यापन कोड कभी भी सादे टेक्स्ट में संग्रहीत नहीं होता और डैशबोर्ड में नहीं दिखाया जाता।
सत्यापन सूची
हर पंक्ति एक सत्यापन सत्र है। कॉलम ये हैं:
| कॉलम | क्या दिखाता है |
|---|---|
| Status | सत्र की मौजूदा स्थिति (Pending, Converted, Failed, Expired, Canceled या Blocked; स्थितियाँ देखें) |
| Verification | सत्यापन ID (vrf_...) |
| Recipient | वह फ़ोन नंबर या ईमेल पता जिसका सत्यापन किया जा रहा है |
| Channel | नवीनतम प्रयास के लिए इस्तेमाल किया गया डिलीवरी चैनल (Email, SMS, WhatsApp, Telegram या Voice) |
| Cost | सत्र के सभी डिलीवरी प्रयासों पर लगाई गई कुल राशि |
| Created | सत्यापन कब बनाया गया |
सूची के हर पेज पर 25 सत्यापन दिखते हैं।
खोजना और फ़िल्टर करना
पेज पर वॉल्यूम टाइमलाइन के ऊपर प्राप्तकर्ता खोज और तीन फ़िल्टर हैं। सूची को सीमित करने के लिए आप फ़िल्टरों को एक साथ लागू कर सकते हैं:
- Search by phone number: E.164 फ़ॉर्मैट में प्राप्तकर्ता का सटीक फ़ोन नंबर खोजें, जैसे
+14155550100। - Status: Pending, Converted (
verified), Failed या Expired के अनुसार फ़िल्टर करें। - Channel: डिलीवरी चैनल के अनुसार फ़िल्टर करें (
Email,SMS,WhatsApp,TelegramयाVoice)। - Date range: कोई पहले से तय अवधि चुनें, या कैलेंडर या टाइमलाइन पट्टी से अपनी पसंद की अवधि चुनें।
जब कोई भी सत्यापन सक्रिय फ़िल्टरों से मेल नहीं खाता, तो दृश्य को रीसेट करने के लिए Clear filters का उपयोग करें।
स्थितियाँ
हर सत्यापन Pending (pending) स्थिति से शुरू होता है और एक बार किसी अंतिम स्थिति में पहुँचता है:
| डैशबोर्ड लेबल | API status | अर्थ |
|---|---|---|
| Pending | pending | सत्यापन सक्रिय है और expires_at से पहले मेल खाने वाले सत्यापन कोड की जाँच की प्रतीक्षा कर रहा है |
| Converted | verified | समय सीमा समाप्त होने से पहले एक जाँच कॉल ने मेल खाने वाला कोड दिया |
| Failed | failed | सत्र ने जाँच के अपने सभी अनुमत प्रयास (attempts_exhausted) खत्म कर दिए, या हर चैनल पर डिलीवरी विफल रही |
| Expired | expired | सफल जाँच या प्रयास खत्म होने से पहले ही कोड की वैधता अवधि (ttl_elapsed) बीत गई |
| Canceled | canceled | सत्र पूरा होने से पहले रद्द कर दिया गया |
| Blocked | blocked | किसी सुरक्षा या नीति जाँच ने सत्यापन को रोक दिया |
स्थिति में बदलाव और अंतिम कारण दोबारा भेजने और चैनल फ़ॉलबैक के साथ कैसे काम करते हैं, यह जानने के लिए सत्यापन भेजना देखें।
किसी सत्यापन की जाँच करना
सत्यापन का विवरण पैनल खोलने के लिए कोई भी पंक्ति चुनें। यह सत्र को तीन खंडों में बाँटता है:
सारांश
सारांश हेडर सत्र का परिणाम और कॉन्फ़िगरेशन दर्ज करता है:
- Outcome: पूरे हुए सत्र के लिए, पूरा होने में लगा समय (
Converted in) और यह कि कौन-सा जाँच प्रयास मेल खाया (उदाहरण के लिए,Code matched on 1st check)। विफल सत्र के लिए, विफल जाँचों की संख्या। - Code: सत्र के लिए कॉन्फ़िगर की गई अंकों की लंबाई और समाप्ति अवधि।
- Channels used: वे सभी चैनल जिन्होंने सत्र के दौरान डिलीवरी का प्रयास किया।
- Metadata: सत्यापन बनाते समय
metadataमें भेजे गए सभी कुंजी-मान युग्म।
जीवनचक्र टाइमलाइन
टाइमलाइन सत्र के हर चरण को बनने से लेकर समाधान तक क्रम से दिखाती है:
- Channel attempts: सत्यापन कोड का हर प्रेषण (
SMS,WhatsApp,Telegram,VoiceयाEmail), उसका प्रेषक, उसकी डिलीवरी का परिणाम (sent,deliveredया त्रुटि के कारण सहितundelivered), डिलीवरी में लगा समय और प्रति प्रयास लागत। जब तक सत्र लंबित रहता है, नियोजित फ़ॉलबैक चैनल जो अभी तक सक्रिय नहीं हुए हैं, आगामी चरणों के रूप में दिखते हैं। - Code checks: हर
POST /v1/verify/verifications/checkकॉल और यह कि कोड मेल खाया या नहीं। - Terminal state: सत्र अपनी अंतिम स्थिति में कब पहुँचा।
लागत विवरण
जब किसी सत्र में शुल्क वाले प्रयास होते हैं, तो Cost breakdown शुल्कों को चैनल और प्रेषक वर्ग (Shared sender, Custom domain, Dedicated sender या Managed sender) के अनुसार समूहित करता है और साथ में आपके वर्कस्पेस की मुद्रा में सत्र का Total दिखाता है।
सत्यापन सूची और विवरण दृश्य केवल डैशबोर्ड में उपलब्ध हैं, और इनके लिए कोई सार्वजनिक सूची या पठन API एंडपॉइंट नहीं है। सत्यापन बनने, प्रति प्रयास डिलीवरी और रूपांतरण को प्रोग्राम के ज़रिए ट्रैक करने के लिए सिंक्रोनस जाँच प्रतिक्रिया का उपयोग करें और Verify इवेंट की सदस्यता लें।
अगले चरण
- Verify इवेंट:
verify.verification.*औरverify.attempt.*इवेंट के लिए वेबहुक डिलीवरी प्राप्त करें। - सत्यापन भेजना: कोड की वैधता अवधि, प्रयास सीमाएँ, दोबारा भेजना और मल्टी-चैनल फ़ॉलबैक कॉन्फ़िगर करें।
- Verify गंतव्य: गंतव्य देशों को सक्षम करें और चैनल फ़ॉलबैक का क्रम अपनी ज़रूरत के अनुसार तय करें।
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।