පාරිභෝගිකයාගේ WhatsApp හෝ social සම්බන්ධතාවය විසන්ධි වූ විට දැනගන්නේ කෙසේද
easyCoexistence පාරිභෝගිකයෙකුගේ WhatsApp අංකය හෝ social ගිණුම සම්බන්ධ වන, විසන්ධි වන, ඉවත් කරන හෝ අත්හිටුවන විට, ඔබේ platform එකට අත්සන් කළ status events යවයි. WhatsApp අංකයක් connection.connected, connection.disconnected (Meta හේතුව සමඟ), connection.removed, connection.suspended හෝ connection.token_missing යවයි. social ගිණුමක් token_missing හැර channel.* සමාන events යවයි. සෑම event එකක්ම X-EC-Signature සමඟ අත්සන් කළ JSON POST එකක් වන අතර, ඔබේ endpoint එක 2xx පිළිතුරු දෙන තෙක් පැය 33ක් පමණ backoff සමඟ නැවත යවයි.
PRIMARY_INACTIVITY: primary උපාංගය දින 14ක් පමණ අක්රිය වූ විට Meta හේතුව, Coexistence අංකය විසන්ධි කරයි.
COMPANION_INACTIVITY: companion උපාංගයක් දින 30ක් පමණ අක්රිය වූ විට Meta හේතුව.
අංකය විසන්ධි වීම වාර්තා කරන webhook එක. Meta එය සෑම විටම යෙදුමේ default callback URL එකටම යවයි, කිසි විටෙක override එකකට නොවේ.
2xx නොවන ඕනෑම පිළිතුරක් ලැබුණු පසු status event එක උත්සාහ කරන ආකාරය, විනාඩි 1 සිට පැය 24 දක්වා වැඩෙන පරතර සහිතව, පැය 33ක් පමණ.
endpoint එකක් status event එකක් මත පිළිගත යුතු පැරණිතම අත්සන් කළ timestamp t, HMAC නියත කාලයේ සංසන්දනය කරමින්.
ඇත්තේ කුමන status events ද?
නවයක් ඇත, එකම endpoint එකක් සහ එකම අත්සන් රහස් යතුරක් බෙදාගන්නා ප්රවර්ග දෙකකින්. අංක connection.* භාවිත කරන අතර social ගිණුම් channel.* භාවිත කරයි, එබැවින් අංක සඳහා ලියූ receiver එකකට channel events නම අනුව මඟහැරිය හැක. Dashboard එකේ Profile, ඉන්පසු Developers යටතේ හෝ MCP tool එක set_partner_events_url මගින් endpoint එක සකසන්න. අත්සන් රහස් යතුර URL එක සුරකින විට එක් වරක් පමණක් පෙන්වයි.
connection event එකක් කුමක් ගෙන යයිද?
delivery එකේ id එක (UUID), event නම, ISO 8601 ආකාරයේ occurred_at, සහ id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status සහ token_ready ඇති connection object එකක්. සමහර events වලට උඩම මට්ටමේ field එකක් එකතු වේ: connection.disconnected සහ connection.suspended මත reason, easyCoexistence හි නිතිපතා පරීක්ෂාව Meta webhook එක වෙනුවට විසන්ධිය හඳුනාගත් විට detected_by වල health_check, සහ connect session එකක් event එක ජනනය කළ විට connect_session_id.
{
"id": "5c2a9e70-…",
"event": "connection.disconnected",
"occurred_at": "2026-10-31T10:15:02.114Z",
"connection": {
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "disconnected",
"token_ready": true
},
"reason": "PRIMARY_INACTIVITY"
}channel event එකක් කුමක් ගෙන යයිද?
connection object එක වෙනුවට channel object එක සහිත එම envelope එකම. එය GET /channels/{id} දසුනයි: id, channel, external_ref, connect_session_id, name, username, external_id, status, token_ready, webhook_url, disconnected_reason, last_checked_at සහ created_at. channels සඳහා token_missing නැත, මන්ද social sign-in එකක් සැමවිටම පාරිභෝගිකයාගේම token එක ලබා දෙයි. connect session එකෙන් ආ channel.connected හි connect_session_id උඩම මට්ටමේද ඇත.
{
"id": "0b7e41d2-…",
"event": "channel.disconnected",
"occurred_at": "2026-10-31T10:15:02.114Z",
"channel": {
"id": "<CHANNEL_ID>",
"channel": "tiktok",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"name": "Clínica Sorriso",
"username": "clinicasorriso",
"external_id": "<TIKTOK_OPEN_ID>",
"status": "disconnected",
"token_ready": false,
"webhook_url": "https://hooks.example.com/social",
"disconnected_reason": "<THE_NETWORK'S_MESSAGE>",
"last_checked_at": "2026-10-31T10:15:02.000Z",
"created_at": "2026-10-28T16:40:09.000Z"
}
}විසන්ධි වීමේ හේතු යන්නේ කුමක් ද?
connection.disconnected මත ඇති reason යනු Meta, අංක සඳහා WhatsApp Business යෙදුම සහ Cloud API යන දෙකටම ඇතුළත් කරන account_update webhook එකේ disconnection_info තුළ Meta දැමූ කේතයයි. Meta හේතුවක් නොදුන් විට එය null වේ. Meta හි යොමුවේ කේත:
PRIMARY_INACTIVITY: WhatsApp Business යෙදුම ධාවනය වන දුරකථනය දින 14ක් පමණ අක්රිය වී ඇත, 14-දින රීතිය. නව connect session එකක් අංකය නැවත සම්බන්ධ කරයි.ACCOUNT_DISCONNECTED: ගිණුම Meta හි බලාත්මක කිරීම මගින් හෝ පාරිභෝගිකයා විසින් විසන්ධි කර ඇත. ඔවුන් ප්රවේශය ඉවත් කර හෝ ගිණුම මකා දමා තිබිය හැක.COMPANION_INACTIVITY: companion උපාංගයක් දින 30ක් පමණ අක්රිය වී ඇත.BUSINESS_DOWNGRADE: අංකය consumer WhatsApp යෙදුම සමඟ ලියාපදිංචි කර ඇත.CHANGE_NUMBERසහUSER_RE_REGISTERED: පාරිභෝගිකයා අංකය වෙනස් කළ, හෝ නව උපාංගයක එය නැවත ලියාපදිංචි කළ.
status event එකක් සමඟ කුමන headers ලැබේද?
පහක්, සෑම උත්සාහයකම: Content-Type application/json, User-Agent easyCoexistence-webhooks/1, event නම සමඟ X-EC-Event, body එකේ ඇති id එකම සමඟ X-EC-Delivery, සහ X-EC-Signature. අත්සන t=<unix>,v1=<hex> ආකාරයේය. මෙහි v1 යනු t, තිතක් සහ raw body එක මත HMAC-SHA256 වන අතර, ගිණුමේ අත්සන් රහස් යතුර ලෙස යතුරු කර ඇත. එය whsec_ වලින් ආරම්භ වේ. සෑම උත්සාහයක්ම නැවත අත්සන් කරයි, එබැවින් retry එකක් එම body එකටම නව t ගෙන යයි.
import hashlib, hmac, json, os, time
SECRET = os.environ["EC_EVENTS_SECRET"].encode() # whsec_..., shown once in Profile > Developers
def verify(raw: bytes, header: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False # missing, or more than 5 minutes off
mac = hmac.new(SECRET, t.encode() + b"." + raw, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, v1)
def handle(raw: bytes, headers) -> int:
if not verify(raw, headers.get("X-EC-Signature", "")):
return 401
event = json.loads(raw)
if already_processed(event["id"]): # the X-EC-Delivery id, the same on every retry
return 200
enqueue(event) # act on event["event"]; the latest occurred_at wins
return 200අසාර්ථක delivery නැවත උත්සාහ කරන්නේ කෙසේද?
පළමු උත්සාහය event එක සිදුවන විටම යයි. 2xx නොවන පිළිතුරක්, තත්පර 10ක් ඇතුළත පිළිතුරක් නොමැතිකම, network error එකක් හෝ redirect එකක් අසාර්ථකත්වයක් ලෙස ගණන් ගනී. එවිට event එක විනාඩි 1 සිට පැය 24 දක්වා වැඩෙන පරතර සහිතව නැවත උත්සාහ කරයි, පැය 33ක් පමණ තුළ උත්සාහ 7ක් සම්පූර්ණයෙන්, ඉන්පසු ඉවත් කෙරේ. Deliveries යවන්නේ public IP එකකට resolve වන HTTPS ලිපිනයට පමණි. endpoint එකක් සකසා නැති අවස්ථාවක සිදුවන event එක කිසි විටෙක පෝලිමට දමන්නේ නැත, සහ endpoint එක ඉවත් කිරීම පොරොත්තු පවතින සියල්ල නවත්වයි.
සෑම id එකක්ම එක් වරක් හසුරුවා occurred_at පරීක්ෂා කරන්නේ ඇයි?
මන්ද retry එකක් delivery එක හරියටම නැවත යවන බැවින්, body එකේත් X-EC-Delivery හිත් එකම id සමඟ. තවද නැවත උත්සාහ කළ event එකක් නවතම එකකට පසුව පැමිණිය හැකි බැවින්. ඔබ සකසා ඇති id ගබඩා කර, නැවත ලැබෙන ඒවා මඟහරින්න. ඉන්පසු occurred_at එය සම්බන්ධතාවය සඳහා ඔබ අවසානයට වාර්තා කළ තත්වය සමඟ සසඳන්න. පැරණි විය හැකි event එකක් මත ක්රියා කිරීමට පෙර GET /connections/{id} හෝ GET /channels/{id} කියවන්න.
අංකයක් විසන්ධි වූ විට platform එකක් කළ යුත්තේ කුමක්ද?
හේතුව මත ක්රියා කරන්න. PRIMARY_INACTIVITY ට පසු, පාරිභෝගිකයාට WhatsApp Business යෙදුම විවෘත කර එම අංකය සඳහා නව connect session එකක් යවන ලෙස ඉල්ලන්න. එම WhatsApp Business Account එකේම නැවත සම්බන්ධ කිරීමෙන් එහි connection ID එක තබා ගන්නා අතර, ඔබේ webhook destination එක යළි සකසා connection.connected යවයි. ඉන්පසු එහි credentials නැවත කියවන්න. connection.token_missing යනු එම ධාවනයේදී Meta token එකක් නිකුත් නොකළ බවයි. විසන්ධියට පසුබිම් වන account_update එක Meta යවන්නේ යෙදුමේම callback එකට පමණි, ඔබේ URL එකට කිසි විටෙක නොවේ. එබැවින් ඔබේ platform එක එය දන්නේ මෙම event එක මගිනි.
social ගිණුමක් විසන්ධි වූ විට platform එකක් කළ යුත්තේ කුමක්ද?
channel.disconnected මත, එම channel ID එකේම නව connect session එකක් සමඟ පාරිභෝගිකයා නැවත sign in කරයි. channel.removed යනු ප්රවේශය නැති වූ බවයි: token එක අමතක වන අතර, ඕනෑම webhook destination එකක් ඉවත් වේ. එබැවින් පාරිභෝගිකයා නැවත සම්බන්ධ වුවහොත් destination එක යළි සකසන්න. අත්හිටුවූ අංකයක් හෝ channel එකක් ඔබේ දායකත්වය නැවත සක්රිය වූ පසු නැවත සම්බන්ධ කිරීමෙන් ආපසු ලැබේ.
සාමාන්ය වැරදි
- Retry එකක් නව event එකක් ලෙස සැලකීම. එයට body එකේත් X-EC-Delivery හිත් එකම id එකක් ඇත. එබැවින් සකසන ලද id වාර්තා කරන්න, නැතහොත් එක් විසන්ධියක් පාරිභෝගිකයෙකුට දෙවරක් අනතුරු ඇඟවීම් යැවිය හැක.
- Events පැමිණීමේ අනුපිළිවෙලින් යෙදීම. නැවත උත්සාහ කළ event එකක් නවතම එකකට පසු ළඟා විය හැකි බැවින්, occurred_at සසඳන්න, හෝ ක්රියා කිරීමට පෙර connection එක කියවන්න.
- Typo එකක් නිකුත් කිරීමට events URL එක නැවත සුරැකීම, backend එක යාවත්කාලීන නොකර. සුරකීම නව අත්සන් රහස් යතුරක් නිකුත් කරන අතර, ඔබේ endpoint එක එය භාවිත කරන තෙක් සෑම delivery එකක්ම සත්යාපනය අසමත් වේ.
- Answer කිරීමට පෙර වැඩ කිරීම. තත්පර 10ට වඩා ගතවන handler එකක් අසාර්ථක ලෙස ගණන් ගන්නා අතර event එක නැවත පැමිණේ. එබැවින් පළමුව 2xx පිළිතුරු දෙන්න, පසුව සකසන්න.
easyCoexistence පාරිභෝගිකයෙකුගේ WhatsApp අංකය සහ social ගිණුම් පැය 24ම නිරීක්ෂණය කරයි. ඒවා සම්බන්ධ වන, විසන්ධි වන, ඉවත් වන හෝ අත්හිටුවන විට ඔබේ platform එකට අත්සන් කළ event එකක් යවයි, විසන්ධි වන අංකයක් සඳහා Meta හේතුව සමඟ. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එක් කරන තරමට අඩු වේ, පළමු දින 3ක නොමිලේ trial කාලය සමඟ.
නිතර අසන ප්රශ්න
PRIMARY_INACTIVITY යන්නේ කුමක්ද?
එය Coexistence අංකයක් විසන්ධි කිරීමට Meta හේතුවයි. එහි WhatsApp Business යෙදුම primary උපාංගයේ දින 14ක් පමණ භාවිත නොවූ විට එය සිදු වේ. එම පාරිභෝගිකයා සඳහා නව connect session එකක් අංකය නැවත සම්බන්ධ කරයි.
Status events පණිවිඩ ඇතුළත් කරන්නේද?
නැත. ඒවා සම්බන්ධතාවයක තත්වය ආවරණය කරයි. අංකයක පණිවිඩ Meta වෙතින් එහි තමන්ගේම webhook destination එකට යන අතර, social අදහස් සහ DMs යන්නේ එක් එක් channel හි destination එකටය.
Events URL එක කොහේ සකසන්නද?
Dashboard එකේ Profile, ඉන්පසු Developers යටතේ, නැතහොත් MCP tool set_partner_events_url මගින්. අත්සන් රහස් යතුර එක් වරක් පමණක් පෙන්වයි, සහ URL එක නැවත සුරැකීම නව එකක් නිකුත් කරයි.
අංක පමණක් හසුරුවන්නේ නම් channel events නොසලකා හැරිය හැකිද?
ඔව්. channel.* events වලට ඒවායේම නම් ඇති අතර, connection object එක වෙනුවට channel object එකක් ඇත. එබැවින් නම connection වලින් ආරම්භ නොවන ඕනෑම event එකක් receiver එකකට මඟහැරිය හැක.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ