లాగిన్ చేయండిఉచిత ట్రయల్ ప్రారంభించండి
easyCoexistence అధికారిక APIలు

కస్టమర్ WhatsApp లేదా సోషల్ కనెక్షన్ తెగిపోతే ఎలా తెలుసుకోవాలి

easyCoexistence ఒక కస్టమర్ కనెక్షన్ కనెక్ట్ అయినప్పుడు, తెగినప్పుడు, తొలగించబడినప్పుడు లేదా సస్పెండ్ అయినప్పుడు ప్లాట్‌ఫామ్‌కు సంతకం చేసిన స్టేటస్ ఈవెంట్‌లను పంపుతుంది. WhatsApp నంబర్ connection.connected, Meta కారణంతో connection.disconnected, connection.removed, connection.suspended లేదా connection.token_missing పంపుతుంది; సోషల్ ఖాతా token_missing తప్ప channel.* సమానమైన ఈవెంట్‌లను పంపుతుంది. ప్రతి ఈవెంట్ X-EC-Signature తో సంతకం చేసిన JSON POST, మరియు మీ ఎండ్‌పాయింట్ 2xx ప్రతిస్పందన ఇచ్చే వరకు సుమారు 33 గంటల పాటు బ్యాక్‌ఆఫ్‌తో మళ్లీ ప్రయత్నించబడుతుంది.

~14 days

PRIMARY_INACTIVITY: ప్రాథమిక పరికరం సుమారు 14 రోజులు నిష్క్రియంగా ఉన్నప్పుడు Meta ఇచ్చే కారణం; దీని వల్ల Coexistence నంబర్ డిస్‌కనెక్ట్ అవుతుంది.

~30 days

COMPANION_INACTIVITY: కంపానియన్ పరికరం సుమారు 30 రోజులు నిష్క్రియంగా ఉన్నప్పుడు Meta ఇచ్చే కారణం.

account_update

డిస్‌కనెక్ట్‌ను నివేదించే వెబ్‌హుక్. Meta దీన్ని ఎప్పుడూ యాప్ డిఫాల్ట్ కాల్‌బ్యాక్ URL కే పంపుతుంది, ఓవర్‌రైడ్‌కు ఎప్పుడూ పంపదు.

7 attempts

2xx కాకుండా ఏదైనా ప్రతిస్పందన వస్తే స్టేటస్ ఈవెంట్ ఎంత తరచుగా మళ్లీ ప్రయత్నించబడుతుంది: 1 నిమిషం నుండి 24 గంటల వరకు విరామాలతో, సుమారు 33 గంటల్లో.

5 minutes

ఎండ్‌పాయింట్ స్వీకరించవలసిన అతి పాత సంతకం చేసిన టైమ్‌స్టాంప్ t; HMAC ను స్థిర సమయ పోలికతో ధృవీకరించాలి.

ఏ స్టేటస్ ఈవెంట్‌లు ఉన్నాయి?

తొమ్మిది, రెండు కుటుంబాలలో, ఒకే ఎండ్‌పాయింట్ మరియు ఒకే సంతకం రహస్యాన్ని పంచుకుంటాయి. నంబర్‌లు connection.* ను, సోషల్ ఖాతాలు channel.* ను ఉపయోగిస్తాయి, కాబట్టి నంబర్‌ల కోసం రాసిన రిసీవర్ ఛానల్ ఈవెంట్‌లను పేరు ద్వారా దాటవేయగలదు. డాష్‌బోర్డ్‌లో Profile, తర్వాత Developers కింద ఎండ్‌పాయింట్‌ను సెట్ చేయండి, లేదా MCP టూల్ set_partner_events_url ద్వారా చేయండి; 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.

కనెక్షన్ ఈవెంట్‌లో ఏముంటుంది?

డెలివరీ id, ఇది UUID; ఈవెంట్ పేరు; ISO 8601 లో occurred_at; మరియు id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status మరియు token_ready ఉన్న connection ఆబ్జెక్ట్. కొన్ని ఈవెంట్‌లు పై స్థాయి ఫీల్డ్‌ను జోడిస్తాయి: connection.disconnected మరియు connection.suspended పై reason; detected_by విలువ health_check అయితే, దాని అర్థం easyCoexistence యొక్క స్వంత పీరియాడిక్ తనిఖీ తెగుటను కనుగొంది, Meta వెబ్‌హుక్ కాదు; మరియు కనెక్ట్ సెషన్ ఈవెంట్‌ను ఉత్పత్తి చేసినప్పుడు 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"
}

ఛానల్ ఈవెంట్‌లో ఏముంటుంది?

connection స్థానంలో channel ఆబ్జెక్ట్‌తో అదే ఎన్వలప్. ఇది 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. ఛానళ్లకు token_missing ఉండదు, ఎందుకంటే సోషల్ సైన్-ఇన్ ఎల్లప్పుడూ కస్టమర్ స్వంత టోకెన్‌ను ఇస్తుంది. కనెక్ట్ సెషన్ నుండి వచ్చిన 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 తన account_update వెబ్‌హుక్ యొక్క disconnection_info లో ఉంచిన కోడ్. WhatsApp Business యాప్ మరియు Cloud API రెండింటిపై ఉన్న నంబర్‌ల కోసం Meta దీన్ని చేర్చుతుంది. Meta రిఫరెన్స్‌లోని కోడ్‌లు:

  • PRIMARY_INACTIVITY: WhatsApp Business యాప్ నడుస్తున్న ఫోన్ సుమారు 14 రోజులు నిష్క్రియంగా ఉంది, ఇది 14 రోజుల నియమం. కొత్త కనెక్ట్ సెషన్ నంబర్‌ను మళ్లీ కనెక్ట్ చేస్తుంది.
  • ACCOUNT_DISCONNECTED: Meta ఎన్‌ఫోర్స్‌మెంట్ ద్వారా లేదా కస్టమర్ ద్వారా ఖాతా డిస్‌కనెక్ట్ చేయబడింది; కస్టమర్ యాక్సెస్ తీసివేసి ఉండవచ్చు లేదా ఖాతాను తొలగించి ఉండవచ్చు.
  • COMPANION_INACTIVITY: ఒక కంపానియన్ పరికరం సుమారు 30 రోజులు నిష్క్రియంగా ఉంది.
  • BUSINESS_DOWNGRADE: నంబర్ వినియోగదారుల WhatsApp యాప్‌తో రిజిస్టర్ చేయబడింది.
  • CHANGE_NUMBER మరియు USER_RE_REGISTERED: కస్టమర్ నంబర్‌ను మార్చారు, లేదా కొత్త పరికరంలో మళ్లీ రిజిస్టర్ చేశారు.

స్టేటస్ ఈవెంట్‌తో ఏ హెడర్‌లు వస్తాయి?

ఐదు, ప్రతి ప్రయత్నంలోనూ: Content-Type application/json, User-Agent easyCoexistence-webhooks/1, ఈవెంట్ పేరుతో X-EC-Event, బాడీలోని అదే id తో X-EC-Delivery, మరియు X-EC-Signature. సంతకం t=<unix>,v1=<hex> రూపంలో ఉంటుంది; ఇక్కడ v1 అనేది t, చుక్క మరియు రా బాడీ యొక్క HMAC-SHA256, మీ ఖాతా సంతకం రహస్యంతో కీ చేయబడింది, ఇది whsec_ తో మొదలవుతుంది. ప్రతి ప్రయత్నం తాజాగా సంతకం చేయబడుతుంది, కాబట్టి మళ్లీ ప్రయత్నంలో అదే బాడీపై కొత్త 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

విఫలమైన డెలివరీలు ఎలా మళ్లీ ప్రయత్నించబడతాయి?

మొదటి ప్రయత్నం ఈవెంట్ జరిగినప్పుడే వెళ్తుంది. 2xx కాకుండా ప్రతిస్పందన, 10 సెకన్లలో ప్రతిస్పందన లేకపోవడం, నెట్‌వర్క్ లోపం లేదా రీడైరెక్ట్ విఫలంగా లెక్కించబడతాయి. అప్పుడు ఈవెంట్ 1 నిమిషం నుండి 24 గంటల వరకు పెరుగుతున్న విరామాలతో మళ్లీ ప్రయత్నించబడుతుంది, మొత్తం ఏడు ప్రయత్నాలు సుమారు 33 గంటల్లో; తర్వాత అది వదిలేయబడుతుంది. డెలివరీలు పబ్లిక్ IP కు పరిష్కరించే HTTPS చిరునామాకు మాత్రమే వెళ్తాయి. ఎండ్‌పాయింట్ సెట్ చేయని సమయంలో జరిగిన ఈవెంట్ ఎప్పుడూ క్యూలో ఉంచబడదు, మరియు ఎండ్‌పాయింట్‌ను తొలగిస్తే పెండింగ్‌లో ఉన్నవన్నీ ఆగిపోతాయి.

ప్రతి id ను ఒకసారి ఎందుకు నిర్వహించాలి, occurred_at ను ఎందుకు తనిఖీ చేయాలి?

ఎందుకంటే మళ్లీ ప్రయత్నం ఖచ్చితమైన డెలివరీని పునరావృతం చేస్తుంది: బాడీలో మరియు X-EC-Delivery లో అదే id ఉంటుంది. అలాగే మళ్లీ ప్రయత్నించిన ఈవెంట్ కొత్తదాని తర్వాత చేరవచ్చు. మీరు ప్రాసెస్ చేసిన id లను నిల్వ చేసి పునరావృతాలను దాటవేయండి. తర్వాత occurred_at ను ఆ కనెక్షన్ కోసం మీరు నమోదు చేసిన చివరి స్టేటస్‌తో పోల్చండి, లేదా పాతదై ఉండే ఈవెంట్‌పై చర్య తీసుకునే ముందు GET /connections/{id} లేదా GET /channels/{id} చదవండి.

నంబర్ తెగినప్పుడు ప్లాట్‌ఫామ్ ఏమి చేయాలి?

కారణం ఆధారంగా చర్య తీసుకోండి. PRIMARY_INACTIVITY తర్వాత, కస్టమర్‌ను WhatsApp Business యాప్ తెరవమని అడగండి, మరియు అదే నంబర్ కోసం కొత్త కనెక్ట్ సెషన్ పంపండి. అదే WhatsApp Business Account పై మళ్లీ కనెక్ట్ చేస్తే దాని connection ID ఉంచబడుతుంది, మీ వెబ్‌హుక్ గమ్యం తిరిగి సెట్ అవుతుంది, మరియు connection.connected పంపబడుతుంది; ఆ తర్వాత దాని క్రెడెన్షియల్స్ మళ్లీ చదవండి. connection.token_missing అంటే ఆ రన్‌లో Meta టోకెన్ జారీ చేయలేదు. తెగుటకు సంబంధించిన account_update ను Meta యాప్ స్వంత కాల్‌బ్యాక్‌కు మాత్రమే పంపుతుంది, మీ URL కు ఎప్పుడూ పంపదు; కాబట్టి ఈ ఈవెంట్ ద్వారానే మీ ప్లాట్‌ఫామ్‌కు ఆ సంగతి తెలుస్తుంది.

సోషల్ ఖాతా తెగినప్పుడు ప్లాట్‌ఫామ్ ఏమి చేయాలి?

channel.disconnected పై, అదే ఛానల్‌తో కొత్త కనెక్ట్ సెషన్ అదే channel ID కింద ఖాతాను మళ్లీ సైన్ ఇన్ చేస్తుంది. channel.removed అంటే యాక్సెస్ పోయింది: టోకెన్ మర్చిపోతారు మరియు ఏ వెబ్‌హుక్ గమ్యాన్నైనా క్లియర్ చేస్తారు, కాబట్టి కస్టమర్ మళ్లీ కనెక్ట్ చేస్తే గమ్యాన్ని మళ్లీ సెట్ చేయండి. సస్పెండ్ అయిన నంబర్ లేదా ఛానల్ మీ సబ్‌స్క్రిప్షన్ మళ్లీ యాక్టివ్ అయిన తర్వాత ఒకసారి మళ్లీ కనెక్ట్ చేయడం ద్వారా తిరిగి వస్తుంది.

సాధారణ పొరపాట్లు

  • మళ్లీ ప్రయత్నాన్ని కొత్త ఈవెంట్‌గా భావించడం. దానిలో బాడీలో మరియు X-EC-Delivery లో అదే id ఉంటుంది, కాబట్టి ప్రాసెస్ చేసిన id లను నమోదు చేయండి, లేకపోతే ఒకే తెగుట కస్టమర్‌కు రెండుసార్లు అలర్ట్ పంపవచ్చు.
  • వచ్చిన క్రమంలో ఈవెంట్‌లను అప్లై చేయడం. మళ్లీ ప్రయత్నించిన ఈవెంట్ కొత్తదాని తర్వాత చేరవచ్చు, కాబట్టి occurred_at ను పోల్చండి, లేదా చర్య తీసుకునే ముందు కనెక్షన్‌ను చదవండి.
  • తప్పును సరిచేయడానికి ఈవెంట్ URL ను మళ్లీ సేవ్ చేయడం, బ్యాకెండ్‌ను అప్‌డేట్ చేయకుండా. సేవ్ చేయడం కొత్త సంతకం రహస్యాన్ని జారీ చేస్తుంది, మరియు మీ ఎండ్‌పాయింట్ దాన్ని ఉపయోగించే వరకు ప్రతి డెలివరీ ధృవీకరణలో విఫలమవుతుంది.
  • ప్రతిస్పందన ఇవ్వడానికి ముందే పని చేయడం. 10 సెకన్లకు మించి తీసుకునే హ్యాండ్లర్ విఫలంగా లెక్కించబడుతుంది మరియు ఈవెంట్ తిరిగి వస్తుంది, కాబట్టి ముందు 2xx ఇవ్వండి, తర్వాత ప్రాసెస్ చేయండి.
EasyCoexistenceతో దీన్ని చేయడం

easyCoexistence మీ ప్రతి కస్టమర్ WhatsApp నంబర్ మరియు సోషల్ ఖాతాలను రోజంతా గమనిస్తుంది. అవి కనెక్ట్ అయినప్పుడు, తెగినప్పుడు, తొలగించబడినప్పుడు లేదా సస్పెండ్ అయినప్పుడు మీ ప్లాట్‌ఫామ్‌కు సంతకం చేసిన ఈవెంట్ పంపుతుంది; నంబర్ తెగినప్పుడు Meta కారణంతో. ప్రతి కనెక్షన్‌కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, కనెక్షన్‌లు జోడించేకొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.

తరచుగా అడిగే ప్రశ్నలు

PRIMARY_INACTIVITY అంటే ఏమిటి?

ఇది Meta ఇచ్చే కారణం. Coexistence నంబర్‌ను డిస్‌కనెక్ట్ చేయడానికి, దాని WhatsApp Business యాప్ ప్రాథమిక పరికరంలో సుమారు 14 రోజులు ఉపయోగించబడనప్పుడు ఇది ఇవ్వబడుతుంది. ఆ కస్టమర్ కోసం కొత్త కనెక్ట్ సెషన్ నంబర్‌ను మళ్లీ కనెక్ట్ చేస్తుంది.

స్టేటస్ ఈవెంట్‌లలో మెసేజ్‌లు ఉంటాయా?

లేదు. అవి కనెక్షన్ స్టేటస్‌ను మాత్రమే కవర్ చేస్తాయి. నంబర్ యొక్క మెసేజ్‌లు Meta నుండి దాని స్వంత వెబ్‌హుక్ గమ్యానికి వెళ్తాయి, సోషల్ కామెంట్‌లు మరియు DMs ప్రతి ఛానల్ గమ్యానికి వెళ్తాయి.

ఈవెంట్ URL ను ఎక్కడ సెట్ చేయాలి?

డాష్‌బోర్డ్‌లో Profile, తర్వాత Developers కింద, లేదా MCP టూల్ set_partner_events_url ద్వారా. సంతకం రహస్యం ఒకసారి మాత్రమే చూపబడుతుంది, మరియు URL ను మళ్లీ సేవ్ చేస్తే కొత్తది జారీ అవుతుంది.

నంబర్‌లను మాత్రమే హ్యాండిల్ చేస్తే ఛానల్ ఈవెంట్‌లను విస్మరించవచ్చా?

అవును. channel.* ఈవెంట్‌లకు వాటి స్వంత పేర్లు ఉంటాయి మరియు connection కు బదులు channel ఆబ్జెక్ట్ ఉంటుంది, కాబట్టి పేరు connection తో మొదలుకాని ఏ ఈవెంట్‌నైనా రిసీవర్ దాటవేయవచ్చు.

చదవడం కొనసాగించండి

వెబ్‌హుక్ ద్వారా మీ కస్టమర్ల WhatsApp మెసేజ్‌లు, సోషల్ కామెంట్‌లను ఎలా స్వీకరించాలిప్రతి కనెక్షన్‌కు వెబ్‌హుక్: WhatsApp మెసేజ్‌లు Meta నుండి నేరుగా, URLలోని సీక్రెట్‌తో ధృవీకరించబడతాయి; కామెంట్‌లు, DMలు X-EC-Signature తో సంతకం చేయబడతాయి.WhatsApp, Instagram మరియు TikTok కోసం కస్టమర్ల API టోకెన్లను ఎలా పొందాలికస్టమర్ WhatsApp నంబర్, ప్రతి సోషల్ ఖాతా credentials కాల్ ఏం ఇస్తుందో, టోకెన్ రొటేషన్, token_ready ఎలా పని చేస్తాయో వివరిస్తుంది.API ద్వారా WhatsApp Business యాప్ చాట్ హిస్టరీ మరియు కాంటాక్ట్‌లను ఎలా దిగుమతి చేయాలిCoexistence ద్వారా WhatsApp Business యాప్ కాంటాక్ట్‌లు, 180 రోజుల వరకు చాట్‌లను దిగుమతి చేయండి: హిస్టరీ వెబ్‌హుక్‌లు, chunk_order, progress, 2593109.కస్టమర్ల WhatsApp, Instagram మరియు TikTok పై AI ఏజెంట్ ఉత్పత్తిని ఎలా నిర్మించాలిమీ కస్టమర్ల WhatsApp, Instagram, Facebook, TikTok పై AI ఏజెంట్ ఉత్పత్తిని నిర్మించండి: Partner API, మీ మోడల్, ప్రతి నెట్‌వర్క్ నియమాలు.account_update వెబ్‌హుక్ మరియు ప్రతి కనెక్షన్ తొలగింపు కారణంaccount_update కనెక్షన్ స్టేటస్ మార్పులను తెలియజేస్తుంది. Meta పంపే తొలగింపు కారణాలు, వాటి అర్థం, తిరిగి పొందగల కారణాలు ఇందులో ఉన్నాయి.నంబర్ పనిచేయడం ఆగిందా: కారణం ఎలా తెలుసుకోవాలిఈ వైఫల్యాలు నిజంగా జరిగే క్రమంలో చెక్‌లిస్ట్: టోకెన్, వెబ్‌హుక్ ఓవర్‌రైడ్, 14 రోజుల నిష్క్రియ డిస్‌కనెక్షన్, క్వాలిటీ, ఖాతా పరిమితి.

మీ మొదటి ఛానెల్‌ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.

ప్లాట్‌ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్‌ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.

  • 3 రోజులు ఉచితం
  • ఎప్పుడైనా రద్దు చేయండి
  • అధికారిక APIలు మాత్రమే
  • 24/7 పర్యవేక్షణ

ధృవీకరించిన తేదీ