लॉग इनमोफत ट्रायल सुरू करा
easyCoexistence अधिकृत एपीआय

तुमच्या ॲपशी वापरकर्त्यांना WhatsApp, Instagram आणि TikTok खाती जोडू देणे

तुमच्या वापरकर्त्यांना त्यांची WhatsApp, Instagram आणि TikTok खाती तुमच्या ॲपशी जोडू देण्यासाठी easyCoexistence च्या पार्टनर एपीआयवर कनेक्ट सेशन तयार करा आणि वापरकर्त्याला त्याच्या होस्टेड यूआरएलवर पाठवा. तिथे ते Meta च्या Embedded Signup द्वारे WhatsApp नंबर जोडतात, किंवा Instagram, Facebook, TikTok, YouTube, LinkedIn आणि आणखी चॅनेलवर साइन इन करतात, मग नवीन कनेक्शन किंवा channel_id सह तुमच्या redirect_url वर परत येतात. लिंक एक तास वैध राहते.

1 hour

कनेक्ट लिंक किती काळ चालते; त्यानंतर सेशन कालबाह्य दिसते आणि नवीन लिंक लागते.

50 open

एक खाते एकाच वेळी किती कनेक्ट सेशन उघडे ठेवू शकते, आणि तासाला 100 नवीन सेशनची मर्यादा आहे.

5 statuses

सेशन तयार होते, उघडते, जोडले जाते, रद्द होते किंवा कालबाह्य होते; GET /connect-sessions/:id हे नोंदवते.

200 characters

Meta एखाद्या WhatsApp नंबरचे वेबहुक मेसेज इतरत्र वळवण्यासाठी स्वीकारते ती सर्वात लांब पर्यायी कॉलबॅक यूआरएल.

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

चेकआउट पेजसारखे. तुमचा बॅकएंड सेशन तयार करतो, तुमचा इंटरफेस ग्राहकाला त्याच्या यूआरएलवर पाठवतो, ग्राहक easycoexistence.com वरील पेजवर कनेक्ट करतो आणि ब्राउझर तुमच्या redirect_url वर परत येतो. त्यानंतर तुमचा बॅकएंड निकालाची खात्री करतो आणि नवीन कनेक्शनचे क्रेडेंशियल्स मिळवतो, हे सर्व तुमच्या एपीआय की सह.

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 बॉडी, सोबत Bearer टोकन म्हणून तुमची एपीआय की. फक्त redirect_url आवश्यक आहे:

  • redirect_url: https यूआरएल, जिथे ग्राहक नंतर उतरतो.
  • channel: whatsapp, डीफॉल्ट, किंवा तुमच्या खात्यासाठी उघडे असलेले सोशल नेटवर्क, त्याच्या लोअरकेस नावाने, जसे की instagram, tiktok किंवा youtube.
  • external_ref: या ग्राहकासाठी तुमचा स्वतःचा आयडी, 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 सह सेशन. ग्राहकाला यूआरएलवर पाठवा आणि नंतर सेशन पाहण्यासाठी 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 आणि मेसेज असलेली ऑब्जेक्ट, आणि मेसेज सांगते काय दुरुस्त करायचे. सेशन तयार करताना येऊ शकते:

  • 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 साठी.
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: नंबर किंवा सोशल खाते जोडले गेले, आणि त्याचा आयडी सेशनवर आहे.
  • 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 सोबत हे करताना

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 Embedded Signup: स्वतःचे Tech Provider ॲप किंवा होस्ट केलेले पेजSaaS ग्राहकांचे WhatsApp नंबर Coexistence सह कसे जोडते: Meta ची अट, होस्ट केलेले पेज आणि ग्राहकांना दिसणारे टप्पे.Partner API प्रमाणीकरण: Bearer ec_live_ की, बदल आणि 401 त्रुटीPartner API विनंत्या कशा प्रमाणित होतात: प्रत्येक खात्याला एक ec_live_ की, एकदाच दिसणारी, आणि 401 त्रुटी.Partner API मर्यादा आणि नियम: Meta ची धोरणे, प्रति सेकंद 20 मेसेज आणि 14 दिवसांचा नियमप्लॅटफॉर्मनी ग्राहकांच्या चॅनेलसाठी पाळायचे नियम: Meta ची WhatsApp धोरणे, प्रति सेकंद 20 मेसेज आणि 14 दिवसांचा नियम.नंबर कनेक्ट करणे, टप्प्याटप्प्यानेCoexistence द्वारे नंबर कनेक्ट करताना काय घडते, व्यवसाय मालकाने काय करायचे आणि कोणते निर्णय नंतर बदलता येत नाहीत.Coexistence साठी कोणते नंबर पात्र आहेतॲपची आवृत्ती, खात्याचा प्रकार, पोर्टफोलिओचा प्रवेश आणि Coexistence ऑनबोर्डिंगमध्ये Meta नंबर का नाकारते.AI एजंटसाठी सोशल मीडिया API: प्रकाशित करा, शेड्युल करा, उत्तर द्या आणि मोजमाप कराAI एजंटसाठी एकच API आणि MCP सर्व्हर. प्रत्येक सोशल नेटवर्कवर प्रकाशित करा, शेड्युल करा, उत्तर द्या आणि आकडेवारी पाहा, अधिकृत API द्वारे.

तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.

कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.

  • 3 दिवस मोफत
  • कधीही रद्द करा
  • फक्त अधिकृत एपीआय
  • 24/7 देखरेख

पडताळले: