ग्राहक का WhatsApp या सोशल कनेक्शन कब टूटता है, यह कैसे जानें
easyCoexistence ग्राहक के कनेक्शन के जुड़ने, टूटने, हटने या निलंबित होने पर आपके प्लेटफ़ॉर्म को साइन किया हुआ स्टेटस इवेंट भेजता है। WhatsApp नंबर connection.connected, Meta के कारण सहित connection.disconnected, connection.removed, connection.suspended या connection.token_missing भेजता है; सोशल अकाउंट इनके समकक्ष channel.* इवेंट भेजता है, पर token_missing के बिना। हर इवेंट X-EC-Signature से साइन किया गया JSON POST है, और आपका एंडपॉइंट 2xx जवाब न दे तब तक लगभग 33 घंटे तक बैकऑफ़ के साथ दोबारा भेजा जाता है।
PRIMARY_INACTIVITY: Meta का वह कारण जब प्राइमरी डिवाइस लगभग 14 दिन तक निष्क्रिय रहा और Coexistence नंबर डिस्कनेक्ट हो गया।
COMPANION_INACTIVITY: Meta का वह कारण जब कंपेनियन डिवाइस लगभग 30 दिन तक निष्क्रिय रहा।
वह वेबहुक जो डिस्कनेक्शन की सूचना देता है। Meta इसे हमेशा ऐप के डिफ़ॉल्ट कॉलबैक यूआरएल पर भेजता है, कभी ओवरराइड पर नहीं।
किसी भी 2xx से अलग जवाब के बाद स्टेटस इवेंट कितनी बार दोबारा भेजा जाता है, 1 मिनट से 24 घंटे के अंतराल पर, लगभग 33 घंटे तक।
सबसे पुराना साइन किया हुआ टाइमस्टैम्प t, जिसे स्टेटस इवेंट पर एंडपॉइंट स्वीकार करे। HMAC की तुलना constant time में करें।
कौन-से स्टेटस इवेंट होते हैं?
नौ, दो परिवारों में, जो एक ही एंडपॉइंट और एक ही साइनिंग सीक्रेट साझा करते हैं। नंबरों के लिए connection.* और सोशल अकाउंट के लिए channel.* इस्तेमाल होता है, इसलिए नंबरों के लिए लिखा गया रिसीवर channel इवेंट नाम से छोड़ सकता है। एंडपॉइंट डैशबोर्ड में Profile, फिर Developers के अंतर्गत सेट करें, या MCP टूल set_partner_events_url से। साइनिंग सीक्रेट यूआरएल सेव होते समय एक बार दिखाया जाता है।
कनेक्शन इवेंट में क्या होता है?
डिलीवरी का id, एक UUID; इवेंट का नाम; ISO 8601 में occurred_at; और connection ऑब्जेक्ट, जिसमें 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"
}चैनल इवेंट में क्या होता है?
वही एनवेलप, 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 में रखा, जिसे 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, बॉडी के 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 घंटे तक, फिर से भेजा जाता है। इसके बाद वह छोड़ दिया जाता है। डिलीवरी केवल ऐसे HTTPS पते पर जाती है जो सार्वजनिक IP पर हल हो। जब कोई एंडपॉइंट सेट न हो, तब होने वाला इवेंट कभी कतार में नहीं रखा जाता, और एंडपॉइंट हटाने से लंबित सभी डिलीवरी रुक जाती हैं।
हर id को एक बार क्यों संभालें और occurred_at क्यों जाँचें?
क्योंकि रीट्राई डिलीवरी को हूबहू दोहराता है, बॉडी और X-EC-Delivery दोनों में वही id के साथ, और क्योंकि दोबारा भेजा गया इवेंट किसी नए इवेंट के बाद पहुँच सकता है। संसाधित किए गए id सहेजें और दोहराव छोड़ दें। फिर occurred_at की तुलना उस कनेक्शन के लिए दर्ज आख़िरी स्थिति से करें, या किसी संभावित पुराने इवेंट पर कार्रवाई से पहले GET /connections/{id} या GET /channels/{id} पढ़ें।
नंबर टूटने पर प्लेटफ़ॉर्म को क्या करना चाहिए?
कारण के अनुसार कार्रवाई करें। PRIMARY_INACTIVITY के बाद ग्राहक से WhatsApp Business ऐप खोलने को कहें, और उसी नंबर के लिए नया कनेक्ट सेशन भेजें। उसी WhatsApp Business Account पर फिर से जोड़ने से उसका कनेक्शन ID बना रहता है, आपका वेबहुक डेस्टिनेशन वापस सेट हो जाता है, और connection.connected भेजा जाता है; उसके बाद उसके क्रेडेंशियल फिर से पढ़ें। connection.token_missing का अर्थ है कि उस रन में Meta ने कोई टोकन नहीं दिया। टूटने के पीछे का account_update Meta केवल ऐप के अपने कॉलबैक पर भेजता है, आपके यूआरएल पर नहीं, इसलिए यही इवेंट आपके प्लेटफ़ॉर्म को इसकी सूचना देता है।
सोशल अकाउंट टूटने पर प्लेटफ़ॉर्म को क्या करना चाहिए?
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.* इवेंट के अपने नाम होते हैं और connection की जगह channel ऑब्जेक्ट होता है, इसलिए रिसीवर वह इवेंट छोड़ सकता है जिसका नाम connection से शुरू नहीं होता।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित