ग्राहकाचे 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: Meta चे कारण, जेव्हा प्राथमिक डिव्हाइस सुमारे 14 दिवस निष्क्रिय राहते आणि Coexistence नंबर डिस्कनेक्ट होतो.
COMPANION_INACTIVITY: Meta चे कारण, जेव्हा कंपॅनियन डिव्हाइस सुमारे 30 दिवस निष्क्रिय असते.
डिस्कनेक्शन कळवणारा वेबहुक. Meta तो नेहमी ॲपच्या डिफॉल्ट कॉलबॅक यूआरएलवर पाठवते, ओव्हरराइडवर कधीही नाही.
2xx व्यतिरिक्त कोणताही प्रतिसाद आल्यास स्टेटस इव्हेंट किती वेळा प्रयत्न केला जातो: 1 मिनिट ते 24 तासांच्या अंतराने, सुमारे 33 तासांत.
एंडपॉइंटने स्टेटस इव्हेंटवर स्वीकारावा असा सर्वात जुना साइन केलेला टाइमस्टँप t, HMAC ची तुलना कॉन्स्टंट टाइममध्ये करून.
कोणते स्टेटस इव्हेंट्स आहेत?
नऊ, दोन गटांत, जे एकच एंडपॉइंट आणि एकच साइनिंग सिक्रेट वापरतात. नंबरसाठी connection.* आणि सोशल खात्यांसाठी channel.* वापरले जाते, त्यामुळे नंबरसाठी लिहिलेला रिसीव्हर नावाने channel इव्हेंट्स वगळू शकतो. एंडपॉइंट डॅशबोर्डमध्ये Profile, नंतर Developers अंतर्गत सेट करा, किंवा MCP टूल set_partner_events_url वापरा; साइनिंग सिक्रेट यूआरएल सेव्ह केल्यावर एकदाच दाखवले जाते.
कनेक्शन इव्हेंटमध्ये काय असते?
डिलिव्हरीचा id (UUID), इव्हेंटचे नाव, ISO 8601 मधील occurred_at, आणि id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status व token_ready असलेले कनेक्शन ऑब्जेक्ट. काही इव्हेंट्समध्ये वरच्या स्तरावर अतिरिक्त फील्ड असते: 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"
}चॅनल इव्हेंटमध्ये काय असते?
तीच रचना, पण कनेक्शन ऐवजी चॅनल ऑब्जेक्ट असतो. हे 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 मध्ये ठेवलेला कोड आहे, जो Meta नंबरसाठी WhatsApp Business ॲप आणि Cloud API दोन्हींसाठी समाविष्ट करते. Meta ने कारण न दिल्यास ते null असते. 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, बॉडीतील आयडीसह 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 खात्यावर पुन्हा कनेक्ट केल्यास त्याचा कनेक्शन ID टिकतो, तुमचा वेबहुक डेस्टिनेशन पुन्हा सेट होतो आणि connection.connected पाठवला जातो; त्यानंतर त्याचे क्रेडेन्शियल्स पुन्हा वाचा. connection.token_missing याचा अर्थ त्या रनवर Meta ने टोकन दिले नाही. Meta तुटण्यामागील account_update फक्त ॲपच्या स्वतःच्या कॉलबॅकवर पाठवते, तुमच्या यूआरएलवर कधीही नाही, म्हणून हा इव्हेंटच तुमच्या प्लॅटफॉर्मला त्याची माहिती देतो.
सोशल खाते तुटल्यावर प्लॅटफॉर्मने काय करावे?
channel.disconnected वर त्याच चॅनल ID अंतर्गत, त्याच चॅनलसाठी नवीन कनेक्ट सेशन खाते पुन्हा साइन इन करते. channel.removed म्हणजे प्रवेश गेला: टोकन विसरले जाते आणि कोणतेही वेबहुक डेस्टिनेशन साफ केले जाते, म्हणून ग्राहक पुन्हा कनेक्ट झाल्यास डेस्टिनेशन पुन्हा सेट करा. निलंबित नंबर किंवा चॅनल तुमचे सबस्क्रिप्शन पुन्हा सक्रिय झाल्यावर, ते एकदा पुन्हा कनेक्ट केल्यावर परत येते.
सामान्य चुका
- पुन्हा प्रयत्नाला नवीन इव्हेंट समजणे. त्यात बॉडीमध्ये आणि X-EC-Delivery मध्ये एकच id असतो, म्हणून प्रक्रिया केलेले id नोंदवा, नाहीतर एका तुटण्यामुळे ग्राहकाला दोनदा अलर्ट जाऊ शकतो.
- इव्हेंट्स येण्याच्या क्रमाने लागू करणे. पुन्हा प्रयत्न केलेला इव्हेंट नवीन इव्हेंटनंतर पोहोचू शकतो, म्हणून occurred_at तपासा, किंवा कृतीपूर्वी कनेक्शन वाचा.
- टायपो दुरुस्त करण्यासाठी इव्हेंट्स यूआरएल पुन्हा सेव्ह करणे, बॅकएंड अपडेट न करता. सेव्ह केल्याने नवीन साइनिंग सिक्रेट जारी होते, आणि तुमचा एंडपॉइंट ते वापरेपर्यंत प्रत्येक डिलिव्हरी पडताळणीत अपयशी ठरते.
- उत्तर देण्यापूर्वी काम करणे. 10 सेकंदांहून जास्त वेळ घेणारा हँडलर अपयशी मानला जातो आणि इव्हेंट परत येतो, म्हणून आधी 2xx प्रतिसाद द्या आणि नंतर प्रक्रिया करा.
easyCoexistence प्रत्येक ग्राहकाचे WhatsApp नंबर आणि सोशल खाती चोवीस तास पाहते आणि एखादे कनेक्शन जोडले जाते, तुटते, काढले जाते किंवा निलंबित होते तेव्हा तुमच्या प्लॅटफॉर्मला साइन केलेला इव्हेंट पाठवते, तुटलेल्या नंबरसाठी Meta चे कारण सोबत असते. US$ 9 ते US$ 0.75 प्रति कनेक्शन दरमहा, कनेक्शन वाढतील तसे कमी होत जाते; पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
PRIMARY_INACTIVITY म्हणजे काय?
हे Meta चे कारण आहे, जेव्हा Coexistence नंबरचे WhatsApp Business ॲप त्याच्या प्राथमिक डिव्हाइसवर सुमारे 14 दिवस न वापरलेले असते तेव्हा तो नंबर डिस्कनेक्ट करण्यासाठी. त्या ग्राहकासाठी नवीन कनेक्ट सेशन नंबर पुन्हा कनेक्ट करते.
स्टेटस इव्हेंट्समध्ये मेसेज असतात का?
नाही. ते कनेक्शनची स्थिती कव्हर करतात. नंबरचे मेसेज Meta कडून त्याच्या स्वतःच्या वेबहुक डेस्टिनेशनला जातात, आणि सोशल कमेंट्स व DM प्रत्येक चॅनलच्या डेस्टिनेशनला जातात.
इव्हेंट्स यूआरएल कुठे सेट करायचा?
डॅशबोर्डमध्ये Profile, नंतर Developers अंतर्गत, किंवा MCP टूल set_partner_events_url वापरून. साइनिंग सिक्रेट एकदाच दाखवले जाते, आणि यूआरएल पुन्हा सेव्ह केल्यास नवीन जारी होते.
फक्त नंबर हाताळत असल्यास channel इव्हेंट्स वगळू शकतो का?
हो. channel.* इव्हेंट्सची स्वतःची नावे असतात आणि कनेक्शन ऐवजी चॅनल ऑब्जेक्ट असतो, त्यामुळे रिसीव्हर नाव connection ने सुरू न होणारा कोणताही इव्हेंट वगळू शकतो.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: