ඔබේ පරිශීලකයින්ට ඔබේ යෙදුමට WhatsApp, Instagram සහ TikTok ගිණුම් සම්බන්ධ කරන්නට ඉඩ දෙන ආකාරය
ඔබේ පරිශීලකයින්ට WhatsApp, Instagram සහ TikTok ගිණුම් ඔබේ යෙදුමට සම්බන්ධ කිරීමට, easyCoexistence හි Partner API සමඟ connect session එකක් සාදා, පරිශීලකයා එහි hosted url වෙත යවන්න. එහිදී ඔවුන් Meta හි Embedded Signup හරහා WhatsApp අංකයක් සම්බන්ධ කරයි, නැතහොත් Instagram, Facebook, TikTok, YouTube, LinkedIn සහ තවත් channels වෙත පුරනය වෙයි. ඉන්පසු ඔවුන් නව සම්බන්ධතාවය හෝ channel id සමඟ ඔබේ redirect_url වෙත ආපසු පැමිණේ. Links පැය එකක් ක්රියාශීලී වේ.
පාරිභෝගිකයෙකුගේ connect link එක ක්රියා කරන කාලය; ඉන් පසු session එක expired ලෙස පෙන්වන අතර නව එකක් අවශ්ය වේ.
ගිණුමකට එකවර විවෘතව තැබිය හැකි connect sessions ගණන, සහ පැයකට නව sessions 100 ක සීමාව.
GET /connect-sessions/:id වාර්තා කරන පරිදි session එක created, opened, connected, cancelled හෝ expired විය හැක.
WhatsApp අංකයක පණිවිඩ webhook යොමු කිරීම සඳහා Meta පිළිගන්නා උපරිම දිගින් යුත් alternate callback URL එක.
connect link එකක් ක්රියා කරන්නේ කෙසේද?
checkout page එකක් මෙන්. ඔබේ backend එක session එකක් සාදයි, ඔබේ interface එක පාරිභෝගිකයා එහි url වෙත යවයි, පාරිභෝගිකයා easycoexistence.com හි පිටුවක සම්බන්ධ වෙයි, ඉන් browser එක ඔබේ redirect_url වෙත ආපසු පැමිණේ. ඉන්පසු ඔබේ backend එක ප්රතිඵලය තහවුරු කර, නව සම්බන්ධතාවයේ credentials ලබා ගනී, සියල්ල ඔබේ API key එක සමඟ.
request එකේ ඇතුළත් විය යුතු දේ මොනවාද?
https://easycoexistence.com/api/v1/connect-sessions වෙත POST කරන JSON body එකක්, ඔබේ API key එක Bearer token ලෙස සමඟ. redirect_url පමණක් අනිවාර්යයි:
redirect_url: පාරිභෝගිකයා පසුව ගොඩ බසින https URL එකක්.- channel: whatsapp, පෙරනිමිය, නැතහොත් ඔබේ ගිණුමට විවෘත සමාජ ජාලයක්, එහි lowercase නමින්, උදාහරණ ලෙස instagram, tiktok හෝ youtube.
external_ref: මෙම පාරිභෝගිකයා සඳහා ඔබේ තමන්ගේ id එක, අක්ෂර 200 දක්වා.partner_name: hosted පිටුවේ පෙන්වන නම, අක්ෂර 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"
}'ආපසු ලැබෙන්නේ මොකක්ද?
session එක සහිත 201 ප්රතිචාරයක්. පාරිභෝගිකයා url වෙත යවා, id එක (cs_ වලින් ආරම්භ වේ) තබා ගන්න, පසුව session එක සෙවීමට. expires_at සාදන වේලාවේ සිට පැයක් පසු වේ, සහ පාරිභෝගිකයා සම්බන්ධ වූ පසු connection_id හෝ channel_id පිරේ, session එකේ channel අනුව. 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"
}session එකක් සෑදීමේදී ලැබිය හැකි දෝෂ මොනවාද?
සෑම දෝෂයකටම එකම body එකක් ඇත, code සහ message සහිත object එකක්, සහ message එකෙන් කුමක් නිවැරදි කළ යුතුද යන්න කියයි. session එකක් සෑදීමෙන් ලැබිය හැක්කේ:
- 400
invalid_jsonහෝinvalid_request: body එක JSON object එකක් නොවේ, හෝ field එකක් validation අසමත් විය, උදාහරණ ලෙස https නොවනredirect_urlඑකක්. - 400
channel_unavailable: channel එක මෙම ගිණුමට විවෘත නොවේ; පණිවිඩයේ විවෘත ඒවා ලැයිස්තුගත වේ. - 401 unauthorized: API key එක නැත හෝ වලංගු නොවේ.
- 402
billing_required: ගිණුමට තවමත් card එකක් නැත, සහ එය හරහා සම්බන්ධ සියල්ල එයට බිල් කෙරේ. - 429
cap_reached: sessions 50 ක් දැනටමත් විවෘතයි; ඒවා අවසන් වන හෝ කල් ඉකුත් වන තෙක් රැඳී සිටින්න. - 429
rate_limited: මෙම පැයේ sessions 100 කට වඩා; පණිවිඩය කොපමණ වේලාවක් රැඳී සිටිය යුතුද යන්න කියයි.
පාරිභෝගිකයා පසුව ගොඩ බසින්නේ කොහේද?
ඔබේ redirect_url එකට, ප්රතිඵලය query string එකට එකතු වී. එම ප්රතිඵලය session එකේද ඇත, එය ඔබේ backend එක GET /connect-sessions/:id මගින් කියවයි:
- session: session id, cs_ ට පසු අහඹු අක්ෂර.
- status: connected, හෝ පාරිභෝගිකයා Cancel and go back තේරූ විට cancelled.
external_ref: පාරිභෝගිකයා සඳහා ඔබේ id, session එකේ එය තිබුණු විට.connection_id: නව අංකයේ id, /connections සඳහා.channel_id: නව සමාජ ගිණුමේ id, /channels සඳහා.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…session එකට ඇතිවිය හැකි status එක මොනවාද?
පහක්. GET /connect-sessions/:id වර්තමාන status එක වාර්තා කරයි, opened_at, finished_at සහ last_error සමඟ, අවසන් උත්සාහය අසමත් වූයේ ඇයිද යන්න last_error කියයි:
- created: ඔබේ backend එක සාදයි, තවම විවෘත කර නැත.
- opened: පාරිභෝගිකයා hosted පිටුව load කර ඇත.
- connected: අංකයක් හෝ සමාජ ගිණුමක් සම්බන්ධ වී ඇත, එහි id එක session එකේ ඇත.
- cancelled: පාරිභෝගිකයා Cancel and go back හරහා ඉවත් විය.
- expired: session එක අවසන් වීමට පෙර පැය අවසන් විය.
link එකක් කොපමණ වේලාවක් ක්රියා කරයිද?
සෑදූ වේලාවේ සිට පැයක්. ඉන් පසු hosted පිටුව පාරිභෝගිකයාට link එක කල් ඉකුත් වූ බව කියයි, status=cancelled ලෙස ලකුණු කළ ඔබේ redirect_url වෙත ආපසු යාමේ බොත්තමක් සහිතව, සහ session එක expired ලෙස පෙන්වයි. ගිණුමකට විවෘත sessions 50 ක් තබා ගත හැකි අතර පැයකට 100 ක් සෑදිය හැක, මන්ද Meta සෑම පළමු වාර onboarding එකක්ම app-wide සීමාවකට එරෙහිව ගණන් කරන අතර, එය සියලු ගිණුම් බෙදා ගනී.
external_ref කුමක් කරයිද?
එය සම්බන්ධතාවයක් ඔබේ පාරිභෝගිකයා හා බැඳයි. ඔබ යවන අගය session එක සාදන අංකය හෝ channel එක මත ගබඩා වේ, redirect එකට එකතු වේ, සහ එය ගැන සෑම status event එකකම ඇතුළත් වේ, එබැවින් GET /connections?external_ref=customer_4821 සහ GET /channels?external_ref=customer_4821 එම පාරිභෝගිකයා සම්බන්ධ කර ඇති දේ ලැයිස්තු ගත කරයි. Facebook හෝ LinkedIn sign-in එකකින් එකවර Pages කිහිපයක් ලැබිය හැක: redirect එකෙන් පළමුවැන්න නම් කරයි, filter එකෙන් ඉතිරි ඒවා ලැයිස්තු ගත කරයි. ඔබේ තමන්ගේ database එකෙන් ස්ථාවර id එකක් භාවිත කරන්න, වෙනස් විය හැකි email එකක් නොව.
පාරිභෝගිකයා අවලංගු කළහොත් හෝ sign-in අසමත් වූවොත් කුමක් වේද?
එය සිදු වූ තැන මත රඳා පවතී, session එක වාර්තාව තබා ගනී:
- Meta popup එක අසමත් වේ හෝ වසා දමයි: පාරිභෝගිකයා link එක විවෘතව තිබියදී එම පිටුවේම Connect නැවත එබිය යුතුය.
- සමාජ sign-in එකක් අවලංගු හෝ ප්රතික්ෂේප වේ: පාරිභෝගිකයා hosted පිටුවට හේතුව සමඟ ආපසු ගොස් link එක කල් ඉකුත් වන තෙක් නැවත උත්සාහ කළ හැක.
- ගිණුම දැනටමත් වෙනත් easyCoexistence ගිණුමක් හරහා සම්බන්ධ වී ඇත:
last_errorඑය කියයි, පාරිභෝගිකයා වෙනත් එකකින් පුරනය වේ. - පාරිභෝගිකයා Cancel and go back තෝරයි: ඔබේ
redirect_urlවෙත status=cancelled ලැබී session එක වැසේ, එබැවින් තවත් උත්සාහයක් සඳහා නව එකක් සාදන්න. - link එක කල් ඉකුත් විය: නව session එකක් සාදන්න.
පාරිභෝගිකයාගේ token නොමැතිව අංකයක් සම්බන්ධ වූවොත් කුමක් වේද?
Meta සමහර විට පාරිභෝගිකයාගේ තමන්ගේම ව්යාපාරයේ token එක නිකුත් නොකර Embedded Signup අවසන් කරයි. එවිට hosted පිටුව තවත් එක් පියවරක් ඉල්ලයි, එයට තත්පර කිහිපයක් ගතවේ. පාරිභෝගිකයා එය මඟ හැරියොත්, session එක connected ලෙස token_ready false සමඟ පෙන්වන අතර ඔබේ events URL එකට connection.token_missing ලැබේ: අංකය පණිවිඩ ලබයි, මන්ද එහි ids වලංගු වේ, නමුත් නව connect session එකක් එය නැවත සම්බන්ධ කර token එක නිකුත් කරන තෙක් යැවිය නොහැක.
webhook_url එක Meta පරීක්ෂාව අසමත් වූවොත් කුමක් වේද?
අංකය කෙසේ හෝ සම්බන්ධ වේ. Meta webhook_url එක GET handshake එකකින් පරීක්ෂා කරයි, එය ඔබේ endpoint එක hub.verify_token ගැළපෙන විට hub.challenge ප්රතිධ්වනි කිරීමෙන් සමත් වේ. අසමත් වූවොත්, session එකේ last_error එක webhook_url was not applied යනුවෙන් ආරම්භ වී Meta හේතුව ලබා දෙයි, සහ endpoint එක පිළිතුරු දුන් පසු PUT /connections/:id/webhook මගින් ගමනාන්තය සකසයි. සම්බන්ධ වීමෙන් පැය 24 ක් ඇතුළත සකසන්නේ නම්, එයට තවමත් contacts හි එක් වරක් වන ආනයනය, සහ පාරිභෝගිකයා බෙදා ගැනීමට එකඟ වුවොත් chat ඉතිහාසය, ලැබේ.
පාරිභෝගිකයා කුමක් දකිනවාද?
easycoexistence.com හි පිටුවක්, partner_name වෙතින් ඔබේ නම සමඟ, පිරවීමට ගිණුමක්, email එකක් හෝ card එකක් නැත. WhatsApp අංකයක් සඳහා එය කෙටි සුදුසුකම් පරීක්ෂා ලැයිස්තුවක් පෙන්වයි, ඉන්පසු Meta popup එක සහ WhatsApp Business යෙදුම සමඟ ස්කෑන් කිරීමට QR code එකක්. සමාජ ගිණුමක් සඳහා එය එක් බොත්තමක් පෙන්වයි, උදා Continue with TikTok, එය එම tab එකේම network එකේ අනුමැතිය ලබා ගන්නා තිරය විවෘත කරයි, එබැවින් ජංගම දුරකථනවලද ක්රියා කරයි.
සාමාන්ය වැරදි
- query string එක තනිව විශ්වාස කිරීම. ඕනෑම කෙනෙකුට URL එකක status=connected ටයිප් කළ හැක, එබැවින් පාරිභෝගිකයා සම්බන්ධ ලෙස සලකුණු කිරීමට පෙර ඔබේ backend එකෙන් GET /connect-sessions/:id මගින් තහවුරු කරන්න.
- link එක iframe එකක තැන්පත් කිරීම. redirect හෝ නව tab එකක් මගින් පාරිභෝගිකයා එයට යවන්න, එය hosted පිටුව සහ එයින් විවෘත වන sign-ins ක්රියා කරන ආකාරයයි.
- link පෙර සකස් කිරීම. සෑම එකක්ම පැයක් ක්රියා කරයි, සහ විවෘත එක් එක් 50 සීමාව දක්වා ගණන් වේ, එබැවින් පාරිභෝගිකයා සම්බන්ධ වීමට ළඟා වන විට session එක සාදන්න.
- අක්ෂර 200 ට වඩා දිගු webhook_url එකක් යැවීම. Meta alternate callback URLs අක්ෂර 200 දක්වා පිළිගනී, එබැවින් දිගු එක යෙදෙන්නේ නැති අතර අංකය එය නොමැතිව සම්බන්ධ වේ.
easyCoexistence ඔබේ පාරිභෝගිකයින්ගේ WhatsApp අංක සහ ඔවුන්ගේ Instagram, Facebook, TikTok, YouTube සහ LinkedIn ගිණුම්, තවත් channels සමඟ, එක් hosted link එකකින් ඔබේ මෘදුකාංගයට සම්බන්ධ කරයි, ඉන්පසු ඔබේ backend එකට සෑම සම්බන්ධතාවයකම credentials, webhooks සහ අත්සන් කළ status events ලබා දෙයි. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, ඔබ සම්බන්ධතා එකතු කරන තරමට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
එක් connect link එකක් දෙවරක් භාවිත කළ හැකිද?
නැත. link එකක් අවසන් වන්නේ එක් අංකයකින්, හෝ එක් සමාජ sign-in එකකින්, එය Facebook හෝ LinkedIn නම් Pages කිහිපයක් ගෙන ඒ හැක. ඉන්පසු එය connected ලෙස පෙන්වයි, එබැවින් ඊළඟ සම්බන්ධතාවය සඳහා නව session එකක් සාදන්න.
link එක email හෝ chat මගින් යැවිය හැකිද?
ඔව්, පාරිභෝගිකයා එය පැය ඇතුළත විවෘත කරන තාක්කල්. URL එකේ ඇති session id එක පිටුව අනුමත කරයි, එබැවින් එක් එක් link එක එය සාදන ලද පාරිභෝගිකයාට පමණක් යවන්න.
hosted පිටුව ජංගම දුරකථනවලද ක්රියා කරයිද?
සමාජ sign-ins කරයි, මන්ද ඒවා එම tab එකේම විවෘත වේ. WhatsApp අංකයක් වඩාත් හොඳින් සම්බන්ධ කරන්නේ පරිගණකයකින්: දුරකථනයක Meta popup එක නව tab එකක් ලෙස විවෘත වේ, සහ QR code එක ස්කෑන් කිරීමට දුරකථනම අවශ්යයි.
පාරිභෝගිකයෙක් සම්බන්ධ වූ බව polling නොකර මා දැනගන්නේ කෙසේද?
dashboard එකේ Profile, Developers යටතේ status events URL එකක් සකසන්න. ඉන්පසු easyCoexistence සම්බන්ධතාවය සිදු වූ සැණින් connection.connected හෝ channel.connected යවයි, අත්සන් කළ සහ ඔබේ external_ref සහිතව.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ