WhatsApp

GetMyBot WhatsApp को WhatsApp Cloud API (Meta Graph API) के ज़रिए जोड़ता है। जुड़ने के बाद बॉट WhatsApp से आने वाले संदेश ग्रहण करता है और उन पर आपके रिएक्शन लागू करता है, और ऑपरेटर डायलॉग में पत्राचार कर सकते हैं। मल्टीचैनल का सामान्य अवलोकन — पृष्ठ चैनल पर।

WhatsApp चैनल जोड़ना

जोड़ने के लिए आपके Meta ऐप (WhatsApp Cloud API) से पाँच विवरण चाहिए। ये सभी अनिवार्य हैं:

  • Phone number ID — WhatsApp Business नंबर का पहचानकर्ता।
  • WABA ID — WhatsApp Business Account का पहचानकर्ता।
  • Access token — Meta ऐप का एक्सेस टोकन।
  • Verify token — एक मनमानी स्ट्रिंग जो आप स्वयं तय करते हैं। इसका उपयोग Meta में webhook सत्यापन के समय होता है (नीचे देखें)।
  • App secret — Meta ऐप का रहस्य। आने वाले webhooks के HMAC-हस्ताक्षर की जाँच के लिए आवश्यक (हेडर X-Hub-Signature-256)।

इंटरफ़ेस में चरण:

  1. बॉट → «चैनल जोड़ें» → WhatsApp खोलें।
  2. ऊपर के पाँच फ़ील्ड भरें और चाहें तो चैनल का नाम (वैकल्पिक)।
  3. «जाँचें» पर क्लिक करें — GetMyBot Meta के ज़रिए विवरणों की पुष्टि करता है।
  4. «जोड़ें» पर क्लिक करें।

Meta में webhook कॉन्फ़िगरेशन

जुड़ने के बाद चैनल को {पता}/ch/{channelID} रूप का एक Callback URL मिलता है (इंटरफ़ेस में — webhook आइकन 🔗)। इसे अपने Verify token के साथ Meta ऐप में दर्ज करें: WhatsApp → Configuration → Webhook।

यह कैसे काम करता है:

  1. Meta Callback URL पर एक verify-अनुरोध भेजता है और पास किए गए verify_token की आपके Verify token से तुलना करता है। मेल होने पर webhook पुष्ट माना जाता है।
  2. इसके बाद Meta इस पते पर घटनाएँ भेजता है (आने वाले संदेश, डिलीवरी स्थितियाँ, टेम्पलेटों के मॉडरेशन निर्णय)।
  3. हर आने वाला अनुरोध हेडर X-Hub-Signature-256 से हस्ताक्षरित होता है; GetMyBot App secret की मदद से हस्ताक्षर जाँचता है — इसीलिए यह विवरण जोड़ते समय आवश्यक है।

24-घंटे की सेशन-विंडो

WhatsApp पहल पर आधारित पत्राचार को सीमित करता है: मुक्त संदेश उपयोगकर्ता को केवल उसके अंतिम आने वाले संदेश के बाद 24 घंटे तक भेजे जा सकते हैं। उपयोगकर्ता का हर नया आने वाला संदेश विंडो को नवीनीकृत करता है।

24-घंटे की विंडो के बाहर मुक्त संदेश नहीं भेजा जा सकता — उपयोगकर्ता को फिर से लिखने (re-engage) का एकमात्र तरीका एक स्वीकृत संदेश टेम्पलेट है। इसीलिए टेम्पलेट WhatsApp में ब्रॉडकास्ट और रिमाइंडरों का मुख्य साधन हैं।

संदेश टेम्पलेट

टेम्पलेट (message template) Meta के साथ पहले से सहमत संदेश है, जिसे सेशन-विंडो के बाहर भेजा जा सकता है। टेम्पलेटों का प्रबंधन — GetMyBot इंटरफ़ेस में।

टेम्पलेट कहाँ प्रबंधित करें

बॉट → WhatsApp चैनल के पास «संदेश टेम्पलेट» आइकन (📄) → डायलॉग «WhatsApp चैनल टेम्पलेट»। डायलॉग में बटन हैं:

  • «टेम्पलेट बनाएँ» — नया टेम्पलेट तैयार करना।
  • «सिंक करें» — Meta से टेम्पलेट कैटलॉग लाना (स्थितियाँ और सूची अद्यतन करना)।

टेम्पलेट श्रेणियाँ

  • MARKETING (मार्केटिंग) — ऑफ़र, घोषणाएँ, ब्रॉडकास्ट।
  • UTILITY (सेवा) — उपयोगकर्ता की क्रियाओं पर आधारित सूचनाएँ (ऑर्डर की स्थितियाँ, रिमाइंडर)।
  • AUTHENTICATION (प्रमाणीकरण) — पुष्टि कोड।

टेम्पलेट के फ़ील्ड

  • नाम — लोअरकेस लैटिन अक्षर, अंक और _, 512 वर्णों तक।
  • भाषा — Meta का locale।
  • श्रेणी — ऊपर की तीन में से एक।

मार्केटिंग और सेवा श्रेणियों के लिए अतिरिक्त रूप से:

  • हेडर — कुछ नहीं / टेक्स्ट / छवि / वीडियो / दस्तावेज़। मीडिया-हेडर के लिए एक उदाहरण फ़ाइल अपलोड की जाती है।
  • बॉडी — अनिवार्य, 1024 वर्णों तक। चर {{1}}, {{2}} … से चिह्नित होते हैं, 1 से N तक सख्त क्रम में, बिना छूट के।
  • फ़ुटर — 60 वर्णों तक।
  • बटन — 10 तक: त्वरित उत्तर, लिंक (2 तक), फ़ोन (1), कोड कॉपी (1)।
  • हर चर {{n}} के लिए एक उदाहरण मान देना आवश्यक है — यह मॉडरेशन के लिए Meta की शर्त है।

प्रमाणीकरण श्रेणी के लिए बॉडी स्वयं Meta द्वारा तय होती है; ये सेट होते हैं: कोड की वैधता अवधि (1–90 मिनट), सुरक्षा अनुशंसा और कोड कॉपी बटन का टेक्स्ट।

मॉडरेशन

«बनाएँ» बटन टेम्पलेट को तुरंत Meta के मॉडरेशन में भेज देता है — «जाँच के लिए भेजें» का अलग चरण नहीं है। निर्णय अतुल्यकालिक रूप से (webhook के ज़रिए) आता है, टेम्पलेट सूची स्वतः अद्यतन होती है। स्थितियाँ:

  • PENDING (जाँच में)
  • APPROVED (स्वीकृत)
  • REJECTED (अस्वीकृत) — कारण के उल्लेख के साथ
  • साथ ही PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION।

APPROVED, REJECTED, PAUSED स्थितियों वाले टेम्पलेट संपादित किए जा सकते हैं। नाम और भाषा नहीं बदले जा सकते; स्वीकृत टेम्पलेटों में श्रेणी भी लॉक होती है।

रिएक्शन में टेम्पलेट का उपयोग

टेम्पलेट भेजना एक रिएक्शन क्रिया है:

  1. रिएक्शन बिल्डर में «क्रियाएँ» → «क्रिया जोड़ें» → «WhatsApp टेम्पलेट भेजें» खोलें।
  2. यह क्रिया तभी उपलब्ध है जब बॉट में टेम्पलेट समर्थन वाला WhatsApp चैनल जुड़ा हो।
  3. केवल स्वीकृत (APPROVED) टेम्पलेट ही चुना जाता है।
  4. पैरामीटर भरे जाते हैं: बॉडी में चर {{n}} के मान, टेक्स्ट हेडर, लिंक के ज़रिए मीडिया-हेडर, URL-बटनों के पैरामीटर। पैरामीटरों में प्रतिस्थापन-चर का उपयोग किया जा सकता है।

भेजने का वास्तविक चैनल घटना के चैनल से तय होता है: यदि घटना WhatsApp से आई, तो टेम्पलेट WhatsApp में जाएगा।

डायलॉग और अनुलग्नक

ऑपरेटर WhatsApp डायलॉग में उत्तर दे सकता है और अनुलग्नक भेज सकता है — छवि, वीडियो या दस्तावेज़ — 24-घंटे की विंडो को ध्यान में रखते हुए (विंडो के बाहर मुक्त पत्राचार उपलब्ध नहीं)। सब्सक्राइबरों से आने वाला मीडिया प्रॉक्सी के ज़रिए लाया जाता है और डायलॉग में दिखाया जाता है।

शुल्क

GetMyBot WhatsApp वार्तालापों (conversations) का श्रेणीवार लेखा रखता है — marketing / utility / authentication / service। वर्तमान संस्करण में यह केवल अवलोकन के लिए रिकॉर्ड (record-only) है: वार्तालापों के लिए शेष से कटौती नहीं होती।

आगे क्या