WhatsApp ऑथेंटिकेशन टेम्पलेट

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

भेजने से पहले

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

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

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

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

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

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

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

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);

msg = client.whatsapp.send(
    to="+14155550100",
    template="bird_otp",
    language="en",
    components=[{"type": "body", "parameters": [{"type": "text", "text": "481920"}]}],
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	code := "481920"
	components := []bird.WhatsAppMessageTemplateComponent{{
		Type:       "body",
		Parameters: &[]bird.WhatsAppMessageTemplateComponentParameter{{Type: "text", Text: &code}},
	}}
	msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
		To:       "+14155550100",
		Template: "bird_otp",
		Language: "en",
		Components: components,
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$components = [
    (new WhatsAppMessageTemplateComponent())
        ->setType('body')
        ->setParameters([
            (new WhatsAppMessageTemplateComponentParameter())->setType('text')->setText('481920'),
        ]),
];
$message = $bird->whatsapp->send(
    to: '+14155550100',
    template: 'bird_otp',
    language: 'en',
    components: $components,
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --components '[{"parameters":[{"text":"481920","type":"text"}],"type":"body"}]' \
  --language en \
  --template bird_otp \
  --to +14155550100

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "to": "+14155550100",
      "template": {
        "slug": "bird_otp",
        "language": "en",
        "components": [
          {
            "type": "body",
            "parameters": [
              {
                "type": "text",
                "text": "481920"
              }
            ]
          }
        ]
      }
    }'

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

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

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

कोड कॉपी करने का बटन

Meta ऑथेंटिकेशन टेम्पलेट की बॉडी खुद लिखता है, एक प्रीसेट के रूप में जिसमें एक ही कोड प्लेसहोल्डर होता है, इसलिए आप टेक्स्ट नहीं, बल्कि फ़्लैग देते हैं। भेजते समय बटन कंपोनेंट वैकल्पिक है: अगर आप इसे शामिल नहीं करते, तो 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 authentication-international दरें देखें, और किसी भेजे गए संदेश पर शुल्क कब लगता है, यह जानने के लिए लागत और बिलिंग देखें। दरों के आंकड़े 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 मिलता है। इसके बजाय अपनी सुरक्षा अनुशंसा और कोड की समाप्ति अवधि के साथ नया टेम्पलेट बनाएं।

अगले कदम

• WhatsApp टेम्पलेट: कैटलॉग ब्राउज़ करना और टेम्पलेट से भेजने का साझा अनुबंध
• यूटिलिटी टेम्पलेट: ऑर्डर अपडेट, अपॉइंटमेंट रिमाइंडर और अकाउंट सूचनाएं
• WhatsApp व्यवसाय सत्यापन: सत्यापन कैसे काम करता है और इससे और क्या-क्या उपलब्ध होता है