පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
easyCoexistence නිල API

පාරිභෝගිකයාගේ 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 සමඟ නැවත යවයි.

~14 days

PRIMARY_INACTIVITY: primary උපාංගය දින 14ක් පමණ අක්‍රිය වූ විට Meta හේතුව, Coexistence අංකය විසන්ධි කරයි.

~30 days

COMPANION_INACTIVITY: companion උපාංගයක් දින 30ක් පමණ අක්‍රිය වූ විට Meta හේතුව.

account_update

අංකය විසන්ධි වීම වාර්තා කරන webhook එක. Meta එය සෑම විටම යෙදුමේ default callback URL එකටම යවයි, කිසි විටෙක override එකකට නොවේ.

7 attempts

2xx නොවන ඕනෑම පිළිතුරක් ලැබුණු පසු status event එක උත්සාහ කරන ආකාරය, විනාඩි 1 සිට පැය 24 දක්වා වැඩෙන පරතර සහිතව, පැය 33ක් පමණ.

5 minutes

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.connectedA number connected, came back after a drop, or got its customer token on a second run.
connection.disconnectedMeta dropped the link; reason carries Meta's code when known.
connection.removedRemoved with DELETE /connections/{id} or from the dashboard.
connection.suspendedYour subscription lapsed; reason names its state.
connection.token_missingConnected without a customer token: it receives, but cannot send yet.
channel.connectedA social account connected, one event per Page when a sign-in brings several.
channel.disconnectedThe network refused the token, or the owner withdrew access.
channel.removedRemoved with DELETE /channels/{id} or from the dashboard, or the owner removed the app on Meta.
channel.suspendedYour subscription lapsed.

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.

connection.disconnected
{
  "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 උඩම මට්ටමේද ඇත.

channel.disconnected
{
  "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 ගෙන යයි.

Python: verify, then handle each id once
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 සමඟ මෙය කිරීම

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 එකකට මඟහැරිය හැක.

තවදුරටත් කියවන්න

පාරිභෝගිකයින්ගේ WhatsApp පණිවිඩ සහ comment webhook එක හරහා ලබා ගන්නේ කෙසේදසෑම සම්බන්ධතාවයකටම webhook එකක්: WhatsApp පණිවිඩ Meta වෙතින් කෙලින්ම, URL එකේ රහස්‍ය යතුරෙන් සත්‍යාපනය, comment සහ DM X-EC-Signature සමඟ.පාරිභෝගිකයාගේ WhatsApp, Instagram සහ TikTok API token ලබා ගන්නේ කෙසේදපාරිභෝගිකයාගේ WhatsApp අංකය සහ සෑම social account එකක් සඳහා credentials call එකෙන් ලැබෙන දත්ත, token_ready ක්‍රියා කරන ආකාරයAPI හරහා WhatsApp Business app chat history සහ contacts import කරන ආකාරයWhatsApp Business app අංකයක contacts සහ දින 180 දක්වා chat history Coexistence හරහා import කරන්න: history webhooks, chunk_order, progress සහ 2593109.ඔබේ ගනුදෙනුකරුවන්ගේ WhatsApp, Instagram සහ TikTok මත AI agent නිෂ්පාදනයක් ගොඩනඟන්නේ කෙසේද?ඔබේ ගනුදෙනුකරුවන්ගේ WhatsApp, Instagram, Facebook සහ TikTok මත AI agent නිෂ්පාදනයක් ගොඩනඟන්න. Partner API, ඔබේම model සහ එක් එක් network එකේ rules සමඟ.account_update webhook එක සහ සෑම විසන්ධි වීමේ හේතුවක්මaccount_update සම්බන්ධතා තත්ත්ව වෙනස්වීම් වාර්තා කරයි. Meta යවන විසන්ධි වීමේ හේතු සහ නැවත ලබාගත හැකි හේතු හඳුනාගන්න.අංකයක් ක්‍රියා නොකරයි: හේතුව සොයන්නේ කෙසේදසැබෑ දෝෂ සිදුවන අනුපිළිවෙළේ checklist එක: token, webhook override, දින 14ක අක්‍රීය වීම, ගුණාත්මකභාවය සහ ගිණුම් සීමාව.

ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.

වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්‍ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්‍රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.

  • දින 3ක් නොමිලේ
  • ඕනෑම වේලාවක අවලංගු කරන්න
  • නිල API පමණි
  • 24/7 නිරීක්ෂණය කෙරේ

සත්‍යාපනය කළේ