लॉग इनमुफ़्त ट्रायल शुरू करें
easyCoexistence आधिकारिक एपीआई

अपने उपयोगकर्ताओं को अपने ऐप में WhatsApp, Instagram और TikTok खाते जोड़ने दें

अपने उपयोगकर्ताओं को अपने ऐप में WhatsApp, Instagram और TikTok खाते जोड़ने देने के लिए, easyCoexistence के Partner API से एक कनेक्ट सेशन बनाएँ और उपयोगकर्ता को उसके होस्टेड url पर भेजें। वहाँ वे Meta के Embedded Signup से WhatsApp नंबर जोड़ते हैं या Instagram, Facebook, TikTok, YouTube, LinkedIn और अन्य चैनलों में साइन इन करते हैं, फिर नए कनेक्शन या चैनल id के साथ आपके redirect_url पर लौटते हैं। लिंक एक घंटे तक चलते हैं।

1 hour

कनेक्ट लिंक कितनी देर चलता है; उसके बाद सेशन expired दिखाता है और नया सेशन चाहिए।

50 open

एक खाता एक साथ कितने कनेक्ट सेशन खुले रख सकता है, और प्रति घंटे 100 नए सेशन की सीमा।

5 statuses

सेशन बनता है, खुलता है, कनेक्ट होता है, रद्द होता है या expire होता है, जैसा GET /connect-sessions/:id बताता है।

200 characters

Meta किसी WhatsApp नंबर के मैसेज वेबहुक को दूसरे पते पर भेजने के लिए जितना लंबा वैकल्पिक callback URL स्वीकार करता है, वह सीमा।

कनेक्ट लिंक कैसे काम करता है?

यह चेकआउट पेज की तरह है। आपका बैकएंड सेशन बनाता है, आपका इंटरफ़ेस ग्राहक को उसके url पर भेजता है, ग्राहक easycoexistence.com के एक पेज पर कनेक्ट करता है, और ब्राउज़र आपके redirect_url पर लौट आता है। फिर आपका बैकएंड परिणाम की पुष्टि करता है और नए कनेक्शन के क्रेडेंशियल लाता है, यह सब आपकी API key से।

1CreatePOST /connect-sessions from your backend
2SendA redirect or a new tab to the session's url
3ConnectMeta's Embedded Signup, or the network's own sign-in
4ReturnYour redirect_url, with the session, status and new id
5ConfirmGET /connect-sessions/:id, then the credentials

अनुरोध में क्या जाता है?

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 उसके मैसेज वहाँ भेजने लगता है।
Create a session for a WhatsApp number
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 किसी भी समय वही संरचना लौटाता है।

201 Created
{
  "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 के लिए।
A number connected
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 के साथ ऐसा करना

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 लिए हुए।

पढ़ना जारी रखें

SaaS के अपने ग्राहकों के लिए WhatsApp Embedded Signup: आपका अपना Tech Provider ऐप या होस्टेड पेजSaaS ग्राहकों के WhatsApp नंबर Coexistence से कैसे जोड़े: Meta Tech Provider से क्या माँगता है, होस्टेड पेज क्या संभालता है और ग्राहक क्या देखते हैं।Partner एपीआई प्रमाणीकरण: Bearer ec_live_ कुंजियाँ, रोटेशन और 401 गड़बड़ियाँPartner एपीआई अनुरोध प्रमाणीकरण: हर खाते की एक ec_live_ कुंजी, डैशबोर्ड या create_api_key से बनती है, एक बार दिखती है और तुरंत रोटेट होती है।Partner एपीआई सीमाएँ और नियम: Meta की नीतियाँ, प्रति सेकंड 20 मैसेज और 14-दिन का नियमग्राहकों के चैनलों पर प्लेटफ़ॉर्म के नियम: Meta की WhatsApp नीतियाँ, Coexistence नंबर पर प्रति सेकंड 20 मैसेज, 14-दिन नियम और कुंजी कब बंद होती है।नंबर जोड़ना, चरण-दर-चरणCoexistence से नंबर जोड़ने पर क्या होता है, मालिक को क्या करना होता है और कौन-सा फ़ैसला बाद में नहीं बदल सकता।Coexistence के लिए कौन से नंबर पात्र हैंऐप वर्ज़न, खाता प्रकार और पोर्टफ़ोलियो की पहुंच तय करती है कि Meta ऑनबोर्डिंग में नंबर स्वीकार करेगा या नहीं।AI एजेंट के लिए सोशल मीडिया API: पोस्ट प्रकाशित करें, शेड्यूल करें, जवाब दें और मापेंAI एजेंट के लिए एक API और MCP सर्वर: हर नेटवर्क की आधिकारिक API से पोस्ट प्रकाशित, शेड्यूल, जवाब और एनालिटिक्स।

दो मिनट में अपना पहला चैनल कनेक्ट करें।

किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।

  • 3 दिन मुफ़्त
  • कभी भी रद्द करें
  • सिर्फ़ आधिकारिक एपीआई
  • 24/7 निगरानी

इस तारीख को सत्यापित