కస్టమర్ 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 గంటల పాటు బ్యాక్ఆఫ్తో మళ్లీ ప్రయత్నించబడుతుంది.
PRIMARY_INACTIVITY: ప్రాథమిక పరికరం సుమారు 14 రోజులు నిష్క్రియంగా ఉన్నప్పుడు Meta ఇచ్చే కారణం; దీని వల్ల Coexistence నంబర్ డిస్కనెక్ట్ అవుతుంది.
COMPANION_INACTIVITY: కంపానియన్ పరికరం సుమారు 30 రోజులు నిష్క్రియంగా ఉన్నప్పుడు Meta ఇచ్చే కారణం.
డిస్కనెక్ట్ను నివేదించే వెబ్హుక్. Meta దీన్ని ఎప్పుడూ యాప్ డిఫాల్ట్ కాల్బ్యాక్ URL కే పంపుతుంది, ఓవర్రైడ్కు ఎప్పుడూ పంపదు.
2xx కాకుండా ఏదైనా ప్రతిస్పందన వస్తే స్టేటస్ ఈవెంట్ ఎంత తరచుగా మళ్లీ ప్రయత్నించబడుతుంది: 1 నిమిషం నుండి 24 గంటల వరకు విరామాలతో, సుమారు 33 గంటల్లో.
ఎండ్పాయింట్ స్వీకరించవలసిన అతి పాత సంతకం చేసిన టైమ్స్టాంప్ t; HMAC ను స్థిర సమయ పోలికతో ధృవీకరించాలి.
ఏ స్టేటస్ ఈవెంట్లు ఉన్నాయి?
తొమ్మిది, రెండు కుటుంబాలలో, ఒకే ఎండ్పాయింట్ మరియు ఒకే సంతకం రహస్యాన్ని పంచుకుంటాయి. నంబర్లు connection.* ను, సోషల్ ఖాతాలు channel.* ను ఉపయోగిస్తాయి, కాబట్టి నంబర్ల కోసం రాసిన రిసీవర్ ఛానల్ ఈవెంట్లను పేరు ద్వారా దాటవేయగలదు. డాష్బోర్డ్లో Profile, తర్వాత Developers కింద ఎండ్పాయింట్ను సెట్ చేయండి, లేదా MCP టూల్ set_partner_events_url ద్వారా చేయండి; URL సేవ్ చేసినప్పుడు సంతకం రహస్యం ఒకసారి మాత్రమే చూపబడుతుంది.
కనెక్షన్ ఈవెంట్లో ఏముంటుంది?
డెలివరీ 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.
{
"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 కూడా ఉంటుంది.
{
"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 ఉంటుంది.
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 మీ ప్రతి కస్టమర్ 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, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ