మీ వినియోగదారులు WhatsApp, Instagram మరియు TikTok ఖాతాలను మీ యాప్కు ఎలా కనెక్ట్ చేయవచ్చు
మీ వినియోగదారులు WhatsApp, Instagram మరియు TikTok ఖాతాలను మీ యాప్కు కనెక్ట్ చేయాలంటే, easyCoexistence Partner API తో కనెక్ట్ సెషన్ సృష్టించి, వినియోగదారును దాని హోస్ట్ చేసిన URLకు పంపండి. అక్కడ వారు Meta యొక్క Embedded Signup ద్వారా WhatsApp నంబర్ను కనెక్ట్ చేస్తారు, లేదా Instagram, Facebook, TikTok, YouTube, LinkedIn మరియు మరిన్ని ఛానెళ్లలో సైన్ ఇన్ చేస్తారు. తర్వాత కొత్త కనెక్షన్ లేదా ఛానెల్ id తో మీ redirect_url కు తిరిగి వస్తారు. లింక్లు ఒక గంట పాటు చెల్లుతాయి.
కనెక్ట్ లింక్ ఎంతసేపు పనిచేస్తుంది; ఆ తర్వాత సెషన్ స్టేటస్ expired గా కనిపిస్తుంది, కొత్తది అవసరం.
ఒక ఖాతా ఒకేసారి తెరిచి ఉంచగల కనెక్ట్ సెషన్లు, గంటకు 100 కొత్త సెషన్ల పరిమితితో పాటు.
GET /connect-sessions/:id నివేదించే ప్రకారం, సెషన్ created, opened, connected, cancelled లేదా expired స్టేటస్లకు చేరుతుంది.
WhatsApp నంబర్ మెసేజ్ వెబ్హుక్లను వేరే చోటికి మళ్లించేందుకు Meta అంగీకరించే అత్యధిక ప్రత్యామ్నాయ కాల్బ్యాక్ URL పొడవు.
కనెక్ట్ లింక్ ఎలా పనిచేస్తుంది?
చెక్అవుట్ పేజీలా. మీ బ్యాకెండ్ సెషన్ సృష్టిస్తుంది, మీ ఇంటర్ఫేస్ వినియోగదారును దాని URLకు పంపుతుంది, వినియోగదారు easycoexistence.com లోని పేజీలో కనెక్ట్ అవుతారు, బ్రౌజర్ మీ redirect_url కు తిరిగి వస్తుంది. తర్వాత మీ బ్యాకెండ్ ఫలితాన్ని నిర్ధారించి, కొత్త కనెక్షన్ యొక్క క్రెడెన్షియల్స్ను తీసుకుంటుంది, అన్నీ మీ API కీతోనే.
అభ్యర్థనలో ఏమి ఉంటుంది?
https://easycoexistence.com/api/v1/connect-sessions కు JSON బాడీ పంపాలి, మీ 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 కు పంపండి, మరియు cs_ తో మొదలయ్యే id ను ఉంచుకోండి, తర్వాత సెషన్ను వెతకడానికి. expires_at సృష్టించిన ఒక గంట తర్వాత ముగుస్తుంది, మరియు సెషన్ channel ను బట్టి, వినియోగదారు కనెక్ట్ అయిన వెంటనే 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: ఈ ఖాతాకు ఛానెల్ తెరిచి లేదు; మెసేజ్లో తెరిచి ఉన్నవి జాబితా చేయబడతాయి. - 401 unauthorized: API key లేదు లేదా చెల్లదు.
- 402
billing_required: ఖాతాకు ఇంకా కార్డు లేదు, దాని ద్వారా కనెక్ట్ అయిన అన్నింటికీ దానికే బిల్ చేయబడుతుంది. - 429
cap_reached: ఇప్పటికే 50 సెషన్లు తెరిచి ఉన్నాయి; కొన్ని ముగిసే లేదా గడువు ముగిసే వరకు వేచి ఉండండి. - 429
rate_limited: ఈ గంటలో 100 కంటే ఎక్కువ సెషన్లు; ఎంతసేపు వేచి ఉండాలో మెసేజ్ చెబుతుంది.
తర్వాత వినియోగదారు ఎక్కడికి చేరుతారు?
మీ redirect_url కు, ఫలితం దాని query string కు జోడించబడి. అదే ఫలితం సెషన్పై కూడా ఉంటుంది, దాన్ని మీ బ్యాకెండ్ GET /connect-sessions/:id ద్వారా చదువుతుంది:
- session: సెషన్ id, cs_ తర్వాత యాదృచ్ఛిక అక్షరాలు.
- status: connected, లేదా వినియోగదారు Cancel and go back ఎంచుకుంటే cancelled.
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 తో. ఇటీవలి ప్రయత్నం ఎందుకు విఫలమైందో last_error చెబుతుంది:
- created: మీ బ్యాకెండ్ సృష్టించింది, ఇంకా తెరవలేదు.
- opened: వినియోగదారు హోస్ట్ చేసిన పేజీని లోడ్ చేశారు.
- connected: ఒక నంబర్ లేదా సోషల్ ఖాతా కనెక్ట్ అయింది, దాని id సెషన్పై ఉంటుంది.
- cancelled: వినియోగదారు Cancel and go back ద్వారా నిష్క్రమించారు.
- expired: సెషన్ ముగియకముందే గంట గడిచిపోయింది.
లింక్ ఎంతసేపు పనిచేస్తుంది?
సృష్టించిన తర్వాత ఒక గంట. ఆ తర్వాత హోస్ట్ చేసిన పేజీ వినియోగదారుకు లింక్ గడువు ముగిసిందని చెబుతుంది, status=cancelled గా గుర్తించబడి redirect_url కు తిరిగి వెళ్లే బటన్తో, మరియు సెషన్ expired గా కనిపిస్తుంది. ఒక ఖాతా 50 తెరిచిన సెషన్లను ఉంచగలదు మరియు గంటకు 100 సృష్టించగలదు, ఎందుకంటే ప్రతి మొదటిసారి ఆన్బోర్డింగ్ను Meta, ప్రతి ఖాతా పంచుకునే యాప్-వ్యాప్త పరిమితికి వ్యతిరేకంగా లెక్కిస్తుంది.
external_ref ఏమి చేస్తుంది?
ప్రతి కనెక్షన్ను మీ వినియోగదారుకు ముడిపెడుతుంది. మీరు పంపిన విలువ సెషన్ సృష్టించిన నంబర్ లేదా ఛానెల్పై నిల్వ అవుతుంది, రీడైరెక్ట్కు జోడించబడుతుంది, మరియు దాని గురించిన ప్రతి స్టేటస్ ఈవెంట్లో చేర్చబడుతుంది. అందువల్ల GET /connections?external_ref=customer_4821 మరియు GET /channels?external_ref=customer_4821 ఆ వినియోగదారు కనెక్ట్ చేసినవన్నీ జాబితా చేస్తాయి. Facebook లేదా LinkedIn సైన్-ఇన్ ఒకేసారి అనేక Pages ఇవ్వగలదు: రీడైరెక్ట్ మొదటిదాన్ని పేర్కొంటుంది, ఫిల్టర్ మిగిలినవాటిని జాబితా చేస్తుంది. మీ స్వంత డేటాబేస్ నుంచి స్థిరమైన id ఉపయోగించండి, మారగల ఇమెయిల్ కాదు.
వినియోగదారు రద్దు చేస్తే లేదా సైన్-ఇన్ విఫలమైతే?
ఇది ఎక్కడ జరిగిందనే దానిపై ఆధారపడుతుంది, మరియు సెషన్ రికార్డును ఉంచుతుంది:
- Meta పాప్అప్ విఫలమైతే లేదా మూసివేస్తే: లింక్ తెరిచి ఉన్నప్పుడు, వినియోగదారు అదే పేజీలో మళ్లీ Connect నొక్కాలి.
- సోషల్ సైన్-ఇన్ రద్దయితే లేదా తిరస్కరిస్తే: వినియోగదారు కారణంతో హోస్ట్ చేసిన పేజీకి తిరిగి వస్తారు, మరియు లింక్ గడువు ముగిసే వరకు మళ్లీ ప్రయత్నించవచ్చు.
- ఖాతా ఇప్పటికే మరొక easyCoexistence ఖాతా ద్వారా కనెక్ట్ అయి ఉంటే:
last_errorఅదే చెబుతుంది, మరియు వినియోగదారు వేరే ఖాతాతో సైన్ ఇన్ చేయాలి. - వినియోగదారు Cancel and go back ఎంచుకుంటే: మీ
redirect_urlకు status=cancelled వస్తుంది మరియు సెషన్ మూసివేయబడుతుంది, కాబట్టి మరో ప్రయత్నానికి కొత్తది సృష్టించండి. - లింక్ గడువు ముగిసింది: కొత్త సెషన్ సృష్టించండి.
వినియోగదారు టోకెన్ లేకుండా నంబర్ కనెక్ట్ అయితే?
Meta కొన్నిసార్లు వినియోగదారు సొంత వ్యాపార టోకెన్ జారీ చేయకుండానే Embedded Signup ను పూర్తి చేస్తుంది. అప్పుడు హోస్ట్ చేసిన పేజీ మరోసారి ప్రక్రియ చేయమని అడుగుతుంది, దానికి కొన్ని సెకన్లు పడుతుంది. వినియోగదారు దాటవేస్తే, సెషన్ token_ready false తో connected గా కనిపిస్తుంది, మరియు మీ events URL కు connection.token_missing వస్తుంది: నంబర్ మెసేజ్లను అందుకుంటుంది, ఎందుకంటే దాని id లు చెల్లుతాయి, కానీ కొత్త కనెక్ట్ సెషన్ దాన్ని మళ్లీ కనెక్ట్ చేసి టోకెన్ జారీ చేసే వరకు పంపలేవు.
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 అక్షరాల వరకు ప్రత్యామ్నాయ కాల్బ్యాక్ URLలను అంగీకరిస్తుంది, కాబట్టి పొడవైనది వర్తించదు మరియు నంబర్ దాని లేకుండానే కనెక్ట్ అవుతుంది.
easyCoexistence మీ వినియోగదారుల WhatsApp నంబర్లను, వారి Instagram, Facebook, TikTok, YouTube మరియు LinkedIn ఖాతాలను, మరిన్ని ఛానెళ్లను, ఒకే హోస్ట్ చేసిన లింక్ ద్వారా మీ సాఫ్ట్వేర్కు కనెక్ట్ చేస్తుంది, తర్వాత మీ బ్యాకెండ్కు ప్రతి కనెక్షన్ యొక్క క్రెడెన్షియల్స్, వెబ్హుక్లు మరియు సంతకం చేసిన స్టేటస్ ఈవెంట్లను ఇస్తుంది. ప్రతి కనెక్షన్కు నెలకు US$ 9 నుంచి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించే కొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
ఒక కనెక్ట్ లింక్ను రెండుసార్లు ఉపయోగించవచ్చా?
లేదు. ఒక లింక్ ఒక నంబర్తో లేదా ఒక సోషల్ సైన్-ఇన్తో పూర్తవుతుంది, అది Facebook లేదా LinkedIn అయితే అనేక Pages తీసుకురాగలదు. ఆ తర్వాత అది connected గా కనిపిస్తుంది, కాబట్టి తదుపరి కనెక్షన్ కోసం కొత్త సెషన్ సృష్టించండి.
లింక్ను ఇమెయిల్ లేదా చాట్ ద్వారా పంపవచ్చా?
అవును, వినియోగదారు ఒక గంటలోపు తెరిస్తే. URLలోని సెషన్ id ఆ పేజీకి అధికారం ఇస్తుంది, కాబట్టి ప్రతి లింక్ను అది ఎవరి కోసం తయారైందో వారికే మాత్రమే పంపండి.
హోస్ట్ చేసిన పేజీ ఫోన్లలో పనిచేస్తుందా?
సోషల్ సైన్-ఇన్లు పనిచేస్తాయి, అవి అదే ట్యాబ్లో తెరుచుకుంటాయి కాబట్టి. WhatsApp నంబర్ను కంప్యూటర్ నుంచి కనెక్ట్ చేయడం ఉత్తమం: ఫోన్లో Meta పాప్అప్ కొత్త ట్యాబ్గా తెరుచుకుంటుంది, మరియు QR కోడ్ స్కాన్ చేయడానికి ఫోన్ స్వయంగా అవసరం.
పోలింగ్ చేయకుండా వినియోగదారు కనెక్ట్ అయ్యారని ఎలా తెలుసుకోవాలి?
డాష్బోర్డ్లో Profile, Developers కింద స్టేటస్ events URL సెట్ చేయండి. కనెక్షన్ చేసిన వెంటనే easyCoexistence connection.connected లేదా channel.connected ను పంపుతుంది, సంతకం చేసి, మీ external_ref ను మోసుకుని.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ