तपाईंका प्रयोगकर्ताले आफ्नो एपमा WhatsApp, Instagram र TikTok खाता कसरी जडान गर्न सक्छन्
तपाईंका प्रयोगकर्ताले आफ्नो एपमा WhatsApp, Instagram र TikTok खाता जडान गर्न सक्छन्, त्यसका लागि easyCoexistence को Partner एपीआईमा जडान सत्र बनाउनुहोस् र प्रयोगकर्तालाई त्यसको होस्ट गरिएको यूआरएलमा पठाउनुहोस्। त्यहाँ उनीहरूले Meta को Embedded Signup मार्फत WhatsApp नम्बर जडान गर्छन्, वा Instagram, Facebook, TikTok, YouTube, LinkedIn र अन्य च्यानलमा साइन इन गर्छन्, र त्यसपछि नयाँ कनेक्सन वा च्यानल आइडीसहित तपाईंको redirect_url मा फर्कन्छन्। लिंकहरू एक घण्टासम्म मान्य हुन्छन्।
जडान लिंक कति समयसम्म चल्छ भन्ने कुरा; त्यसपछि सत्रको स्ट्याटस म्याद सकिएको देखिन्छ र नयाँ लिंक चाहिन्छ।
एउटा खाताले एकैचोटि खुला राख्न सक्ने जडान सत्रहरू, र प्रति घण्टा 100 नयाँ सत्रको सीमा।
सत्र सिर्जना हुन्छ, खुल्छ, जडान हुन्छ, रद्द हुन्छ वा म्याद सकिन्छ; GET /connect-sessions/:id ले यही अवस्था देखाउँछ।
WhatsApp नम्बरको म्यासेज वेबहुक अन्यत्र पठाउन Meta ले स्वीकार गर्ने सबैभन्दा लामो वैकल्पिक कलब्याक यूआरएल।
जडान लिंक कसरी काम गर्छ?
चेकआउट पृष्ठजस्तै। तपाईंको ब्याकएन्डले सत्र बनाउँछ, तपाईंको इन्टरफेसले ग्राहकलाई त्यसको यूआरएलमा पठाउँछ, ग्राहकले easycoexistence.com मा रहेको पृष्ठमा जडान गर्छ, र ब्राउजर तपाईंको redirect_url मा फर्कन्छ। त्यसपछि तपाईंको ब्याकएन्डले नतिजा जाँच गर्छ र नयाँ कनेक्सनको क्रेडेन्सियल ल्याउँछ, यी सबै तपाईंको एपीआई की प्रयोग गरेर।
अनुरोधमा के समावेश हुन्छ?
https://easycoexistence.com/api/v1/connect-sessions मा JSON बडी पोस्ट गरिन्छ, तपाईंको एपीआई की Bearer टोकनको रूपमा। redirect_url मात्र अनिवार्य छ:
redirect_url: ग्राहक पछि पुग्ने एउटा https यूआरएल।- channel: whatsapp (पूर्वनिर्धारित) वा तपाईंको खातामा खुला सामाजिक सञ्जालको सानो अक्षरको नाम, जस्तै tiktok, instagram वा 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 object होइन, वा कुनै फिल्ड जाँचमा असफल भयो, जस्तैredirect_urlhttps नभएको। - 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, वा ग्राहकले Cancel and go back छान्दा 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: ग्राहक Cancel and go back बाट बाहिरियो।
- expired: सत्र पूरा हुनुअघि एक घण्टा सकियो।
लिंक कति समय काम गर्छ?
सिर्जना भएदेखि एक घण्टा। त्यसपछि होस्ट गरिएको पृष्ठले ग्राहकलाई लिंकको म्याद सकिएको बताउँछ, साथमा तपाईंको redirect_url मा फर्कने बटन जसमा status=cancelled चिन्ह लगाइएको छ, र सत्र म्याद सकिएको पढिन्छ। खातामा 50 खुला सत्र राख्न सकिन्छ र प्रति घण्टा 100 सिर्जना गर्न सकिन्छ, किनभने Meta ले हरेक पहिलो पटकको अनबोर्डिङलाई सबै खाताले बाँडेको एप-व्यापी सीमाविरुद्ध गन्छ।
external_ref ले के गर्छ?
यसले हरेक जडानलाई तपाईंको ग्राहकसँग जोड्छ। तपाईंले पठाएको मान सत्रले बनाउने नम्बर वा च्यानलमा भण्डारण हुन्छ, रिडाइरेक्टमा थपिन्छ, र त्यससम्बन्धी हरेक स्ट्याटस इभेन्टमा समावेश हुन्छ। त्यसैले GET /connections?external_ref=customer_4821 र GET /channels?external_ref=customer_4821 ले त्यो ग्राहकले जडान गरेका सबै कुरा सूचीबद्ध गर्छन्। Facebook वा LinkedIn साइन इनले एकैचोटि धेरै पेज ल्याउन सक्छ: रिडाइरेक्टले पहिलोलाई नाम दिन्छ, र फिल्टरले बाँकी सबै सूचीबद्ध गर्छ। आफ्नै डाटाबेसको स्थिर आइडी प्रयोग गर्नुहोस्, परिवर्तन हुन सक्ने इमेल होइन।
ग्राहकले रद्द गरे वा साइन इन असफल भए के हुन्छ?
यो कहाँ भयो भन्नेमा निर्भर गर्छ, र सत्रले अभिलेख राख्छ:
- Meta को पपअप असफल भयो वा बन्द भयो: ग्राहकले लिंक खुला रहँदा उही पृष्ठमा फेरि Connect थिच्छ।
- सामाजिक साइन इन रद्द वा अस्वीकृत भयो: ग्राहक कारणसहित होस्ट गरिएको पृष्ठमा फर्कन्छ र लिंकको म्याद नसकिएसम्म फेरि प्रयास गर्न सक्छ।
- खाता अर्को easyCoexistence खातामार्फत पहिले नै जडान छ:
last_errorले यही भन्छ, र ग्राहकले फरक खाता प्रयोग गरेर साइन इन गर्छ। - ग्राहकले Cancel and go back छान्छ: तपाईंको
redirect_urlमा status=cancelled जान्छ र सत्र बन्द हुन्छ, त्यसैले अर्को प्रयासका लागि नयाँ सत्र बनाउनुहोस्। - लिंकको म्याद सकियो: नयाँ सत्र बनाउनुहोस्।
नम्बर ग्राहकको टोकनबिना जडान भयो भने के हुन्छ?
Meta कहिलेकाहीँ ग्राहकको आफ्नै व्यवसाय टोकन जारी नगरी Embedded Signup सम्पन्न गर्छ। त्यसपछि होस्ट गरिएको पृष्ठले अर्को एक पटक चलाउन माग्छ, जसमा केही सेकेन्ड लाग्छ। ग्राहकले त्यो छोडिदिएमा सत्र connected देखिन्छ, token_ready false हुन्छ, र तपाईंको इभेन्ट यूआरएलमा 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, जसले सोही ट्याबमा सञ्जालकै आफ्नै सहमति स्क्रिन खोल्छ, त्यसैले फोनमा पनि काम गर्छ।
सामान्य गल्तीहरू
- केवल क्वेरी स्ट्रिङमा भरोसा गर्नु। कसैले URL मा 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 निगरानी
प्रमाणीकरण गरिएको