Sign inGet Started

WhatsApp प्रमाणीकरण टेम्पलेट

प्रमाणीकरण टेम्पलेट एक बार उपयोग होने वाला सत्यापन कोड पहुँचाता है। जब आप टेम्पलेट बनाते हैं, तो उसका पाठ Meta देता है। भेजते समय कोड को बॉडी पैरामीटर के रूप में दें।

भेजने से पहले

तय करें कि आप Bird द्वारा प्रबंधित टेम्पलेट का उपयोग करेंगे या अपने व्यवसाय खाते पर खुद टेम्पलेट बनाएँगे।

Bird के कैटलॉग में उपलब्ध टेम्पलेट, bird_otp और bird_otp_authifly, भेजने के लिए आपके किसी सत्यापन की ज़रूरत नहीं है। ये टेम्पलेट Bird के अपने WhatsApp Business Accounts पर रहते हैं, और प्रबंधित भेजने का तरीका आपके व्यवसाय की सत्यापन स्थिति कभी नहीं जाँचता।

जब जुड़ा हुआ व्यवसाय खाता not_verified बताता है, तो Bird प्रमाणीकरण टेम्पलेट बनाने या उसकी प्रति बनाने से 412 E15043 WhatsAppTemplateBusinessNotVerified के साथ मना कर देता है। जुड़े हुए खाते और उसकी सबसे हाल में सिंक की गई स्थिति जाँचें। सत्यापन की प्रक्रिया और स्थिति संभालने के लिए WhatsApp व्यवसाय सत्यापन देखें।

यह शर्त यूटिलिटी और मार्केटिंग टेम्पलेट बनाने पर लागू नहीं होती; आपकी सत्यापन स्थिति जो भी हो, आप उन्हें बनाते और संपादित करते रह सकते हैं।

टेम्पलेट डैशबोर्ड में, bird CLI से, या MCP सर्वर के ज़रिए बनाएँ। पूरी प्रक्रिया के लिए प्रमाणीकरण टेम्पलेट बनाना देखें।

सत्यापन कोड भेजना

POST /v1/whatsapp/messages को ऐसे template ऑब्जेक्ट के साथ भेजें जिसमें कैटलॉग स्लग दिया गया हो:

const msg = await bird.whatsapp.send({
  to: "+14155550100",
  template: {
    slug: "bird_otp",
    language: "en",
    parameters: { code: "481920" },
  },
});
console.log(msg.id, msg.status);

इस श्रेणी पर चार नियम विशेष रूप से लागू होते हैं:

  • from न दें। Bird द्वारा प्रबंधित टेम्पलेट श्रेणी और क्षेत्र के आधार पर अपना प्रेषक खुद चुनता है, इसलिए from सेट करने पर 422 E15018 WhatsAppSenderNotAllowed मिलता है। फ़्री-फ़ॉर्म भेजने में इसका उल्टा होता है, क्योंकि उसमें from आवश्यक है। इंटरैक्टिव संदेश वाले पेजों से आने पर यह अंतर ध्यान में रखें।
  • to एक E.164 फ़ोन नंबर होना चाहिए। प्रमाणीकरण टेम्पलेट किसी बिज़नेस-स्कोप्ड उपयोगकर्ता ID पर नहीं भेजा जा सकता; ऐसा करने पर 422 E15014 WhatsAppRecipientNotSupportedForTemplate मिलता है।
  • कोड parameters.code में जाता है। यह बॉडी के प्लेसहोल्डर और कॉपी-कोड बटन दोनों को भरता है। इसके बजाय components भेजने में ठीक एक स्थितिगत बॉडी पैरामीटर लिया जाता है, यानी कोड। कोई पैरामीटर न देने या पैरामीटर को नाम देने पर 422 E15003 WhatsAppTemplateParameterMismatch मिलता है।
  • ग्राहक सेवा विंडो की आवश्यकता नहीं है। टेम्पलेट भेजना विंडो पर निर्भर नहीं करता, और सत्यापन कोड टेम्पलेट इसी कारण होता है: उसे ऐसे व्यक्ति तक पहुँचना होता है जिसने आपको पहले कभी संदेश नहीं भेजा।

bird_otp या bird_otp_authifly के लिए उपलब्ध भाषाएँ टेम्पलेट कैटलॉग से पढ़ें। अनुरोधित भाषा उपलब्ध न होने पर भेजना विफल हो जाता है; उसकी जगह कोई दूसरी भाषा नहीं ली जाती।

कॉपी कोड बटन

Meta प्रमाणीकरण टेम्पलेट की बॉडी खुद लिखता है, एक पूर्वनिर्धारित रूप में जिसमें एक ही कोड प्लेसहोल्डर होता है, इसलिए आप टेक्स्ट के बजाय फ़्लैग देते हैं। parameters भेजने में बटन code से भरा जाता है। components भेजने में बटन कॉम्पोनेंट वैकल्पिक है: यदि आप इसे शामिल नहीं करते, तो Bird इसे आपके लिए जोड़ देता है, जिसमें बॉडी वाला ही कोड होता है। आप इसे खुद भी दे सकते हैं:

कोड उदाहरण
{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }

दोनों ही स्थितियों में WhatsApp तक ठीक एक बटन पहुँचता है, और वह कॉपी-कोड बटन होता है: उसे टैप करने पर कोड क्लिपबोर्ड पर कॉपी हो जाता है। Bird केवल copy_code का समर्थन करता है; Meta प्रमाणीकरण टेम्पलेट के लिए जिन अन्य दो बटन व्यवहारों, वन-टैप और ज़ीरो-टैप ऑटोफ़िल, का वर्णन करता है, वे Bird पर उपलब्ध नहीं हैं।

टेम्पलेट बनाते समय बटन का ढाँचा भी यही होता है: एक otp बटन, और टेम्पलेट कोई अन्य बटन प्रकार स्वीकार नहीं करता। टेक्स्ट लिखने के बजाय आप add_security_recommendation (बॉडी में दिखने वाला एक बूलियन) और code_expiration_minutes (1 से 90, फ़ुटर में दिखने वाला) देते हैं।

Meta प्रमाणीकरण टेम्पलेट में क्या अनुमति देता है

Meta प्रमाणीकरण टेम्पलेट का ढाँचा तय करता है और उसकी सामग्री की समीक्षा करता है: टेम्पलेट में कहीं भी URL, मीडिया या इमोजी नहीं हो सकते, और कोड पैरामीटर अधिकतम 15 अक्षरों का हो सकता है। यह श्रेणी यह भी बदलती है कि WhatsApp संदेश कैसे पहुँचाता है: वह इसे केवल प्राप्तकर्ता के प्राथमिक डिवाइस पर भेजता है। तय ढाँचे, अक्षर सीमाओं और समीक्षा प्रक्रिया के पूरे विवरण के लिए टेम्पलेट दिशानिर्देश देखें।

लागत

कीमत श्रेणी और गंतव्य से तय होती है। अपने प्राथमिक स्थान के अलावा किसी दूसरे देश में भेजने से कीमत कैसे बदल सकती है, यह जानने के लिए WhatsApp ऑथेंटिकेशन-अंतरराष्ट्रीय दरें देखें, और किसी भेजे गए संदेश पर कब शुल्क लगता है, यह जानने के लिए लागत और बिलिंग देखें। दरों के आँकड़े WhatsApp मूल्य निर्धारण पर मिलते हैं।

ध्यान देने योग्य बातें

  • Bird के तैयार टेम्पलेट नौ देशों में डिलीवर नहीं होते। bird_otp और bird_otp_authifly, Bird के अपने WhatsApp Business Accounts से भेजे जाते हैं, और ये खाते मिस्र, भारत, इंडोनेशिया, मलेशिया, नाइजीरिया, पाकिस्तान, सऊदी अरब, दक्षिण अफ्रीका या संयुक्त अरब अमीरात में ऑथेंटिकेशन संदेश नहीं पहुँचाते। ऐसा संदेश कोई शुल्क लगने से पहले ही 422 E15063 WhatsAppDestinationRestricted के साथ अस्वीकार कर दिया जाता है। आपके अपने खाते पर बनाया गया और आपके अपने नंबर से भेजा गया टेम्पलेट इन देशों में सामान्य रूप से पहुँचता है। Verify भी इन देशों तक पहुँचता है, क्योंकि वह सत्यापन कोड को अपने आप दूसरे चैनल पर भेज देता है।
  • अपने बनाए टेम्पलेट को भेजने के लिए from ज़रूरी है, और वह उसी WhatsApp Business Account पर होना चाहिए जिस पर टेम्पलेट है। किसी दूसरे खाते का प्रेषक कोई शुल्क लगने से पहले ही 422 E15023 WhatsAppSenderWABAMismatch के साथ अस्वीकार कर दिया जाता है।
  • केवल वही भाषा भेजी जा सकती है जिसका संस्करण स्वीकृत और लाइव हो। ड्राफ़्ट, लंबित, अस्वीकृत या रोकी गई भाषा नहीं भेजी जा सकती।
  • Meta अपनी पहल पर किसी टेम्पलेट की श्रेणी बदल सकता है। इससे बाहर निकलने का कोई विकल्प नहीं है, और श्रेणी बदलने से उससे जुड़े मूल्य निर्धारण और डिलीवरी नियम भी बदल जाते हैं।
  • टेम्पलेट की श्रेणी और उसकी भाषा की श्रेणी अलग-अलग हो सकती हैं। भेजने की प्रक्रिया इसे कैसे सुलझाती है, यह जानने के लिए WhatsApp टेम्पलेट देखें।
  • इम्पोर्ट किए गए ऑथेंटिकेशन टेम्पलेट की प्रतिलिपि नहीं बनाई जा सकती। Bird, WhatsApp द्वारा बनाए गए पाठ को उन सेटिंग्स में वापस नहीं पढ़ सकता जिनसे नया टेम्पलेट बनता है; इस स्थिति में 422 E15024 WhatsAppTemplateContentNotDuplicable मिलता है। इसके बजाय अपनी सुरक्षा अनुशंसा और कोड समाप्ति अवधि के साथ एक नया टेम्पलेट बनाएँ।

अगले चरण

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।