अपने उपयोगकर्ताओं को अपने ऐप में WhatsApp, Instagram और TikTok खाते जोड़ने दें
अपने उपयोगकर्ताओं को अपने ऐप में WhatsApp, Instagram और TikTok खाते जोड़ने देने के लिए, easyCoexistence के Partner API से एक कनेक्ट सेशन बनाएँ और उपयोगकर्ता को उसके होस्टेड url पर भेजें। वहाँ वे Meta के Embedded Signup से WhatsApp नंबर जोड़ते हैं या Instagram, Facebook, TikTok, YouTube, LinkedIn और अन्य चैनलों में साइन इन करते हैं, फिर नए कनेक्शन या चैनल id के साथ आपके redirect_url पर लौटते हैं। लिंक एक घंटे तक चलते हैं।
कनेक्ट लिंक कितनी देर चलता है; उसके बाद सेशन expired दिखाता है और नया सेशन चाहिए।
एक खाता एक साथ कितने कनेक्ट सेशन खुले रख सकता है, और प्रति घंटे 100 नए सेशन की सीमा।
सेशन बनता है, खुलता है, कनेक्ट होता है, रद्द होता है या expire होता है, जैसा GET /connect-sessions/:id बताता है।
Meta किसी WhatsApp नंबर के मैसेज वेबहुक को दूसरे पते पर भेजने के लिए जितना लंबा वैकल्पिक callback URL स्वीकार करता है, वह सीमा।
कनेक्ट लिंक कैसे काम करता है?
यह चेकआउट पेज की तरह है। आपका बैकएंड सेशन बनाता है, आपका इंटरफ़ेस ग्राहक को उसके url पर भेजता है, ग्राहक easycoexistence.com के एक पेज पर कनेक्ट करता है, और ब्राउज़र आपके redirect_url पर लौट आता है। फिर आपका बैकएंड परिणाम की पुष्टि करता है और नए कनेक्शन के क्रेडेंशियल लाता है, यह सब आपकी API key से।
अनुरोध में क्या जाता है?
https://easycoexistence.com/api/v1/connect-sessions पर एक JSON बॉडी POST की जाती है, जिसमें आपकी API key Bearer टोकन के रूप में होती है। केवल redirect_url अनिवार्य है:
redirect_url: एक https URL जहाँ ग्राहक बाद में पहुँचता है।- channel: whatsapp, जो डिफ़ॉल्ट है, या आपके खाते के लिए खुला कोई सोशल नेटवर्क, उसके lowercase नाम से, जैसे instagram, tiktok या youtube।
external_ref: इस ग्राहक के लिए आपकी अपनी id, 200 अक्षर तक।partner_name: होस्टेड पेज पर दिखने वाला नाम, 80 अक्षर तक; डिफ़ॉल्ट रूप से आपके खाते का नाम।webhook_urlके साथwebhook_verify_token: केवल नंबरों के लिए, और हमेशा साथ में। नंबर कनेक्ट होते ही Meta उसके मैसेज वहाँ भेजने लगता है।
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821",
"partner_name": "ClinicApp",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"webhook_verify_token": "another-long-random-string"
}'क्या वापस आता है?
सेशन के साथ 201 मिलता है। ग्राहक को url पर भेजें, और id रखें, जो cs_ से शुरू होता है, ताकि बाद में सेशन देखा जा सके। expires_at बनने के एक घंटे बाद आता है, और ग्राहक के कनेक्ट होने पर सेशन के चैनल के अनुसार connection_id या channel_id भरता है। GET /connect-sessions/:id किसी भी समय वही संरचना लौटाता है।
{
"id": "cs_…",
"url": "https://easycoexistence.com/connect/cs_…",
"channel": "whatsapp",
"status": "created",
"external_ref": "customer_4821",
"connection_id": null,
"channel_id": null,
"token_ready": false,
"redirect_url": "https://app.example.com/connect/return",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"last_error": null,
"expires_at": "2026-10-31T15:00:00.000Z",
"opened_at": null,
"finished_at": null,
"created_at": "2026-10-31T14:00:00.000Z"
}सेशन बनाते समय कौन सी गड़बड़ियाँ आ सकती हैं?
हर गड़बड़ी का शरीर एक जैसा होता है, code और message वाला एक ऑब्जेक्ट, और message बताता है कि क्या ठीक करना है। सेशन बनाते समय ये आ सकती हैं:
- 400
invalid_jsonयाinvalid_request: बॉडी JSON ऑब्जेक्ट नहीं है, या कोई फ़ील्ड सत्यापन में विफल रहा, जैसे https न होने वालाredirect_url। - 400
channel_unavailable: यह चैनल इस खाते के लिए खुला नहीं है; message में खुले चैनलों की सूची होती है। - 401 unauthorized: API key गायब है या अमान्य है।
- 402
billing_required: खाते में अभी कार्ड नहीं है, और इसके ज़रिए जुड़ी हर चीज़ का बिल उसी पर जाता है। - 429
cap_reached: 50 सेशन पहले से खुले हैं; कुछ के पूरा होने या expire होने तक रुकें। - 429
rate_limited: इस घंटे में 100 से अधिक सेशन; message बताता है कि कितनी देर रुकना है।
बाद में ग्राहक कहाँ पहुँचता है?
आपके redirect_url पर, परिणाम उसकी query string में जुड़कर। वही परिणाम सेशन पर भी होता है, जिसे आपका बैकएंड GET /connect-sessions/:id से पढ़ता है:
- session: सेशन id, cs_ के बाद यादृच्छिक अक्षर।
- status: connected, या cancelled जब ग्राहक ने Cancel and go back चुना।
external_ref: ग्राहक के लिए आपकी id, जब सेशन में वह भेजी गई थी।connection_id: नए नंबर की id, /connections के लिए।channel_id: नए सोशल खाते की id, /channels के लिए।
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…सेशन के कौन से स्टेटस हो सकते हैं?
पाँच। GET /connect-sessions/:id वर्तमान स्टेटस बताता है, साथ में opened_at, finished_at और last_error, जो बताता है कि नवीनतम प्रयास क्यों विफल रहा:
- created: आपके बैकएंड ने बनाया, अभी तक खुला नहीं।
- opened: ग्राहक ने होस्टेड पेज लोड किया है।
- connected: एक नंबर या सोशल खाता जुड़ गया, और उसकी id सेशन पर है।
- cancelled: ग्राहक Cancel and go back से बाहर निकला।
- expired: सेशन पूरा होने से पहले घंटा समाप्त हो गया।
लिंक कितनी देर काम करता है?
बनने के एक घंटे तक। उसके बाद होस्टेड पेज ग्राहक को बताता है कि लिंक समाप्त हो गया है, साथ में आपके redirect_url पर वापस जाने का बटन जिस पर status=cancelled लिखा होता है, और सेशन expired दिखता है। एक खाता 50 खुले सेशन रख सकता है और प्रति घंटे 100 बना सकता है, क्योंकि Meta हर पहली बार के ऑनबोर्डिंग को एक ऐप-व्यापी सीमा में गिनता है, जो हर खाते में साझा है।
external_ref क्या करता है?
यह हर कनेक्शन को आपके ग्राहक से जोड़ता है। आपके भेजे मान को उस नंबर या चैनल पर सहेजा जाता है जो सेशन बनाता है, redirect में जोड़ा जाता है, और उसके बारे में हर स्टेटस इवेंट में शामिल होता है, इसलिए GET /connections?external_ref=customer_4821 और GET /channels?external_ref=customer_4821 बताते हैं कि वह ग्राहक क्या जोड़ चुका है। Facebook या LinkedIn साइन-इन एक साथ कई Pages ला सकता है: redirect पहला नाम बताता है, और फ़िल्टर बाकी सूचीबद्ध करता है। अपने डेटाबेस की स्थिर id लें, ईमेल नहीं जो बदल सकता है।
अगर ग्राहक रद्द करे या साइन-इन विफल हो तो?
यह इस पर निर्भर है कि क्या हुआ, और सेशन रिकॉर्ड रखता है:
- Meta का पॉपअप विफल हो या बंद हो: लिंक खुला रहने तक ग्राहक उसी पेज पर फिर से Connect दबा सकता है।
- सोशल साइन-इन रद्द या अस्वीकार हो: ग्राहक कारण के साथ होस्टेड पेज पर लौटता है और लिंक समाप्त होने तक फिर कोशिश कर सकता है।
- खाता किसी और easyCoexistence खाते के ज़रिए पहले से जुड़ा है:
last_errorयही बताता है, और ग्राहक किसी दूसरे खाते से साइन इन करता है। - ग्राहक Cancel and go back चुने: आपके
redirect_urlको status=cancelled मिलता है और सेशन बंद होता है, इसलिए दूसरी कोशिश के लिए नया सेशन बनाएँ। - लिंक समाप्त हो गया: नया सेशन बनाएँ।
अगर नंबर ग्राहक के टोकन के बिना जुड़ जाए तो?
Meta कभी-कभी Embedded Signup को ग्राहक का अपना बिज़नेस टोकन जारी किए बिना पूरा कर देता है। तब होस्टेड पेज एक और चरण माँगता है, जिसमें कुछ सेकंड लगते हैं। अगर ग्राहक उसे छोड़ दे, तो सेशन connected token_ready false के साथ दिखता है और आपके events URL पर connection.token_missing आता है: नंबर को मैसेज मिलते हैं, क्योंकि उसकी ids मान्य हैं, पर वह तब तक भेज नहीं सकता जब तक नया कनेक्ट सेशन उसे फिर से जोड़कर टोकन जारी न करे।
अगर webhook_url Meta की जाँच में विफल हो तो?
नंबर फिर भी जुड़ जाता है। Meta webhook_url की जाँच GET हैंडशेक से करता है, जिसे आपका एंडपॉइंट पास करता है जब hub.verify_token मेल खाए और hub.challenge वापस भेजे। विफल होने पर सेशन का last_error webhook_url was not applied से शुरू होता है और Meta का कारण देता है, और जब एंडपॉइंट जवाब देने लगे तब PUT /connections/:id/webhook गंतव्य सेट करता है। कनेक्ट होने के 24 घंटे के भीतर सेट हो तो यह संपर्कों का एक-बार आयात और, अगर ग्राहक ने साझा करने की सहमति दी हो, चैट इतिहास भी प्राप्त करता है।
ग्राहक क्या देखता है?
easycoexistence.com का एक पेज, जिस पर partner_name से आपका नाम होता है, और भरने के लिए कोई खाता, ईमेल या कार्ड नहीं। WhatsApp नंबर के लिए यह एक छोटी पात्रता सूची दिखाता है, फिर Meta का पॉपअप और WhatsApp Business ऐप से स्कैन करने वाला QR कोड। सोशल खाते के लिए यह एक बटन दिखाता है, जैसे Continue with TikTok, जो उसी टैब में नेटवर्क की अपनी सहमति स्क्रीन खोलता है, इसलिए फ़ोन पर भी काम करता है।
आम गड़बड़ियाँ
- केवल query string पर भरोसा करना। कोई भी URL में status=connected लिख सकता है, इसलिए ग्राहक को connected मानने से पहले अपने बैकएंड से GET /connect-sessions/:id द्वारा पुष्टि करें।
- लिंक को iframe में एम्बेड करना। ग्राहक को redirect या नए टैब से भेजें, क्योंकि होस्टेड पेज और उससे खुलने वाले साइन-इन इसी तरह चलने के लिए बने हैं।
- लिंक पहले से बनाकर रखना। हर लिंक एक घंटे चलता है और हर खुला सेशन 50 की सीमा में गिना जाता है, इसलिए सेशन तब बनाएँ जब ग्राहक जुड़ने वाला हो।
- 200 अक्षरों से लंबा webhook_url भेजना। Meta वैकल्पिक callback URL 200 अक्षर तक स्वीकार करता है, इसलिए लंबा URL लागू नहीं होता और नंबर उसके बिना जुड़ता है।
easyCoexistence आपके ग्राहकों के WhatsApp नंबर और उनके Instagram, Facebook, TikTok, YouTube और LinkedIn खाते, तथा अन्य चैनल, एक होस्टेड लिंक के ज़रिए आपके सॉफ़्टवेयर से जोड़ता है, फिर आपके बैकएंड को हर कनेक्शन के क्रेडेंशियल, webhooks और साइन किए गए स्टेटस इवेंट देता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने के साथ घटती दर, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या एक कनेक्ट लिंक दो बार इस्तेमाल हो सकता है?
नहीं। लिंक एक नंबर या एक सोशल साइन-इन पर पूरा होता है, जो Facebook या LinkedIn पर कई Pages ला सकता है। उसके बाद वह connected दिखाता है, इसलिए अगले कनेक्शन के लिए नया सेशन बनाएँ।
क्या मैं लिंक ईमेल या चैट से भेज सकता हूँ?
हाँ, बशर्ते ग्राहक उसे एक घंटे के भीतर खोल ले। URL में मौजूद सेशन id ही पेज को अधिकृत करती है, इसलिए हर लिंक केवल उसी ग्राहक को भेजें जिसके लिए वह बना था।
क्या होस्टेड पेज फ़ोन पर काम करता है?
सोशल साइन-इन करते हैं, क्योंकि वे उसी टैब में खुलते हैं। WhatsApp नंबर कंप्यूटर से जोड़ना सबसे अच्छा है: फ़ोन पर Meta का पॉपअप नए टैब में खुलता है, और QR कोड स्कैन करने के लिए फ़ोन की ज़रूरत होती है।
बिना polling के मुझे कैसे पता चले कि ग्राहक जुड़ गया?
डैशबोर्ड में Profile, Developers के अंतर्गत एक status events URL सेट करें। कनेक्शन बनते ही easyCoexistence connection.connected या channel.connected भेजता है, साइन किया हुआ और आपका external_ref लिए हुए।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित