MM Lite API setup कैसे करें: marketing template को Marketing Messages API पर कैसे भेजें

ज़्यादातर डेवलपर अब भी MM Lite API नाम से ही खोजते हैं, पर Meta अब इसे Marketing Messages API for WhatsApp (MM API for WhatsApp) कहता है। यह marketing मैसेज भेजने का एक अलग रास्ता है, जो उसी फ़ोन नंबर पर Cloud API के साथ-साथ चलता है। यह गाइड प्रैक्टिकल पक्ष है: कौन eligible है, onboarding कैसे होती है, कोड में क्या बदलता है, और स्विच कब करना है यह कैसे तय करें। छोटी परिभाषा के लिए Marketing Messages API (MM Lite) की glossary एंट्री देखें।

नाम, और वह डेडलाइन जो फ़ैसला बदल देती है

Meta ने इसे beta में Marketing Messages Lite API ("MM Lite") नाम से चलाया। यह 19 Nov 2025 को अपने आज के नाम से generally available हुआ। कुछ फ़ील्ड नाम अब भी पुराना नाम रखते हैं, जैसे Embedded Signup का marketing_messages_lite फ़ीचर और MM_LITE_TERMS_SIGNED webhook इवेंट।

Meta का overview पेज अब यह टाइमलाइन देता है:

Service, utility और authentication मैसेज Cloud API पर ही रहते हैं। तो सवाल यह नहीं रहा कि API से marketing template भेजने वाला बिज़नेस Marketing Messages API पर जाए या नहीं, बल्कि कब जाए। Meta का कहना है कि ज़्यादातर integration में लगभग दो हफ़्ते लगते हैं।

क्या बदलता है और क्या वैसा ही रहता है

Meta जो कहता है, उसके हिसाब से यह चीज़ें नहीं बदलतीं:

• हर मैसेज की क़ीमत। Meta के rate-card फ़ाइल कहते हैं कि marketing दरें Cloud API और Marketing Messages API दोनों पर लागू होती हैं। Optional max price फ़ीचर (हर marketing delivery पर एक bid cap) 1 Oct 2026 से open beta में है; Meta का कहना है कि Q2 2027 में general availability पर यह योग्य देशों में ज़रूरी हो जाएगा। मौजूदा दरें हमारे WhatsApp API pricing पेज पर देखें।
• Per-user marketing limit। Meta यह नहीं कहता कि नया API इन्हें हटा देता है। Error 131049 का मतलब अब भी यही है कि WhatsApp ने उस व्यक्ति के लिए मैसेज रोक दिया; error 131049 का मतलब क्या है देखें।
• Opt-in और template की समीक्षा। आपको अब भी ग्राहक का opt-in और सही template कैटेगरी में मंज़ूर template चाहिए।
• Delivery का वादा। Optimisation यह तय करता है कि कौन से मैसेज डिलीवर होंगे, यह कोई वादा नहीं कि ज़्यादा डिलीवर होंगे। कुछ देशों (EEA, UK, Japan, South Korea, Nigeria, South Africa, Thailand) में कोई delivery optimisation या click रिपोर्टिंग नहीं मिलती।

Step 1: Eligibility जाँचें

Meta की शर्तें छोटी हैं: WhatsApp account active है और उल्लंघन के लिए restricted नहीं है, न तो Messaging account का tax country और न ही owner बिज़नेस किसी प्रतिबंधित क्षेत्र में है, एक फ़ोन नंबर Cloud API पर रजिस्टर्ड है, आपके पास एक मंज़ूर marketing template है, और आपका app messages webhook पर subscribed है। अपने system user token से account को API से जाँचें:

curl "https://graph.facebook.com/v26.0/$WABA_ID?fields=marketing_messages_onboarding_status" \
  -H "Authorization: Bearer $WA_TOKEN"

ELIGIBLE का मतलब है आप onboard कर सकते हैं; ONBOARDED का मतलब है यह पहले से हो चुका है। पुरानी फ़ील्ड marketing_messages_lite_api_status कुछ कोड में अब भी दिखती है, पर Meta इसे deprecate करने वाला मानता है, इसलिए नई वाली ही पढ़ें।

Step 2: शर्तें मंज़ूर करें

शर्तें उसी व्यक्ति को मंज़ूर करनी होती हैं जिसके पास business portfolio का full control हो। आप कहाँ क्लिक करते हैं यह इस पर निर्भर करता है कि आप कैसे integrate करते हैं:

• आप ख़ुद Cloud API कॉल करते हैं (कोई partner नहीं): App Dashboard → WhatsApp → Quickstart खोलें, Marketing Messages API से ROI सुधारने वाला कार्ड ढूँढें, Get started दबाएँ, फिर Continue to integration guide दबाकर Terms of Service मंज़ूर करें।
• कोई partner आपका account संभालता है: WhatsApp Manager → Overview खोलें। Alerts में, Accept terms to get started for Marketing Messages API for WhatsApp क्लिक करें और signing पूरी करें।
• Partner जो क्लाइंट onboard करते हैं: Meta marketing_messages_lite फ़ीचर वाला Embedded Signup, एक Intent API (POST /{business-id}/onboard_partners_to_mm_lite, जो क्लाइंट के admin को ईमेल करता है) और एक Intent UI देता है।

Onboarding से आपके marketing template से जुड़े read-only ad account भी बनते हैं, जिससे click और conversion insight Insights API तक पहुँचती है।

Step 3: Onboarding पूरा होने की पुष्टि करें

जब तक Meta पुष्टि न कर दे, production ट्रैफ़िक न भेजें। या तो MM_LITE_TERMS_SIGNED इवेंट वाले account_update webhook का इंतज़ार करें (portfolio के हर Messaging account के लिए एक), या step 1 वाली फ़ील्ड को तब तक poll करें जब तक वह ONBOARDED न लौटाए। अगर मंज़ूर करने वाला व्यक्ति WhatsApp Manager नहीं खोल सकता, तो पहले उसे portfolio के admins में ढूँढना होगा; Meta के support पेज पर एक admin ढूँढने का सेक्शन है।

Step 4: अपना पहला marketing template भेजें

Payload वही Cloud API template payload है जो आप पहले से इस्तेमाल करते हैं। सिर्फ़ endpoint बदलता है:

curl -X POST "https://graph.facebook.com/v26.0/$PHONE_NUMBER_ID/marketing_messages" \
  -H "Authorization: Bearer $WA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "919876543210",
    "type": "template",
    "template": {
      "name": "diwali_sale_offer",
      "language": { "code": "en" },
      "components": [
        { "type": "body", "parameters": [ { "type": "text", "text": "Priya" } ] }
      ]
    },
    "product_policy": "STRICT"
  }'

दो optional फ़ील्ड सिर्फ़ यहीं हैं:

• product_policy: डिफ़ॉल्ट CLOUD_API_FALLBACK onboarding पूरी न होने पर चुपचाप Cloud API से भेज देता है। STRICT इसके बदले error लौटाता है, जो टेस्ट करते समय अच्छा है, क्योंकि आपको पता चल जाता है कि मैसेज किस रास्ते गया।
• message_activity_sharing: हर मैसेज पर true या false, जो optimisation के लिए read और click एक्टिविटी Meta के साथ शेयर करने वाली account सेटिंग को override करता है।

पहले हफ़्ते में ये error आम हैं:

Step 5: हर भेजे गए मैसेज को template कैटेगरी से रूट करें

Template मंज़ूरी के बाद फिर से कैटेगरी बदल सकते हैं: utility के तौर पर जमा किया गया template marketing बन सकता है अगर WhatsApp उसे प्रचार वाला पाए। Meta की सलाह है कि account ID, template नाम, भाषा और latest कैटेगरी की एक stored mapping रखें, template category update webhook पर subscribe करें, और latest कैटेगरी के हिसाब से रूट करें: MARKETING को /marketing_messages पर, बाकी सबको /messages पर। template कैटेगरी गाइड बताती है कि recategorisation क्यों होता है।

पूरी तरह onboard होने के बाद आप WhatsApp Business account पर disable_marketing_messages_on_cloud_api को true सेट कर सकते हैं। इसके बाद /messages पर भेजा गया marketing template Cloud API से जाने के बदले error 131063 के साथ फ़ेल हो जाता है, जिससे routing की गलतियाँ जल्दी पकड़ में आती हैं। इसे तभी चालू करें जब उस account के लिए marketing template भेजने वाला हर सिस्टम शिफ़्ट हो चुका हो; अगर कोई campaign टूल अब भी marketing template /messages पर भेज रहा है तो वह फ़ेल होने लगेगा।

Step 6: Webhook और नतीजे जाँचें

नए endpoint से गए मैसेज के लिए status webhook में pricing.category की वैल्यू marketing_lite होती है (origin type भी वही वैल्यू इस्तेमाल करता है)। जो मैसेज Cloud API पर fallback हुए, वे marketing दिखाते हैं। हर मैसेज ID ने कौन सा endpoint इस्तेमाल किया, यह लॉग करें ताकि billing और रिपोर्ट मिला सकें। कुछ campaign के बाद read और click दरों की तुलना Meta के दिए बेंचमार्क से करें, और यह तय करें कि automatic creative optimisation चालू करना है या नहीं; Meta के changelog के मुताबिक़ यह 21 Apr 2026 से डिफ़ॉल्ट रूप से बंद है, और इसे template या account के स्तर पर चालू किया जा सकता है।

स्विच कब करें, यह कैसे तय करें

Broadchat में यह कहाँ खड़ा है

Broadchat की campaign CRM → Bulk Campaign से अभी मंज़ूर marketing template Cloud API के /messages endpoint से भेजती हैं, आपके नंबर की messaging limit के हिसाब से पेस की जाती हैं, और channel के messaging wallet से चार्ज होती हैं। /marketing_messages पर रूटिंग आज पैनल का हिस्सा नहीं है। अगर आप Broadchat से भेजते हैं, तो अपने account पर disable_marketing_messages_on_cloud_api सेट न करें, क्योंकि फिर Broadchat की campaign 131063 के साथ फ़ेल होने लगेंगी। 2027 की डेडलाइन के लिए अपने partner से उनकी योजना पूछें। जो एजेंसियाँ अपने ब्रांड नाम से WhatsApp campaign बेचना चाहती हैं, वे white-label platform और बड़े WhatsApp broadcast फ़ीचर के बारे में पढ़ सकती हैं, और जो लोग प्लेटफ़ॉर्म पर नए हैं, वे WhatsApp Business API क्या है से शुरू कर सकते हैं।