WhatsApp पर पुष्टि कोड (OTP) भेजें
WhatsApp पर पुष्टि कोड (OTP) भेजने के लिए कारोबार एक ऑथेंटिकेशन टेम्पलेट बनाता है, जो Meta का तय फ़ॉर्मैट है: "<code> is your verification code." इसमें कॉपी-कोड या वन-टैप बटन होता है, और उसका बैकएंड इसे Cloud API के ज़रिए भेजता है, जिसमें कोड बॉडी और बटन दोनों में दो बार भरा जाता है। कोड 15 अक्षरों तक लंबे हो सकते हैं, और वैकल्पिक एक्सपायरी चेतावनी 1 से 90 मिनट तक चलती है।
easyCoexistence आपके WhatsApp Business नंबर को Coexistence के ज़रिए Meta के Cloud API से जोड़ता है, और आपके बैकएंड को ऑथेंटिकेशन टेम्पलेट भेजने के लिए जो चाहिए वह देता है: Send एंडपॉइंट, एक्सेस टोकन और, आपके AI के ज़रिए, create_template और get_template_status।
ऑथेंटिकेशन टेम्पलेट द्वारा स्वीकार किया जाने वाला सबसे लंबा पैरामीटर; इसके कंटेंट या पैरामीटर में यूआरएल, मीडिया और इमोजी की अनुमति नहीं है।
code_expiration_minutes की सीमा, जो संदेश में यह पंक्ति जोड़ती है: "This code expires in N minutes."
ऑथेंटिकेशन टेम्पलेट का डिफ़ॉल्ट टाइम-टू-लाइव (TTL); इसे 30 सेकंड से 15 मिनट तक सेट किया जा सकता है।
जब ऑथेंटिकेशन टेम्पलेट किसी फ़ोन नंबर के बजाय बिज़नेस-स्कोप्ड यूज़र ID पर भेजा जाता है, तब लौटने वाली गड़बड़ी।
ऑथेंटिकेशन संदेश केवल यूज़र के मुख्य WhatsApp डिवाइस पर पहुँचते हैं; लिंक्ड डिवाइस पर उनके बजाय एक प्रॉम्प्ट दिखता है।
Coexistence नंबर का तय थ्रूपुट, यानी लॉगिन कोड के अचानक आने वाले बर्स्ट की सीमा।
WhatsApp ऑथेंटिकेशन टेम्पलेट क्या है?
वन-टाइम पासवर्ड और पुष्टि कोड के लिए Meta का एकमात्र अनुमत फ़ॉर्मैट: अगर कोई ऐप WhatsApp से कोड देता है, तो उसे यही इस्तेमाल करना होगा, और यूटिलिटी या मार्केटिंग टेम्पलेट में पासकोड नहीं हो सकता। टेक्स्ट तय है, "<code> is your verification code.", जिसमें दो वैकल्पिक पंक्तियाँ हो सकती हैं: "For your security, do not share this code." और "This code expires in <N> minutes." बटन आप चुनते हैं। WhatsApp इन संदेशों को फ़ॉरवर्ड करने से रोकता है, और iOS 26 और उसके बाद के वर्ज़न पर कोड कीबोर्ड सुझाव के रूप में भी दिखता है, जिसके लिए आपको कुछ नहीं करना होता।
ऑथेंटिकेशन टेम्पलेट कैसे बनाएँ?
इसे WhatsApp Manager में Template Library से चुनें, या API के ज़रिए सबमिट करें, जो आपका AI create_template और कैटेगरी AUTHENTICATION के साथ कर सकता है। आप बॉडी टेक्स्ट नहीं भेजते: Meta आपकी सेटिंग से, आपकी चुनी भाषा में टेक्स्ट लिखता है, और बनाते समय OTP बटन को यूआरएल बटन में बदल देता है। हर भाषा के लिए एक टेम्पलेट। कनेक्टर का create_template message_send_ttl_seconds पास नहीं करता, इसलिए जब तक आप Meta के API से इसे नहीं बदलते, 10 मिनट का डिफ़ॉल्ट टाइम-टू-लाइव लागू रहता है।
{
"connection_id": "<from list_numbers>",
"name": "login_code",
"language": "en_US",
"category": "AUTHENTICATION",
"components": [
{ "type": "BODY", "add_security_recommendation": true },
{ "type": "FOOTER", "code_expiration_minutes": 5 },
{ "type": "BUTTONS", "buttons": [
{ "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
]}
]
}आपका बैकएंड कोड कैसे भेजता है?
हर कोड के लिए नंबर के /messages एंडपॉइंट पर एक अनुरोध, get_api_credentials से मिले एक्सेस टोकन या डैशबोर्ड के "Plug in your own system" कार्ड के साथ। वही कोड दो बार जाता है: बॉडी पैरामीटर में और इंडेक्स 0 पर यूआरएल बटन पैरामीटर में, और प्राप्तकर्ता एक फ़ोन नंबर होना चाहिए। भेजने से पहले बैकएंड कोड बनाता है, उसका हैश उसकी एक्सपायरी टाइम और एक प्रयास काउंटर के साथ स्टोर करता है, और बाद में यूज़र जो टाइप करता है उसे उसी हैश से मिलाता है।
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>
{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "template",
"template": {
"name": "login_code",
"language": { "code": "en_US" },
"components": [
{ "type": "body",
"parameters": [{ "type": "text", "text": "482913" }] },
{ "type": "button", "sub_type": "url", "index": "0",
"parameters": [{ "type": "text", "text": "482913" }] }
]
}
}कोड ऑटोमेशन से नहीं, बल्कि आपके बैकएंड से क्यों आता है?
क्योंकि जो सिस्टम यूज़र को लॉग इन करता है, उसी को कोड बनाना, याद रखना और जाँचना होता है, और केवल वही जानता है कि कोड कब चाहिए। ऑटोमेशन उन संदेशों का जवाब देते हैं जो ग्राहक भेजते हैं, और लॉगिन स्क्रीन कभी आपके नंबर पर नहीं लिखती। टेम्पलेट खुद भी इन्हें रोकता है: OTP बटन कोड को बटन वेरिएबल के रूप में रखता है, और "Send a template" स्टेप केवल बॉडी वेरिएबल भरता है, इसलिए वह ऑथेंटिकेशन टेम्पलेट नहीं भेज सकता। आपका AI send_template से एक भेज सकता है, जो बटन कंपोनेंट Meta को देता है, लेकिन वह टेस्ट के लिए है, लॉगिन फ़्लो के लिए नहीं।
WhatsApp OTP फ़्लो को सुरक्षित कैसे बनाएँ?
Meta की सर्वोत्तम प्रथाएँ और फ़ॉर्मैट की सीमाएँ एक ही चेकलिस्ट की ओर इशारा करती हैं। इसके लिए आपके बैकएंड और Cloud API के अलावा कुछ नहीं चाहिए:
- पहला कोड भेजने से पहले यूज़र के साथ WhatsApp नंबर की पुष्टि करें, और बताएँ कि कोड WhatsApp पर आएगा।
- टाइम-टू-लाइव को कोड की एक्सपायरी के बराबर या उससे कम रखें, ताकि देर से पहुँचा कोड कभी मृत कोड न दिखे।
- हर नंबर पर प्रयासों और दोबारा भेजने की संख्या सीमित करें, और पहली बार इस्तेमाल होते ही कोड की एक्सपायरी कर दें।
- खाते की रिकवरी के लिए WhatsApp कोड को अकेला फ़ैक्टर न बनाएँ: रीसाइकल हुए फ़ोन नंबर अब भी किसी पुराने WhatsApp खाते तक पहुँच सकते हैं।
- स्टेटस वेबहुक पर नज़र रखें, और जब कोई कोड डिलीवर न हो, तो SMS या ईमेल का विकल्प दें।
जब यही नंबर WhatsApp Business ऐप में भी चलता है, तो क्या बदलता है?
भेजना किसी भी Cloud API नंबर की तरह काम करता है, प्रति सेकंड 20 संदेश तक। Meta API से भेजे गए संदेश ऐप की चैट में भी दिखते हैं, इसलिए Coexistence नंबर पर भेजे गए कोड बिज़नेस फ़ोन की उन चैट में भी दिखते हैं; वह फ़ोन उन्हीं लोगों के पास रखें जिन पर आप भरोसा करते हैं, या कोड एक अलग नंबर से भेजें। Meta की सर्वोत्तम प्रथाएँ यह भी कहती हैं कि हर कारोबार ऑथेंटिकेशन टेम्पलेट अपने नंबर से भेजे, कभी ऐसे नंबर से नहीं जो कई कारोबारों में साझा हो। ऑथेंटिकेशन एक भुगतान वाली टेम्पलेट कैटेगरी है, जिसका बिल प्राप्तकर्ता के देश के अनुसार प्रति डिलीवर संदेश लगता है, और कुछ बाज़ारों में अलग authentication-international दरें होती हैं; easyCoexistence कोई मार्कअप नहीं जोड़ता।
कैसे कॉन्फ़िगर करें
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
- Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
- Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
- Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
- Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.
आम गड़बड़ियाँ
- "Your code is {{1}}" जैसे यूटिलिटी टेम्पलेट में कोड लिखना। Meta पासकोड केवल ऑथेंटिकेशन टेम्पलेट में अनुमति देता है, और यूटिलिटी या मार्केटिंग टेम्पलेट में पाए जाने पर उन्हें अस्वीकार कर देता है।
- कोड केवल बॉडी में भेजना। कॉपी-कोड बटन को उसके पैरामीटर में वही मान चाहिए; Meta अनुरोध में कोड दो बार देखना चाहता है।
- पुराने ऑथेंटिकेशन टेम्पलेट पर 30 दिन का टाइम-टू-लाइव रखना। एक घंटे तक ऑफ़लाइन रहे फ़ोन को एक्सपायर हो चुका कोड मिलता है; इसे कोड की एक्सपायरी के बराबर या उससे कम रखें।
- कोड किसी बिज़नेस-स्कोप्ड यूज़र ID पर भेजना। ऑथेंटिकेशन टेम्पलेट केवल फ़ोन नंबरों पर जाते हैं, और Meta गड़बड़ी 131062 लौटाता है।
नंबर 24/7 मॉनिटर होता है, इसलिए जो डिस्कनेक्शन लॉगिन कोड रोक सकता है, उसकी सूचना आपको ईमेल से मिलती है। प्रति नंबर प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे नंबर जुड़ते हैं वैसे-वैसे कम होकर, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या WhatsApp OTP, SMS कोड से सस्ता है?
Meta हर डिलीवर ऑथेंटिकेशन संदेश के लिए प्राप्तकर्ता के देश की दर लेता है, कुछ बाज़ारों में विशेष दरों के साथ, और SMS की कीमतें कैरियर और रूट के अनुसार बदलती हैं। स्विच करने से पहले अपने मुख्य देशों के लिए Meta के रेट कार्ड और अपने SMS प्रदाता की दरों की तुलना करें।
क्या यह WhatsApp की दो-चरणीय पुष्टि PIN जैसा है?
नहीं। दो-चरणीय पुष्टि छह अंकों का PIN है, जो कारोबार के अपने WhatsApp नंबर की सुरक्षा करता है। ऑथेंटिकेशन टेम्पलेट आपके ग्राहकों को कोड भेजता है, ताकि आपका ऐप या साइट पुष्टि कर सके कि वे कौन हैं।
क्या यूज़र को कोड पाने के लिए ऑप्ट-इन करना होता है?
हाँ। Meta की नीति के अनुसार कारोबार किसी को संदेश भेजने से पहले अनुमति लेता है, और उसकी OTP मार्गदर्शिका चैनलों का विकल्प देने का सुझाव देती है, जैसे WhatsApp, SMS या ईमेल। आपकी लॉगिन स्क्रीन पर नंबर के बगल में WhatsApp चुनना ही वह अनुमति है।
क्या कोई एजेंसी एक ही नंबर से कई क्लाइंट के कोड भेज सकती है?
नहीं। Meta की सर्वोत्तम प्रथाएँ कहती हैं कि ऑथेंटिकेशन टेम्पलेट के लिए हर कारोबार का अपना WhatsApp Business Account और फ़ोन नंबर हो; कई कारोबारों के बीच एक नंबर साझा करना Meta की शर्तों और नीति के विरुद्ध है। इसके बजाय हर क्लाइंट के लिए एक नंबर जोड़ें।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित