मल्टी-टेनेंट सोशल मीडिया एपीआई: एक एपीआई कुंजी, ग्राहकों के कई खाते
easyCoexistence का Partner API डिज़ाइन से ही मल्टी-टेनेंट है: आपके खाते की एक ec_live_ एपीआई कुंजी कई ग्राहकों के WhatsApp नंबर और सोशल खाते जोड़ती और संभालती है। हर कनेक्शन में आपके ग्राहक की आईडी external_ref के रूप में रहती है, उस ग्राहक का अपना टोकन होता है, उसका अपना वेबहुक डेस्टिनेशन होता है और वह हस्ताक्षरित स्टेटस इवेंट में दिखता है, इसलिए GET /channels?external_ref= किसी एक ग्राहक के खाते सूचीबद्ध करता है।
कनेक्ट सेशन जितना लंबा external_ref ले सकता है: ग्राहक के लिए आपकी अपनी आईडी, जो बनाए गए कनेक्शन पर सेव होती है।
एक easyCoexistence खाते में एक समय में रखी जा सकने वाली एपीआई कुंजियाँ; अलग कुंजियों का मतलब अलग खाते और अलग बिल।
एक साथ खुले रह सकने वाले कनेक्ट सेशन, साथ में प्रति घंटे 100 नए सेशन की सीमा।
वह अवधि जिसके बाद साइन किए गए इवेंट का टाइमस्टैम्प अस्वीकार होना चाहिए, और HMAC की तुलना कॉन्स्टेंट टाइम में होती है।
एक खाता कई ग्राहकों की सेवा कैसे करता है?
आपका easyCoexistence खाता आपके उत्पाद का प्रतिनिधित्व करता है, और हर ग्राहक उन कनेक्शनों पर एक टैग है जो वह लाता है। ग्राहकों का अपना खाता नहीं होता, वे आपकी कुंजी कभी नहीं देखते और उनका बिल आप भेजते हैं, easyCoexistence नहीं:
आप हर कनेक्शन को अपने ग्राहक से कैसे टैग करते हैं?
कनेक्ट सेशन पर external_ref भेजें। यह मान उस नंबर या चैनल पर सेव होता है जो सेशन बनाता है, रीडायरेक्ट में जुड़ता है और उसके स्टेटस इवेंट में शामिल होता है। Facebook या LinkedIn साइन-इन से कई Pages जुड़ें तो हर एक टैग होता है। किसी एक ग्राहक के खाते देखने के लिए कोई भी सूची फ़िल्टर करें:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"ग्राहकों के टोकन अलग कैसे रखे जाते हैं?
हर कनेक्शन अपने ग्राहक का टोकन रखता है। WhatsApp नंबर का टोकन वह कारोबार टोकन है जो Meta, Embedded Signup पर जारी करता है, और उसका दायरा उसी ग्राहक की संपत्तियों तक सीमित है। सोशल खाते का टोकन वह है जो उसके मालिक ने दिया। क्रेडेंशियल केवल आपकी एपीआई कुंजी के ज़रिए, आपके बैकएंड से आते हैं, और जो आईडी आपके खाते में नहीं है वह 404 not_found लौटाती है। किसी काम का टोकन लेने से पहले उस ग्राहक का कनेक्शन देखें जिसका वह काम है, ताकि एक ग्राहक का काम दूसरे के खाते पर न चले।
वेबहुक हर ग्राहक के लिए कैसे काम करते हैं?
हर खाते का एक वेबहुक डेस्टिनेशन होता है, जो आप चुनते हैं। चैनल एक ही यूआरएल पर भेजें और बॉडी में account_id से रूट करें, या हर ग्राहक को अपना यूआरएल दें। हर चैनल PUT /channels/{id}/webhook से अपनी सीक्रेट से साइन करता है, इसलिए account_id बताता है कि किस सीक्रेट से सत्यापित करना है। नंबर के मैसेज Meta से उसके webhook_url पर जाते हैं, जो WhatsApp Business Account पर सेट होता है, इसलिए उन्हें phone_number_id से रूट करें।
स्टेटस इवेंट बताते हैं कि वे किस ग्राहक से जुड़े हैं?
अपना external_ref लेकर। हर खाते का एक इवेंट यूआरएल connection.* और channel.* इवेंट पाता है, जिनके भीतर कनेक्शन या चैनल का व्यू होता है, external_ref सहित। post.published और post.failed पोस्ट और उसका चैनल लाते हैं। इवेंट खाते की अपनी सीक्रेट से X-EC-Signature में साइन होते हैं, और आपका एंडपॉइंट विफल होने पर दोबारा भेजे जाते हैं, इसलिए हर डिलीवरी आईडी को एक बार ही संभालें।
आप कितनी तेज़ी से कई ग्राहकों को ऑनबोर्ड कर सकते हैं?
हर खाते में एक साथ 50 खुले कनेक्ट सेशन और प्रति घंटे 100 नए सेशन तक। Meta हर पहली बार WhatsApp ऑनबोर्डिंग को एक ऐप-व्यापी सीमा में गिनता है, जो हर easyCoexistence खाता साझा करता है, और ये सीमाएँ एक प्लेटफ़ॉर्म के इम्पोर्ट को उसे खत्म करने से रोकती हैं। सेशन तब बनाएँ जब उसका ग्राहक कनेक्ट करने वाला हो। सीमा पर पहुँचने पर जवाब में 429 cap_reached या rate_limited आता है।
अगर किसी ग्राहक का खाता पहले से कहीं और जुड़ा हो तो?
साइन-इन रोक दिया जाता है। सोशल खाता एक समय में एक easyCoexistence खाते से जुड़ता है, इसलिए अगर easyCoexistence इस्तेमाल करने वाली कोई दूसरी सेवा उसे रखती है, तो सेशन का last_error यह बताता है, और ग्राहक उसे वहाँ से हटाए या किसी दूसरे खाते से साइन इन करे। आपके अपने खाते के भीतर ग्राहक जितने चाहें उतने खाते जोड़ सकता है, हर एक पर वही external_ref टैग होता है।
एक ग्राहक को कैसे ऑफ़बोर्ड करें?
उसके कनेक्शन और चैनल external_ref से सूचीबद्ध करें और हर एक पर DELETE भेजें। नंबर हटाने से Meta पर easyCoexistence की पहुँच रद्द होती है और निगरानी बंद होती है; चैनल हटाने से नेटवर्क पर पहुँच रद्द होती है और कतार में बची उसकी पोस्ट रद्द होती हैं। हर एक का बिल चक्र के अंत में बंद होता है, और ग्राहक के बाकी कनेक्शन, दूसरे ग्राहकों के कनेक्शन की तरह, अप्रभावित रहते हैं।
आम गड़बड़ियाँ
- external_ref के रूप में ईमेल इस्तेमाल करना। ईमेल बदलते रहते हैं और मान हर कनेक्शन पर सेव होता है, इसलिए अपने डेटाबेस की स्थायी आईडी लें।
- फ़ॉरवर्ड किए गए इवेंट को गलत ग्राहक की सीक्रेट से सत्यापित करना। बॉडी के account_id से सीक्रेट खोजें, क्योंकि हर चैनल अपनी सीक्रेट से साइन करता है।
- एक साथ पूरे ग्राहक-आधार को कनेक्ट लिंक भेजना। हर खाते में केवल 50 सेशन खुल सकते हैं, इसलिए ग्राहकों को चरणों में आमंत्रित करें।
- अपने डेटाबेस में ही ग्राहक हटाना। उनके कनेक्शन आपके खाते और आपके बिल पर रहते हैं, जब तक हर एक API के ज़रिए हटाया न जाए।
easyCoexistence एक एपीआई कुंजी से आपका पूरा ग्राहक-आधार सेवा देता है: उनके WhatsApp नंबर और Instagram, Facebook, TikTok, YouTube और LinkedIn खाते, और अन्य चैनल भी। हर कनेक्शन पर आपके ग्राहक की आईडी टैग होती है, उसका अपना टोकन, वेबहुक और साइन्ड इवेंट होते हैं, और हर कनेक्शन 24/7 निगरानी में रहता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने के साथ घटती दर, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या हर ग्राहक के लिए एक easyCoexistence खाता चाहिए?
नहीं। एक खाता और उसकी एपीआई कुंजी कई ग्राहकों के कनेक्शन रख सकती है, जिन्हें external_ref से अलग पहचाना जाता है। अलग खाते तभी चाहिए जब आपको अलग बिल चाहिए हों।
क्या मेरे ग्राहक एक-दूसरे के खाते देख सकते हैं?
easyCoexistence के ज़रिए नहीं। वे आपकी एपीआई कुंजी कभी नहीं रखते और केवल अपने कनेक्ट लिंक खोलते हैं। आपके उत्पाद के भीतर हर ग्राहक क्या देखता है, यह आपका कोड तय करता है।
क्या मैं हर ग्राहक को अलग वेबहुक यूआरएल दे सकता हूँ?
हाँ। हर नंबर और हर चैनल का अपना डेस्टिनेशन होता है, इसलिए ग्राहक-विशेष यूआरएल भी चलता है, और account_id से रूट होने वाला एक साझा यूआरएल भी।
मल्टी-टेनेंट खाते का बिल कैसे बनता है?
आपके सभी ग्राहकों के कुल कनेक्शन पर: प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जो आपकी कुल संख्या के बैंड से तय होती है, और पहले 3 दिन मुफ़्त।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित