Meta Cloud API के माध्यम से WhatsApp कनेक्ट करें
Twilio के विकल्प के रूप में, अपने खुद के नंबर और ऐप के साथ, सीधे Meta (Cloud API) से WhatsApp भेजें और प्राप्त करें। BYO मॉडल: नंबर, WhatsApp Business Account और ऐप आपके हैं।
संदेश टेम्पलेट
ग्राहक के जवाब के बिना 24 घंटे बीत जाने पर WhatsApp खुला संदेश भेजने नहीं देता: बातचीत दोबारा शुरू करने के लिए स्वीकृत टेम्पलेट चाहिए। टेम्पलेट आप CRM के भीतर ही बनाते और संभालते हैं — सेटिंग्स → इंटीग्रेशन में WhatsApp कार्ड में; Meta के Business Manager तक जाने की ज़रूरत नहीं।
- “नया टेम्पलेट” दबाएँ और बताएँ कि वह किस काम का है। तकनीकी नाम अपने आप भर जाता है (Meta सिर्फ़ छोटे अक्षर, अंक और अंडरस्कोर लेता है)।
- भाषा और श्रेणी चुनें। ऑर्डर या अपॉइंटमेंट जैसे अपेक्षित संदेश के लिए “उपयोगिता”, और ऑफ़र के लिए “मार्केटिंग”। Meta श्रेणी की भी समीक्षा करता है, और ग़लत श्रेणी अस्वीकृति का आम कारण है।
- संदेश लिखें। जो हर व्यक्ति के लिए बदलता है उसके लिए {{1}}, {{2}} इस्तेमाल करें — क्रम से, बिना कोई अंक छोड़े।
- हर वेरिएबल के लिए एक उदाहरण भरें। Meta इसे अनिवार्य रखता है और इनके बिना टेम्पलेट अस्वीकार कर देता है — ये मान किसी को नहीं भेजे जाते, सिर्फ़ समीक्षा के लिए हैं।
- समीक्षा के लिए भेजें। टेम्पलेट लंबित के रूप में दर्ज होता है और Meta आमतौर पर कुछ ही मिनटों में मंज़ूरी देता है; स्थिति सूची में दिखती है।
एक क्लिक में जोड़ें
अगर कार्ड के ऊपर "WhatsApp जोड़ें" बटन दिखे, तो वही सबसे छोटा रास्ता है। Meta की एक विंडो खुलती है, आप WhatsApp Business खाता और नंबर चुनते (या बनाते) हैं, और काम पूरा। न कोई ऐप बनाना है, न टोकन बनाना, न कुछ चिपकाना। यह इसलिए संभव है क्योंकि SellioCRM एक अनुमोदित Meta Tech Provider है: कनेक्शन हमारे ऐप के अंतर्गत होता है, आपको अपना ऐप बनाने की ज़रूरत नहीं।
- नंबर और खाता आपके ही रहते हैं। आप Meta से कभी भी कनेक्शन हटा सकते हैं और हमारी पहुँच तुरंत खत्म हो जाती है।
- आपका Facebook पासवर्ड हम कभी नहीं देखते, और हमारी कोई गोपनीय कुंजी आपके ब्राउज़र तक नहीं पहुँचती।
- संदेशों का शुल्क Meta आपके अपने खाते पर ही लेता रहेगा।
मैन्युअल सेटअप (अपना Meta ऐप)
Twilio के अलावा, आप आधिकारिक Cloud API का उपयोग करके सीधे Meta से WhatsApp भेज और प्राप्त कर सकते हैं। यह एक विकल्प है: जब यह इंटीग्रेशन सक्रिय होता है, तो WhatsApp Meta के माध्यम से जाता है; SMS Twilio का उपयोग जारी रखता है। BYO मॉडल (आप अपना खुद का अकाउंट लाते हैं): नंबर, WhatsApp Business Account (WABA) और Meta ऐप आपके हैं, और संदेश आपके Meta अकाउंट पर बिल किए जाते हैं, हमारी तरफ से कोई लागत, मार्जिन या बिचौलियापन नहीं।
इंटीग्रेशन निष्क्रिय शुरू होता है: जब तक आप फ़ील्ड नहीं भरते और सक्रिय नहीं करते, कुछ भी नहीं भेजा जाता। access token और app secret CRM में एन्क्रिप्टेड रूप से संग्रहीत होते हैं और कभी वापस नहीं दिखाए जाते।
पूर्वापेक्षाएँ
- WhatsApp प्रोडक्ट जोड़ा गया और एक WhatsApp Business Account (WABA) वाला एक Meta ऐप (developers.facebook.com)।
- आपके WABA पर पंजीकृत एक WhatsApp नंबर और उसका Phone Number ID (WhatsApp > API Setup के तहत)।
- एक स्थायी access token (अनुशंसित: Business Manager में एक System User) और ऐप का App secret (Settings > Basic के तहत)।
- Sellio में, क्रेडेंशियल सहेजने और Settings → Integrations में इंटीग्रेशन सक्रिय करने के लिए एडमिनिस्ट्रेटर एक्सेस।
आपको क्या भरना होगा
- Phone Number ID: Meta पर आपके WhatsApp नंबर का पहचानकर्ता (यह एक ID है, फ़ोन नंबर स्वयं नहीं)।
- WABA ID (वैकल्पिक): आपके WhatsApp Business Account की ID, प्रबंधन और टेम्पलेट्स के लिए उपयोगी।
- Graph version: कॉल करने के लिए Graph API का संस्करण (जैसे, v21.0)। खाली छोड़ने पर डिफ़ॉल्ट उपयोग होता है।
- Verify token: एक स्ट्रिंग जो आप चुनते हैं। webhook को subscribe करते समय यह CRM में और Meta पैनल में समान होनी चाहिए।
- Access token: वह स्थायी टोकन जो भेजने को अधिकृत करता है (CRM में एन्क्रिप्टेड रूप से संग्रहीत)।
- App secret: ऐप secret, जो प्राप्त webhooks के हस्ताक्षर को सत्यापित करने के लिए उपयोग होता है (CRM में एन्क्रिप्टेड रूप से संग्रहीत)।
कैसे कॉन्फ़िगर करें
- Settings → Integrations खोलें और "WhatsApp (Meta Cloud API)" कार्ड ढूँढें।
- Phone Number ID, Verify token (एक स्ट्रिंग चुनें), Access token और App secret भरें; WABA ID और Graph version वैकल्पिक हैं। "क्रेडेंशियल सहेजें" पर क्लिक करें।
- दिखाई देने वाला "वेबहुक URL (Meta)" कॉपी करें। Meta पैनल में, WhatsApp → Configuration → Webhooks के तहत, उस URL को Callback URL में पेस्ट करें और वही Verify token, Verify token फ़ील्ड में पेस्ट करें।
- अभी भी Meta में, संदेश और स्थितियाँ प्राप्त करने के लिए "messages" फ़ील्ड को subscribe करें।
- CRM पर वापस लौटें और "सक्रिय करें" पर क्लिक करें। इसके बाद, WhatsApp भेजने Meta के माध्यम से जाते हैं।
संदेश कैसे भेजें
- फ़ोन (Phone या Mobile फ़ील्ड) वाला एक Contact या Lead खोलें।
- "संदेश (SMS/WhatsApp)" पैनल में, "SMS/WhatsApp भेजें" पर क्लिक करें और WhatsApp चैनल चुनें।
- नंबर जाँचें, संदेश लिखें और "भेजें" पर क्लिक करें।
- संदेश रिकॉर्ड के इतिहास में लॉग होता है। ग्राहक के जवाब webhook के माध्यम से आते हैं और उसी इतिहास में दिखाई देते हैं।
सुरक्षा: CRM आपके App secret का उपयोग करके प्रत्येक प्राप्त webhook के X-Hub-Signature-256 को सत्यापित करता है (एक unsigned कॉल या अमान्य हस्ताक्षर वाली कॉल अस्वीकृत कर दी जाती है)। access token और app secret को गुप्त मानें: वे एन्क्रिप्टेड रूप से संग्रहीत होते हैं और कभी वापस नहीं दिखाए जाते।
एक ही ऐप में कई नंबर
एक ही इंटीग्रेशन में एक से अधिक WhatsApp नंबर हो सकते हैं (जैसे डिफ़ॉल्ट के रूप में अमेरिकी नंबर और स्थानीय बातचीत के लिए ब्राज़ील का नंबर)। इंटीग्रेशन कार्ड में "अतिरिक्त नंबर" के तहत उन्हें जोड़ें (Phone Number ID, वैकल्पिक WABA ID और एक लेबल) और सहेजें। बातचीत शुरू करते समय "इससे भेजें" में प्रेषक चुनें; इनबॉक्स के जवाब अपने आप उसी नंबर से जाते हैं जिस पर हर बातचीत आई थी। मुख्य नंबर डिफ़ॉल्ट बना रहता है।
कैसे परीक्षण करें
- फ़ोन वाला एक Contact या Lead खोलें और अपने किसी नंबर पर एक छोटा WhatsApp संदेश भेजें।
- पुष्टि करें कि संदेश फ़ोन तक पहुँचा और यह रिकॉर्ड के इतिहास में लॉग हुआ।
- फ़ोन से जवाब दें और जाँचें कि जवाब उसी इतिहास में दिखाई देता है (यह इनबाउंड webhook को मान्य करता है)।
समस्या निवारण
- Meta पर webhook सत्यापन विफल होता है: CRM और Meta पैनल में Verify token समान होना चाहिए। जाँचें कि Callback URL कार्ड पर दिखाया गया "वेबहुक URL (Meta)" है।
- भेजते समय त्रुटि: Phone Number ID और Access token जाँचें। एक expired token या WhatsApp अनुमति के बिना Meta भेजने से इनकार कर देगा।
- WhatsApp विंडो के बाहर नहीं भेजता: एक स्वीकृत टेम्पलेट का उपयोग करें। फ्री टेक्स्ट केवल 24h विंडो के भीतर।
- मुझे जवाब नहीं मिलते: Meta पैनल में, "messages" फ़ील्ड को subscribe करें और Callback URL + Verify token की पुष्टि करें।
- Webhook अस्वीकृत (403): X-Hub-Signature-256 मेल नहीं खाता। CRM में वही App secret फिर से दर्ज करें (यह सर्वर से वापस नहीं आता)।
- यह अभी भी Twilio के माध्यम से जाता है: Meta इंटीग्रेशन "सक्रिय" होना चाहिए। सक्रिय किए बिना, WhatsApp Twilio का उपयोग जारी रखता है।
वही नंबर उपयोग करें जो पहले से WhatsApp Business ऐप में है
आप नंबर को मोबाइल ऐप में सक्रिय रखते हुए साथ ही CRM से जोड़ सकते हैं — Meta इसे को-एग्ज़िस्टेंस कहता है। विक्रेता हमेशा की तरह फ़ोन से उत्तर देता रहता है, और उसका भेजा हर संदेश अपने आप CRM की बातचीत में दिखता है। सक्रिय करते समय छह महीने तक की पुरानी बातचीत आयात होती है।
- इसे आप स्वयं बिज़नेस मैनेजर में चालू नहीं करते: यह CRM के कनेक्शन सहायक से होता है और आपके WhatsApp पर आए कोड से पुष्ट होता है।
- ऐप सामान्य रूप से चलता रहता है: बदलाव बस इतना है कि बातचीत सही संपर्क के साथ यहाँ भी दर्ज होती है।
- इतिहास आयात की समयसीमा है: Meta सक्रियण के बाद 24 घंटे देता है। इस दौरान ऐप खुला रखें — प्रगति स्क्रीन पर दिखती है।
- फ़ोन बदलने या नंबर दोबारा रजिस्टर करने पर कनेक्शन टूट जाता है और फिर से करना पड़ता है। ऐसा होने पर CRM सूचित करता है।