तुमच्या ॲपशी वापरकर्त्यांना WhatsApp, Instagram आणि TikTok खाती जोडू देणे
तुमच्या वापरकर्त्यांना त्यांची WhatsApp, Instagram आणि TikTok खाती तुमच्या ॲपशी जोडू देण्यासाठी easyCoexistence च्या पार्टनर एपीआयवर कनेक्ट सेशन तयार करा आणि वापरकर्त्याला त्याच्या होस्टेड यूआरएलवर पाठवा. तिथे ते Meta च्या Embedded Signup द्वारे WhatsApp नंबर जोडतात, किंवा Instagram, Facebook, TikTok, YouTube, LinkedIn आणि आणखी चॅनेलवर साइन इन करतात, मग नवीन कनेक्शन किंवा channel_id सह तुमच्या redirect_url वर परत येतात. लिंक एक तास वैध राहते.
कनेक्ट लिंक किती काळ चालते; त्यानंतर सेशन कालबाह्य दिसते आणि नवीन लिंक लागते.
एक खाते एकाच वेळी किती कनेक्ट सेशन उघडे ठेवू शकते, आणि तासाला 100 नवीन सेशनची मर्यादा आहे.
सेशन तयार होते, उघडते, जोडले जाते, रद्द होते किंवा कालबाह्य होते; GET /connect-sessions/:id हे नोंदवते.
Meta एखाद्या WhatsApp नंबरचे वेबहुक मेसेज इतरत्र वळवण्यासाठी स्वीकारते ती सर्वात लांब पर्यायी कॉलबॅक यूआरएल.
कनेक्ट लिंक कसे काम करते?
चेकआउट पेजसारखे. तुमचा बॅकएंड सेशन तयार करतो, तुमचा इंटरफेस ग्राहकाला त्याच्या यूआरएलवर पाठवतो, ग्राहक easycoexistence.com वरील पेजवर कनेक्ट करतो आणि ब्राउझर तुमच्या redirect_url वर परत येतो. त्यानंतर तुमचा बॅकएंड निकालाची खात्री करतो आणि नवीन कनेक्शनचे क्रेडेंशियल्स मिळवतो, हे सर्व तुमच्या एपीआय की सह.
विनंतीत काय असते?
https://easycoexistence.com/api/v1/connect-sessions वर पोस्ट केलेली JSON बॉडी, सोबत Bearer टोकन म्हणून तुमची एपीआय की. फक्त redirect_url आवश्यक आहे:
redirect_url: https यूआरएल, जिथे ग्राहक नंतर उतरतो.- channel: whatsapp, डीफॉल्ट, किंवा तुमच्या खात्यासाठी उघडे असलेले सोशल नेटवर्क, त्याच्या लोअरकेस नावाने, जसे की instagram, tiktok किंवा youtube.
external_ref: या ग्राहकासाठी तुमचा स्वतःचा आयडी, 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 सह सेशन. ग्राहकाला यूआरएलवर पाठवा आणि नंतर सेशन पाहण्यासाठी 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 आणि मेसेज असलेली ऑब्जेक्ट, आणि मेसेज सांगते काय दुरुस्त करायचे. सेशन तयार करताना येऊ शकते:
- 400
invalid_jsonकिंवाinvalid_request: बॉडी JSON ऑब्जेक्ट नाही, किंवा एखादे फील्ड पडताळणीत नापास झाले, जसे https नसलेलाredirect_url. - 400
channel_unavailable: हे चॅनेल या खात्यासाठी उघडे नाही; मेसेजमध्ये उघडे असलेल्यांची यादी असते. - 401 unauthorized: एपीआय की गहाळ किंवा अवैध आहे.
- 402
billing_required: खात्यावर अजून कार्ड नाही, आणि त्याद्वारे जोडलेले सर्व काही त्यावर बिलिंग होते. - 429
cap_reached: 50 सेशन आधीच उघडे आहेत; काही पूर्ण होण्याची किंवा कालबाह्य होण्याची वाट पाहा. - 429
rate_limited: या तासात 100 पेक्षा जास्त सेशन; किती वेळ थांबायचे ते मेसेज सांगते.
ग्राहक नंतर कुठे उतरतो?
तुमच्या redirect_url वर, परिणाम क्वेरी स्ट्रिंगमध्ये जोडून. तोच परिणाम सेशनवरही असतो, जो तुमचा बॅकएंड GET /connect-sessions/:id ने वाचतो:
- session: सेशन आयडी, cs_ नंतर यादृच्छिक अक्षरे.
- status: connected, किंवा ग्राहकाने रद्द करा आणि मागे जा निवडल्यास cancelled.
external_ref: तुमच्या ग्राहकाचा आयडी, सेशनमध्ये असल्यास.connection_id: नवीन नंबराचा आयडी, /connections साठी.channel_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: नंबर किंवा सोशल खाते जोडले गेले, आणि त्याचा आयडी सेशनवर आहे.
- cancelled: ग्राहक रद्द करा आणि मागे जा द्वारे बाहेर पडला.
- expired: सेशन पूर्ण होण्याआधी तास संपला.
लिंक किती काळ चालते?
तयार झाल्यापासून एक तास. त्यानंतर होस्टेड पेज ग्राहकाला सांगते की लिंक कालबाह्य झाली आहे, आणि status=cancelled अशी खूण असलेल्या बटणासह तुमच्या redirect_url वर परत जाण्याची सोय देते, आणि सेशन कालबाह्य दिसते. खाते एकाच वेळी 50 उघडे सेशन ठेवू शकते आणि तासाला 100 तयार करू शकते, कारण Meta प्रत्येक पहिल्यांदाच्या ऑनबोर्डिंगला सर्व खाती सामायिक करत असलेल्या ॲप-व्यापी मर्यादेत मोजते.
external_ref काय करतो?
प्रत्येक कनेक्शन तुमच्या ग्राहकाशी जोडतो. तुम्ही पाठवलेले मूल्य सेशन तयार करत असलेल्या नंबर किंवा चॅनेलवर साठवले जाते, रीडायरेक्टमध्ये जोडले जाते आणि त्याबद्दलच्या प्रत्येक स्टेटस इव्हेंटमध्ये समाविष्ट केले जाते. त्यामुळे GET /connections?external_ref=customer_4821 आणि GET /channels?external_ref=customer_4821 हे ग्राहकाने काय जोडले आहे ते यादीत दाखवतात. Facebook किंवा LinkedIn साइन-इन एकाच वेळी अनेक पेजेस आणू शकते: रीडायरेक्टमध्ये पहिले नाव असते, आणि फिल्टर उरलेली यादी दाखवतो. तुमच्या डेटाबेसमधील स्थिर आयडी वापरा, बदलू शकणारा ईमेल नाही.
ग्राहकाने रद्द केले किंवा साइन-इन अयशस्वी झाले तर?
ते कुठे घडले यावर अवलंबून असते, आणि सेशन नोंद ठेवते:
- Meta चा पॉपअप अयशस्वी झाला किंवा बंद केला: लिंक उघडी असताना ग्राहक त्याच पेजवर पुन्हा Connect दाबतो.
- सोशल साइन-इन रद्द किंवा नाकारले: ग्राहक कारणासह होस्टेड पेजवर परत येतो आणि लिंक कालबाह्य होईपर्यंत पुन्हा प्रयत्न करू शकतो.
- खाते आधीच दुसऱ्या easyCoexistence खात्याद्वारे जोडलेले आहे:
last_errorहे सांगते, आणि ग्राहक वेगळ्या खात्याने साइन इन करतो. - ग्राहक रद्द करा आणि मागे जा निवडतो: तुमच्या
redirect_urlला status=cancelled मिळते आणि सेशन बंद होते, म्हणून दुसऱ्या प्रयत्नासाठी नवीन सेशन तयार करा. - लिंक कालबाह्य झाली: नवीन सेशन तयार करा.
नंबर ग्राहकाच्या टोकनशिवाय जोडला गेला तर?
Meta कधी कधी ग्राहकाचे स्वतःचे व्यवसाय टोकन जारी न करता Embedded Signup पूर्ण करते. होस्टेड पेज मग आणखी एक फेरी मागते, जी काही सेकंद घेते. ग्राहक ती वगळल्यास सेशन token_ready false सह connected वाचले जाते, आणि तुमच्या इव्हेंट यूआरएलवर connection.token_missing येते: नंबरला मेसेज मिळतात, कारण त्याचे आयडी वैध आहेत, पण नवीन कनेक्ट सेशन त्याला पुन्हा जोडून टोकन जारी करेपर्यंत तो पाठवू शकत नाही.
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, जे त्याच टॅबमध्ये नेटवर्कचा स्वतःचा संमती पडदा उघडते, त्यामुळे फोनवरही चालते.
सामान्य चुका
- क्वेरी स्ट्रिंगवर एकट्याने विश्वास ठेवणे. कोणीही यूआरएलमध्ये status=connected टाइप करू शकतो, म्हणून ग्राहकाला जोडलेले म्हणून चिन्हांकित करण्यापूर्वी तुमच्या बॅकएंडवरून GET /connect-sessions/:id ने पुष्टी करा.
- लिंक iframe मध्ये एम्बेड करणे. ग्राहकाला रीडायरेक्ट किंवा नवीन टॅबद्वारे पाठवा, कारण होस्टेड पेज आणि ते उघडणारे साइन-इन असेच चालायला हवेत.
- लिंक आगाऊ तयार करणे. प्रत्येक लिंक एक तास चालते आणि प्रत्येक उघडी लिंक 50 च्या मर्यादेत मोजली जाते, म्हणून ग्राहक जोडणार असतानाच सेशन तयार करा.
- 200 अक्षरांपेक्षा लांब webhook_url पाठवणे. Meta 200 अक्षरांपर्यंतचे पर्यायी कॉलबॅक यूआरएल स्वीकारते, त्यामुळे लांब यूआरएल लागू होत नाही आणि नंबर त्याशिवाय जोडला जातो.
easyCoexistence तुमच्या ग्राहकांचे WhatsApp नंबर आणि त्यांची Instagram, Facebook, TikTok, YouTube व LinkedIn खाती, तसेच आणखी चॅनेल, एका होस्टेड लिंकद्वारे तुमच्या सॉफ्टवेअरशी जोडते, आणि मग तुमच्या बॅकएंडला प्रत्येक कनेक्शनचे क्रेडेंशियल्स, वेबहुक आणि स्वाक्षरी केलेले स्टेटस इव्हेंट देते. प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, तुम्ही अधिक कनेक्शन जोडता तसे कमी होत जाते, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
एक कनेक्ट लिंक दोनदा वापरता येते का?
नाही. लिंक एका नंबराने, किंवा एका सोशल साइन-इनने पूर्ण होते, जे Facebook किंवा LinkedIn वर अनेक पेजेस आणू शकते. त्यानंतर ती connected दिसते, म्हणून पुढील कनेक्शनसाठी नवीन सेशन तयार करा.
लिंक ईमेल किंवा चॅटने पाठवता येते का?
हो, ग्राहकाने तास संपण्यापूर्वी ती उघडली तर. यूआरएलमधील सेशन आयडी पेजला अधिकृत करतो, म्हणून प्रत्येक लिंक फक्त ज्या ग्राहकासाठी बनवली आहे त्यालाच पाठवा.
होस्टेड पेज फोनवर चालते का?
सोशल साइन-इन चालतात, कारण ते त्याच टॅबमध्ये उघडतात. WhatsApp नंबर संगणकावरून जोडणे सर्वोत्तम आहे: फोनवर Meta चा पॉपअप नवीन टॅबमध्ये उघडतो, आणि QR कोड स्कॅन करण्यासाठी फोनचीच गरज असते.
पोलिंग न करता ग्राहक जोडला गेला हे कसे कळेल?
डॅशबोर्डमध्ये Profile, Developers अंतर्गत स्टेटस इव्हेंट यूआरएल सेट करा. कनेक्शन होताच easyCoexistence connection.connected किंवा channel.connected पाठवते, स्वाक्षरी केलेले आणि तुमचा external_ref सोबत असलेले.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: