WhatsApp यूटिलिटी टेम्पलेट
यूटिलिटी टेम्पलेट उस काम के बाद भेजा जाता है जो प्राप्तकर्ता पहले ही कर चुका है: कोई ऑर्डर, भुगतान, बुकिंग या साइन-इन। Bird के कैटलॉग में ऐसे आठ टेम्पलेट हैं, जिनमें bird_signin_alert और bird_delivery_update शामिल हैं। किसी स्लग की श्रेणी उसके नाम से नहीं, बल्कि टेम्पलेट सूची से देखें: bird_signin_alert नाम से ऑथेंटिकेशन टेम्पलेट जैसा लगता है, पर वह यूटिलिटी टेम्पलेट है।
भेजने से पहले
कोई प्रबंधित कैटलॉग टेम्पलेट चुनें या अपने कनेक्ट किए गए बिज़नेस खाते पर यूटिलिटी टेम्पलेट बनाएँ।
Bird के कैटलॉग टेम्पलेट भेजने के लिए आपको कोई सत्यापन नहीं चाहिए, ठीक ऑथेंटिकेशन की तरह। अपना यूटिलिटी टेम्पलेट बनाने के लिए भी सत्यापन ज़रूरी नहीं है: ऑथेंटिकेशन के विपरीत, Meta की बिज़नेस-सत्यापन शर्त यूटिलिटी पर कभी लागू नहीं होती, इसलिए आप बिना सत्यापित वर्कस्पेस पर भी यूटिलिटी टेम्पलेट बना और संपादित कर सकते हैं। सत्यापन से दूसरी जगहों पर क्या सुविधाएँ मिलती हैं, यह जानने के लिए WhatsApp बिज़नेस सत्यापन देखें।
to कोई E.164 फ़ोन नंबर या बिज़नेस-स्तर की यूज़र आईडी हो सकता है। यूटिलिटी टेम्पलेट में OTP बटन नहीं होता, इसलिए इसके लिए ऑथेंटिकेशन की तरह केवल फ़ोन नंबर वाला प्राप्तकर्ता ज़रूरी नहीं है।
हर प्रबंधित कैटलॉग यूटिलिटी टेम्पलेट केवल en में, on_missing_language: fail के साथ पंजीकृत है। अगर आप ऐसी भाषा माँगते हैं जो कैटलॉग में नहीं है, तो संदेश अंग्रेज़ी या किसी दूसरी भाषा में नहीं भेजा जाता, बल्कि भेजना विफल हो जाता है।
यूटिलिटी टेम्पलेट भेजना
POST /v1/whatsapp/messages, एक template ऑब्जेक्ट के साथ जिसमें कैटलॉग स्लग का नाम हो:
const msg = await bird.whatsapp.send({
to: "+16505551234",
template: {
slug: "bird_order_confirmation",
language: "en",
parameters: { ref: "A1B2C3D4", amount: "USD 49.99" },
},
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+16505551234",
template="bird_order_confirmation",
language="en",
parameters={"ref": "A1B2C3D4", "amount": "USD 49.99"},
)
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)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+16505551234",
Template: "bird_order_confirmation",
Language: "en",
Parameters: map[string]any{"ref": "A1B2C3D4", "amount": "USD 49.99"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
template: 'bird_order_confirmation',
language: 'en',
parameters: ['ref' => 'A1B2C3D4', 'amount' => 'USD 49.99'],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--language en \
--parameters '{"amount":"USD 49.99","ref":"A1B2C3D4"}' \
--template bird_order_confirmation \
--to +16505551234curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+16505551234",
"template": {
"slug": "bird_order_confirmation",
"language": "en",
"parameters": {
"ref": "A1B2C3D4",
"amount": "USD 49.99"
}
}
}'किसी भी प्रबंधित टेम्पलेट की तरह, from न दें: Bird श्रेणी और क्षेत्र के आधार पर भेजने वाला नंबर चुनता है, और इसे सेट करने पर 422 E15018 WhatsAppSenderNotAllowed लौटता है। अपना यूटिलिटी टेम्पलेट बनाकर भेजना किसी भी स्व-निर्मित टेम्पलेट को भेजने जैसा ही है; सामान्य नियमों के लिए टेम्पलेट के साथ भेजना देखें।
वेरिएबल भरना
यूटिलिटी वेरिएबल नामित होते हैं, इसलिए हर वेरिएबल parameters में अपनी अलग कुंजी होता है, जैसे ref और amount। संख्या वाले {{1}} प्रत्यय वाला URL बटन इसके बजाय button_url कुंजी लेता है। नामित प्रत्यय अपना ही नाम लेता है। भेजे गए संदेश में पूरा पता नहीं, केवल मान होता है:
{ "parameters": { "ref": "A1B2C3D4", "button_url": "A-4192" } }components वाले संदेश में इसके बजाय हर बॉडी पैरामीटर का नाम दिया जाता है, और ऐरे में नामित पैरामीटर के क्रम का कोई अर्थ नहीं होता। कंपोनेंट, sub_type और भेजे गए संदेश के components टेम्पलेट के घोषित प्लेसहोल्डर से कैसे मेल खाते हैं, इन साझा नियमों के लिए टेम्पलेट के साथ भेजना और कंपोनेंट और पैरामीटर देखें।
लागत
खुली ग्राहक सेवा विंडो के भीतर डिलीवर हुआ यूटिलिटी टेम्पलेट 30 सितंबर 2026 तक Meta की मुफ़्त दर के योग्य है। 1 अक्टूबर 2026 से Meta इसके लिए किसी भी अन्य यूटिलिटी टेम्पलेट की तरह शुल्क लेता है (अक्टूबर 2026 के मूल्य परिवर्तन)। Bird का आउटबाउंड शुल्क संदेश प्रोसेसिंग के दौरान, सबमिशन से पहले लिया जाता है। बाद में आने वाला डिलीवर या पढ़े जाने का कॉलबैक तय करता है कि Meta शुल्क लागू होगा या नहीं। कुल लागत का अनुमान लगाते समय दोनों हिस्से जाँचें।
संदेश पर शुल्क कब लगता है, यह जानने के लिए लागत और बिलिंग देखें, और दरों के लिए WhatsApp मूल्य निर्धारण देखें।
ध्यान देने योग्य बातें
- Meta अपनी ओर से यूटिलिटी टेम्पलेट को मार्केटिंग श्रेणी में बदल सकता है, और संदेश नई, ऊँची कीमत पर भेजा जाता रहता है। अप्रैल 2025 से, जिस व्यवसाय को Meta गलत श्रेणी के लिए पहले ही चेतावनी दे चुका है, उसे कोई अग्रिम सूचना नहीं मिलती; बदलाव तुरंत लागू होता है। यूटिलिटी टेम्पलेट के टेक्स्ट में प्रचार वाली भाषा, ऑफ़र या अपसेल न रखें, क्योंकि इन्हीं से यह बदलाव होता है। कौन सी बातें प्रचार मानी जाती हैं, इसके लिए टेम्पलेट दिशानिर्देश देखें।
- मार्केटिंग के अलावा किसी श्रेणी में
gifहेडर याcopy_codeबटन अस्वीकार कर दिया जाता है। दोनों केवल मार्केटिंग के कंपोनेंट हैं; यूटिलिटी टेम्पलेट पर इनमें से कोई भी घोषित करने पर विफलता मिलती है। - अपने बनाए टेम्पलेट से भेजे गए
componentsसंदेश पर शुल्क लगने से पहले पैरामीटर की संख्या नहीं जाँची जाती। अगर आप अपने टेम्पलेट परcomponentsमें गलत संख्या में पैरामीटर भेजते हैं, तो संदेश स्वीकार होता है और शुल्क लगता है, फिर Meta उसे अस्वीकार कर देता है। जिसparametersसंदेश में कोई ज़रूरी कुंजी नहीं होती, उसे किसी भी शुल्क से पहले अस्वीकार कर दिया जाता है, और प्रबंधित कैटलॉग से भेजे गए संदेशों में यह कमी नहीं है। - गलत WhatsApp Business Account पर मौजूद प्रेषक को किसी भी शुल्क से पहले अस्वीकार कर दिया जाता है।
fromउसी खाते पर होना चाहिए जिस पर टेम्पलेट है; अन्यथा भेजना422E15023WhatsAppSenderWABAMismatchके साथ विफल होता है।
अगले कदम
- WhatsApp टेम्पलेट: कैटलॉग ब्राउज़ करना और टेम्पलेट से भेजने का साझा अनुबंध
- प्रमाणीकरण टेम्पलेट: एक बार उपयोग होने वाले सत्यापन कोड और ऐसा टेम्पलेट बनाने पर लागू सत्यापन की शर्त
- मार्केटिंग टेम्पलेट: प्रचार संदेश भेजना और ऐसा टेम्पलेट बनाने के लिए ज़रूरी खाता
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।