Meta
डेवलपर

WhatsApp Business प्लेटफ़ॉर्म के ज़रिए मैसेज टेंप्लेट मैनेज करना

कॉन्फ़्रेंस रूम में सात सहकर्मियों की मीटिंग हो रही है

WhatsApp मैसेज टेंप्लेट कस्टमर्स को उपयोगी जानकारी भेजने का एक असरदार तरीका है. आप इनका उपयोग रिमाइंडर, नोटिफ़िकेशन या कस्टमाइज़ किए गए अपडेट देने के लिए कर सकते हैं.

WhatsApp की मदद से आप उन यूज़र्स के साथ डायरेक्ट चैट शुरू कर सकते हैं, जिन्होंने मैसेज पाने के लिए ऑप्ट-इन किया है. इसके अलावा, आप यूज़र द्वारा भेजे गए किसी भी मैसेज का जवाब दे सकते हैं. इसके बाद, ये यूज़र्स WhatsApp के टेंप्लेट आधारित मैसेज पा सकते हैं.

इन टेंप्लेट को जेनरेट करने के लिए WhatsApp Business प्लेटफ़ॉर्म का उपयोग करने से क्लाइंट के साथ आपकी बातचीत व्यवस्थित हो सकती है और यूज़र अनुभव बेहतर बन सकता है.

आइए एक उदाहरण पर विचार करते हैं. कल्पना पर आधारित एक यात्रा संबंधी बिज़नेस — Terrific Travel Ltd. — परिवहन, आवास और मनोरंजन से जुड़ी एक्टिविटी को रिज़र्व करने की सर्विस देता है. WhatsApp की सुविधा दुनिया भर में हर जगह उपलब्ध होने की वजह से यह इस बिज़नेस के लिए अपने क्लाइंट के साथ बातचीत करने हेतु एक आदर्श प्लेटफ़ॉर्म है. हालाँकि, ईमेल कन्फ़र्मेशन रिकॉर्ड रखने के लिए बढ़िया हैं, लेकिन यात्रा के दौरान कस्टमर्स के साथ दो-तरफ़ा बातचीत करने की सुविधा यात्रियों के लिए बहुत ही उपयोगी होती है और यह सुविधा पारंपरिक SMS के ज़रिए नहीं दी जा सकती.

इसके अलावा, WhatsApp के मैसेज टेंप्लेट की मदद से Terrific Travel Ltd. पर्सनलाइज़ की गई जानकारी के साथ अपने कस्टमर्स से बातचीत कर सकती है. इस मामले में, कस्टमाइज़ किया हुआ स्वागत मैसेज, समय पर नोटिफ़िकेशन और तुरंत एक्सेस किए जा सकने वाले इलेक्ट्रॉनिक टिकट, कस्टमर को यह भरोसा देने में कारगर साबित हो सकते हैं कि उनकी ट्रिप अच्छे से मैनेज की जा रही है — जिससे वे आराम कर सकते हैं और अपनी छुट्टियों का आनंद उठा सकते हैं.

WhatsApp Business API और मैसेज टेंप्लेट का ज़्यादा से ज़्यादा फ़ायदा उठाना कितना आसान है, इसका अनुभव करने के लिए यह प्रैक्टिकल ट्यूटोरियल आपको टेंप्लेट मैनेजमेंट के प्रोसेस के बारे में बताएगा — जिसमें बनाना, डिलीट करना और कस्टमाइज़ करना शामिल है.

WhatsApp Business प्लेटफ़ॉर्म के ज़रिए मैसेज टेंप्लेट मैनेज करना

शर्तें

इस ट्यूटोरियल में यह अनुमान लगाया गया है कि आपको Node.js और Express.js एप्लिकेशन की बुनियादी जानकारी है. आगे बढ़ने से पहले, कृपया WhatsApp Business प्लेटफ़ॉर्म डॉक्यूमेंट के परिचय सेक्शन में दिए गए स्टेप पूरे करें. अगर आप बिज़नेस सॉल्यूशन प्रोवाइडर (BSP) हैं, तो बिज़नेस सॉल्यूशन प्रोवाइडर के लिए शुरुआत करें पर टैप करें और पक्का करें कि आपका Meta ऐप रिव्यू प्रोसेस को पास करें.

ट्यूटोरियल से पहले, देख लें कि आपके पास WhatsApp Business ID और मोबाइल नंबर ID है.

इसके अलावा, BSP को ज़रूरी परमिशन (whatsapp_business_management, whatsapp_business_messaging और business_management) के साथ सिस्टम यूज़र टोकन की ज़रूरत होती है.

अगर आपके पास Node.js और Express.js ऐप्लिकेशन नहीं हैं, तो आप खास तौर पर ट्यूटोरियल के लिए बनाए गए इस ऐप्लिकेशन बॉयलरप्लेट का उपयोग कर सकते हैं.

इसके अलावा, इस ट्यूटोरियल में कई पैकेज का उपयोग किया जाएगा, जिनमें टोकन स्टोर करने के लिए डॉटएनवी और API के साथ HTTP रिक्वेस्ट करने के लिए रिक्वेस्ट शामिल हैं. हम API एंड पॉइंट को टेस्ट करने के लिए Postman का उपयोग भी करेंगे.

आगे के एक्सप्लोरेशन के लिए, पूरा कोड यहाँ उपलब्ध है.

जब आप शुरुआती ऐप्लिकेशन सेट कर लेते हैं और सही परमिशन के साथ टोकन जोड़ लेते हैं, तो आप शुरुआत करने के लिए तैयार हो जाते हैं.

नया मैसेज टेंप्लेट बनाना

मान लीजिए कि Global Voyager खास उद्देश्यों के लिए कई मैसेज टेंप्लेट बनाना चाहता है. जैसे, वे कस्टमर को ग्रीट करने के लिए एक टेंप्लेट बनाना चाहते हैं और दूसरा टेंप्लेट प्रासंगिक डॉक्यूमेंट की PDF कॉपी भेजने के लिए.

कोडिंग शुरू करने से पहले, थोड़ा समय निकालकर यह समझें कि टेंप्लेट बनाने की प्रोसेस कैसे काम करती है और यह किस तरह के पैरामीटर स्वीकार करती है. इसके अलावा, यह ध्यान रखना ज़रूरी है कि Meta रोज़ टेंप्लेट को रिव्यू करता है और अगर वे गाइडलाइन का पालन नहीं करते हैं, तो उन्हें अस्वीकार कर सकता है.

डॉक्यूमेंट में बताया गया है कि आपको अपनी WhatsApp Business ID का उपयोग करके message_templates को पोस्ट रिक्वेस्ट भेजनी होगी.

ये पैरामीटर स्वीकार किए जाते हैं:

  • प्रकार की कैटेगरी ENUM
  • के कंपोनेंट का प्रकार JSON ऐरे है
  • भाषा
  • नाम

कंपोनेंट पैरामीटर मैसेज टेंप्लेट के मुख्य हिस्से के बारे में बताता है. यह इन सब-पैरामीटर को स्वीकार करता है:

  • प्रकार — हेडर, मुख्य भाग, फ़ुटर और बटन के प्रकार के लिए एनम
  • फ़ॉर्मेट — TEXT, IMAGE, DOCUMENT, VIDEO, LOCATION के प्रकार का ENUM
  • टेक्स्ट — स्ट्रिंग का प्रकार
  • बटन — JSON ऐरे का प्रकार

अब आपके पास कस्टमर्स का अभिवादन करने के लिए टेक्स्ट पर आधारित मैसेज टेंप्लेट और PDF भेजने के लिए मीडिया पर आधारित मैसेज टेंप्लेट मौजूद है — और हमारे उदाहरण के अनुसार, यात्रा की टिकट या यात्रा के प्लान का कन्फ़र्मेशन भेजने के लिए ये सबसे बढ़िया रहेंगे.

टेक्स्ट आधारित मैसेज टेंप्लेट बनाना

सबसे पहले, आपको routes/messageTemplates.js में एक नया राउटर बनाना होगा:

router.post("/messageTemplate", createMessageTemplate);

इसके बाद, createMessageTemplate कंट्रोलर मेथड का उपयोग करें, जिसे हम controllers/messageTemplate.js में बनाएँगे:

exports.createMessageTemplate = async (req, res) => {exports.createMessageTemplate = async (req, res) => { const { name, language, category, components } = req.body; if (!name || !language || !category || !components) { return res.status(400).json({ error: "Required Fields: name, language, category, and components", }); } request.post( { url: `https://graph.facebook.com/v13.0/${process.env.META_BUSINESS_ID}/message_templates`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, "content-type": "application/json", }, body: JSON.stringify({ name: name, language: language, category: category, components: components, }), }, function (err, resp, body) { if (err) { console.log("Error!"); } else { res.json(JSON.parse(body)); } } ); };

अब रूट और मेथड बनाने के बाद, Postman में API को टेस्ट करने का समय आ गया है. यह इस तरह दिखाई देता है:

और यह रिटर्न है:

नीचे रिक्वेस्ट के ऑब्जेक्ट का सैंपल दिया गया है. इसे आप मैसेज टेंप्लेट बनाने के लिए आगे बढ़ा सकते हैं. {{1}} का उपयोग वेरिएबल को आगे बढ़ाने के लिए किया जाता है. ध्यान दें कि {{X}} का उपयोग मैसेज टेंप्लेट वेरिएबल को परिभाषित करने के लिए किया जाता है, न कि पोस्टमैन वेरिएबल को.

{ "name": "welcome_greetings", "language": "en_US", "category": "ALERT_UPDATE", "components": [ { "type": "HEADER", "format":"TEXT", "text": "नमस्ते {{1}}! आप कैसे हैं?" }, { "type": "BODY", "text": "अपने छुट्टियों के लिए Terrific Travel Ltd. को चुनने के लिए धन्यवाद! अगर आपका कोई सवाल है या आप किसी बात को लेकर परेशान हैं, तो कृपया हमसे संपर्क करें." }, { "type": "FOOTER", "text": "Terrific Travel Ltd." } ] }

सफल API रिस्पॉन्स, टेंप्लेट ID को दिखाने वाली ID वैल्यू वापस करता है.

मीडिया पर आधारित मैसेज टेंप्लेट बनाना

टेक्स्ट वाला टेंप्लेट बनाने के बाद, आप उतनी ही आसानी से मीडिया वाले टेंप्लेट भी बना सकते हैं. ये डॉक्यूमेंट भेजने के लचीले और कुशल साधन हैं, जिन्हें कस्टमर तुरंत एक्सेस कर सकता है.

नीचे दिए गए टेंप्लेट में एक हेडर होगा, जिसमें अटैच किया गया डॉक्यूमेंट, एक बॉडी कंपोनेंट और एक फ़ुटर कंपोनेंट शामिल होगा:

{ "name": "sample_ticket_confirmation", "language": "en_US", "category": "TICKET_UPDATE", "components": [ { "type": "HEADER", "format": "DOCUMENT" }, { "type": "BODY", "text": "This is your flight confirmation for {{1}}-{{2}} on {{3}}." }, { "type": "FOOTER", "text": "This message is from an unverified business." } ] }

नोट: कस्टमर्स के साथ चैट करने के लिए मैसेज टेंप्लेट का उपयोग करने से पहले, टेंप्लेट को मंज़ूरी मिलनी चाहिए और उन्हें मैसेज टेंप्लेट गाइडलाइन का पालन करना होगा.

मौजूदा मैसेज टेंप्लेट की लिस्ट वापस पाना

अब जब आपने मैसेज टेंप्लेट बना लिए हैं, तो आप उन्हें वापस पा सकते हैं. ऐसा करने के लिए, यहाँ GET कॉल करें:

https://graph.facebook.com/v13.0/whatsapp-business-account-ID/message_templates.

नोट: API वर्जन बदल सकता है. यह पक्का करें कि आपका URL इस हिसाब से अपडेट किया गया है.

इसके बाद, routes/messageTemplates.js में नया रूट बनाएँ:

router.get("/messageTemplates", getMessageTemplates);

ऊपर दिया गया ‘getMessageTemplates’ एक कंट्रोलर मेथड है, जिसे आप controllers/messageTemplate.js में बना सकते हैं. नीचे देखें:

exports.getMessageTemplates = async (req, res) => { request.get( { url: `https://graph.facebook.com/v13.0/${process.env.META_BUSINESS_ID}/message_templates`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, }, }, function (err, resp, body) { if (err) { console.log("Error!"); } else { res.json(JSON.parse(body)); } } ); };

एक सफल रिस्पॉन्स में आपका बनाया गया टेंप्लेट और WhatsApp का सैंपल टेंप्लेट शामिल होता है.

मैसेज टेंप्लेट डिलीट करना

अपने GET रूट की तरह ही, आप routes/messageTemplates.js में DELETE रूट भी बना सकते हैं:

router.delete("/messageTemplate", deleteMessageTemplate);

अब, controllers/messageTemplates.js में सपोर्ट करने वाले कंट्रोलर का मेथड बनाएँ:

exports.deleteMessageTemplate = async (req, res) => { request.delete( { url: `https://graph.facebook.com/v13.0/${process.env.META_BUSINESS_ID}/message_templates`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, "content-type": "application/json", }, body: JSON.stringify({ name: req.body.name, }), }, function (err, resp, body) { if (err) { console.log("Error!"); } else { res.json(JSON.parse(body)); } } ); };

किसी टेंप्लेट को डिलीट करने के लिए, आपको टेंप्लेट के नाम को JSON बॉडी के रूप में पास करना होगा.

जैसे, नीचे दिए गए स्क्रीनशॉट में demo_template_user नाम के टेंप्लेट को डिलीट करने के लिए Postman की रिक्वेस्ट और जवाब दिखाया गया है:

टेंप्लेट का उपयोग करके मैसेज भेजना

अब मैसेज भेजने के लिए मैसेज टेंप्लेट का उपयोग करें.

सबसे पहले, राउटर बनाएँ और उसका सपोर्ट करने वाला कंट्रोलर बनाएँ. routes/messageTemplates.js में, यह जोड़ें:

router.post("/sendMessage/:id", sendMessage);

ऊपर दिए गए कोड में, :id पैरामीटर का उपयोग फ़ोन नंबर ID पास करने के लिए किया जाता है. यहाँ दिया गया कोड दिखाता है कि controllers/messageTemplate.js में कंट्रोलर कैसा दिखता है.

exports.sendMessage = async (req, res) => { const { id, to, type,template } = req.body; if (!id || !to || !type || !template) { return res.status(400).json({ error: "Required Fields: to, type, template and id", }); } request.post( { url: `https://graph.facebook.com/v13.0/${req.params.id}/messages`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, "content-type": "application/json", }, body: JSON.stringify({ messaging_product: process.env.MESSAGING_PRODUCT, to: to, type: type, template: template, }), }, function (err, resp, body) { if (err) { console.log("Error!"); } else { res.json(JSON.parse(body)); } } ); };

अब आप Postman में रिक्वेस्ट ऑब्जेक्ट बना सकते हैं. याद रखें कि आप हेडर में एक पैरामीटर — {{1}} — पास करेंगे.

Postman रिक्वेस्ट बॉडी हमारे द्वारा बनाए गए टेक्स्ट आधारित टेंप्लेट को दिखाता है.

ऊपर दिए गए स्क्रीनशॉट से यह कोड स्निपेट नोट करें:

"कंपोनेंट": [ { "type": "हेडर", "पैरामीटर": [ { "type": "टेक्स्ट", "टेक्स्ट": "नाम" } ] } ]

इस स्निपेट का उपयोग पैरामीटर {{1}} में वैल्यू भेजने के लिए किया जाता है. एक सफल रिस्पॉन्स में मैसेज ID शामिल होती है, जैसा कि नीचे दिखाया गया है.

यहाँ देखें कि WhatsApp पर कस्टमर्स को यह मैसेज कैसा दिखाई देता है:

इसके बाद, आप दूसरे टेंप्लेट के लिए JSON रिक्वेस्ट ऑब्जेक्ट का उपयोग करेंगे, जिसमें आपको हेडर में डॉक्यूमेंट के साथ-साथ बॉडी में वेरिएबल {{1}}, {{2}}, और {{3}} पास करने होंगे.

सबसे पहले, नीचे दिया गया स्क्रीनशॉट देखें:

ध्यान दें कि नीचे दिया गया स्निपेट हेडर के लिए पैरामीटर पास करता है:

"parameters": [ { "type": "DOCUMENT", "document": { "id":"984786545564592" } } ] }, { Then, the following code does the same for the BODY: "parameters": [ { "type": "text", "text": "Toronto" }, { "type": "text", "text": "Dubai" }, { "type": "text", "text": "2022-05-03" } ] } ] } }

अटैच किया गया मीडिया लिंक या अपलोड की गई मीडिया ID हो सकता है.

आखिर में, नीचे दी गई फ़ोटो दिखाती है कि WhatsApp पर सफल आउटपुट कैसा दिखता है.

निष्कर्ष

इस ट्यूटोरियल की मदद से, आपने आसान लेकिन असरदार मैसेज टेंप्लेट बनाने के लिए WhatsApp Business API की क्षमताओं को एक्सप्लोर करना शुरू कर दिया है. WhatsApp Business API की सुविधा और विश्वसनीयता किसी भी बिज़नेस के कम्युनिकेशन सिस्टम को बेहतर बना सकती है, ताकि किसी कस्टमर को लंबे समय तक बिज़नेस का क्लाइंट बनाने में मदद मिल सके. अब समय है कि आप इस अवसर का लाभ उठाएँ.

संबंधित पोस्ट

कंटेंट को पर्सनलाइज़ करने, विज्ञापनों को आपके हिसाब से दिखाने और उनका मूल्यांकन करने तथा आपको ज़्यादा सुरक्षित अनुभव देने के लिए हम कुकीज़ का उपयोग करते हैं. साइट पर क्लिक या नेविगेट करके, आप सहमति देते हैं कि हम कुकीज़ के ज़रिए Meta पर और Meta के बाहर आपकी जानकारी इकट्ठी कर सकते हैं. उपलब्ध कंट्रोल्स की जानकारी सहित और जानकारी पाएँ: [प्राइवेसी पॉलिसी]