# WhatsApp authentication टेम्प्लेट

एक authentication टेम्पलेट वन-टाइम सत्यापन कोड डिलीवर करता है। जब आप टेम्पलेट बनाते हैं तो Meta इसका टेक्स्ट खुद तैयार करता है। भेजते समय, कोड को body पैरामीटर के रूप में दें।

## भेजने से पहले

चुनें कि Bird-managed टेम्पलेट इस्तेमाल करना है या अपने बिज़नेस अकाउंट पर खुद टेम्पलेट बनाना है।

Bird के स्टॉक्ड कैटलॉग टेम्प्लेट, `bird_otp` और `bird_otp_authifly`, भेजने के लिए आपके किसी verification की ज़रूरत नहीं। ये टेम्प्लेट Bird के अपने WhatsApp Business Accounts पर होते हैं, और managed send पाथ आपके business की verification स्थिति कभी जाँचता नहीं।

जब कनेक्टेड बिज़नेस अकाउंट `not_verified` रिपोर्ट करता है, तो Bird authentication-टेम्पलेट बनाने या डुप्लिकेट करने से `412` [`E15043`](/docs/api/errors/E15043) `WhatsAppTemplateBusinessNotVerified` के साथ मना कर देता है। कनेक्टेड अकाउंट और उसकी नवीनतम सिंक्रोनाइज़्ड स्थिति जाँचें। सत्यापन प्रक्रिया और स्थिति प्रबंधन के लिए [WhatsApp business verification](/docs/knowledge-base/whatsapp/business-verification) देखें।

Utility और marketing टेम्प्लेट ऑथरिंग पर इस गेट का कोई असर नहीं पड़ता; आप अपनी verification स्थिति की परवाह किए बिना उन्हें बनाते और एडिट करते रह सकते हैं।

डैशबोर्ड में, [`bird` CLI](/docs/cli) से, या [MCP server](/docs/ai/mcp-server) के ज़रिए टेम्प्लेट ऑथर करें। पूरे फ़्लो के लिए [WhatsApp टेम्प्लेट ऑथरिंग](/docs/guides/whatsapp/authoring-templates) देखें।

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

कैटलॉग slug नाम वाले `template` ऑब्जेक्ट के साथ `POST /v1/whatsapp/messages`:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+14155550100",
  template: {
    slug: "bird_otp",
    language: "en",
    components: [{ type: "body", parameters: [{ type: "text", text: "481920" }] }],
  },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/hi-in/dastavez/guides/whatsapp/templates/authentication.ts.md) · [Python](/hi-in/dastavez/guides/whatsapp/templates/authentication.py.md) · [Go](/hi-in/dastavez/guides/whatsapp/templates/authentication.go.md) · [PHP](/hi-in/dastavez/guides/whatsapp/templates/authentication.php.md) · [CLI](/hi-in/dastavez/guides/whatsapp/templates/authentication.cli.md) · [MCP](/hi-in/dastavez/guides/whatsapp/templates/authentication.mcp.md) · [cURL](/hi-in/dastavez/guides/whatsapp/templates/authentication.curl.md)

इस कैटेगरी के लिए चार नियम विशेष हैं:

- **`from` को छोड़ दें।** Bird-managed टेम्प्लेट कैटेगरी और रीजन के आधार पर अपना sender खुद चुनता है, इसलिए `from` सेट करने पर `422` [`E15018`](/docs/api/errors/E15018) `WhatsAppSenderNotAllowed` मिलता है। यह free-form send के विपरीत है, जिसमें `from` ज़रूरी होता है; अगर आप interactive-message पेजों से यहाँ आ रहे हैं तो यह याद रखने लायक बात है।
- **`to` E.164 फ़ोन नंबर होना चाहिए।** Authentication टेम्प्लेट business-scoped user ID पर नहीं भेजा जा सकता; वह `422` [`E15014`](/docs/api/errors/E15014) `WhatsAppRecipientNotSupportedForTemplate` है।
- **बॉडी में ठीक एक positional पैरामीटर होता है, कोड।** शून्य पैरामीटर, या पैरामीटर को नाम देना, `422` [`E15003`](/docs/api/errors/E15003) `WhatsAppTemplateParameterMismatch` लौटाता है। Authentication एकमात्र कैटेगरी है जिसे Meta positionally लिखता है; बाकी हर कैटेगरी अपने पैरामीटर नाम से देती है।
- **किसी customer service विंडो की ज़रूरत नहीं।** टेम्प्लेट सेंड विंडो-गेटेड नहीं होते, और यही कारण है कि सत्यापन कोड टेम्प्लेट मौजूद है: इसे उस व्यक्ति तक पहुँचना होता है जिसने आपको पहले कभी मैसेज नहीं किया।

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

## Copy code बटन

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

```json
{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }
```

किसी भी तरह, WhatsApp तक ठीक एक बटन पहुँचता है, और वह copy-code बटन होता है: टैप करने पर कोड क्लिपबोर्ड पर कॉपी हो जाता है। Bird केवल `copy_code` सपोर्ट करता है; authentication टेम्प्लेट के लिए Meta जो अन्य दो बटन व्यवहार दस्तावेज़ित करता है, one-tap और zero-tap autofill, Bird पर आज उपलब्ध नहीं हैं।

टेम्प्लेट का बटन ऑथर करना भी उसी शेप का है: एक `otp` बटन, और टेम्प्लेट कोई अन्य बटन टाइप नहीं लेता। आप कॉपी लिखने की बजाय `add_security_recommendation` (एक boolean जो बॉडी में दिखता है) और `code_expiration_minutes` (1 से 90, फ़ुटर में दिखता है) देते हैं।

## Meta authentication टेम्प्लेट में क्या अनुमति देता है

Meta authentication टेम्प्लेट की संरचना तय करता है और उसकी सामग्री की समीक्षा करता है: टेम्प्लेट में कहीं भी URL, मीडिया या इमोजी नहीं, और कोड पैरामीटर पर 15-कैरेक्टर की सीमा। यह कैटेगरी WhatsApp के मैसेज डिलीवर करने का तरीका भी बदलती है, इसे केवल प्राप्तकर्ता के प्राइमरी डिवाइस पर भेजकर। तय संरचना, कैरेक्टर सीमाएँ और समीक्षा प्रक्रिया की पूरी जानकारी के लिए [टेम्प्लेट दिशानिर्देश](/docs/knowledge-base/whatsapp/template-guidelines) देखें।

## लागत

कैटेगरी और गंतव्य कीमत तय करते हैं। अपनी प्राथमिक लोकेशन से अलग किसी देश में भेजने पर कीमत कैसे बदल सकती है, यह जानने के लिए [WhatsApp authentication-international rates](/docs/knowledge-base/whatsapp/authentication-international-rates) देखें, और भेजने पर शुल्क कब लगता है इसके लिए [लागत और बिलिंग](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) देखें। दरों के आँकड़े [WhatsApp pricing](/products/whatsapp/pricing) पर हैं।

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

- **Bird के स्टॉक्ड टेम्प्लेट नौ देशों में डिलीवर नहीं होते।** `bird_otp` और `bird_otp_authifly` Bird के अपने WhatsApp Business Accounts से भेजते हैं, और वे अकाउंट मिस्र, भारत, इंडोनेशिया, मलेशिया, नाइजीरिया, पाकिस्तान, सऊदी अरब, दक्षिण अफ़्रीका या संयुक्त अरब अमीरात में authentication मैसेज नहीं भेजते। ऐसा सेंड कुछ भी चार्ज होने से पहले `422` [`E15063`](/docs/api/errors/E15063) `WhatsAppDestinationRestricted` के साथ अस्वीकार कर दिया जाता है। आपने अपने अकाउंट पर जो टेम्प्लेट ऑथर किया है, अपने नंबर से भेजा गया, इन देशों में सामान्य रूप से पहुँचता है। [Verify](/docs/guides/verify/countries#where-whatsapp-cannot-carry-a-passcode) भी इन देशों तक पहुँचता है, सत्यापन कोड को अपने आप दूसरे चैनल पर भेजकर।
- **ऑथर किए गए सेंड के लिए `from` ज़रूरी है, और यह टेम्प्लेट वाले WhatsApp Business Account पर ही होना चाहिए।** किसी अलग अकाउंट पर sender होने पर कुछ भी चार्ज होने से पहले `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch` के साथ अस्वीकार कर दिया जाता है।
- **केवल वही भाषा भेजी जा सकती है जिसका वर्शन approved और live है।** Draft, pending, rejected या paused भाषा भेजी नहीं जा सकती।
- **Meta अपनी पहल पर टेम्प्लेट को दोबारा कैटेगराइज़ कर सकता है।** इससे ऑप्ट-आउट नहीं किया जा सकता, और यह कैटेगरी से जुड़े pricing और delivery नियमों को भी बदल देता है।
- **टेम्प्लेट की कैटेगरी और उसकी भाषा की कैटेगरी अलग-अलग हो सकती हैं।** send पाथ इसे कैसे हल करता है, इसके लिए [WhatsApp टेम्प्लेट](/docs/guides/whatsapp/templates#listing-templates-from-the-api) देखें।
- **इंजेस्ट किए गए authentication टेम्प्लेट को डुप्लिकेट नहीं किया जा सकता।** Bird WhatsApp की जनरेट की गई कॉपी को वापस उन सेटिंग्स में नहीं पढ़ सकता जिनसे नया टेम्प्लेट बनाया जाता है; वह `422` [`E15024`](/docs/api/errors/E15024) `WhatsAppTemplateContentNotDuplicable` है। इसके बजाय अपनी खुद की security recommendation और code expiration के साथ नया बनाएँ।

## अगले कदम

- [WhatsApp टेम्प्लेट](/docs/guides/whatsapp/templates): कैटलॉग ब्राउज़ करना और साझा send-by-template कॉन्ट्रैक्ट
- [Utility टेम्प्लेट](/docs/guides/whatsapp/templates/utility): ऑर्डर अपडेट, अपॉइंटमेंट रिमाइंडर और अकाउंट नोटिस
- [WhatsApp business verification](/docs/knowledge-base/whatsapp/business-verification): verification कैसे काम करता है और यह और क्या अनलॉक करता है

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)