ग्राहकको 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 मार्फत सेट गर्नुहोस्; हस्ताक्षर सिक्रेट यूआरएल बचत गर्दा एकपटक मात्र देखाइन्छ।
connection इभेन्टमा के हुन्छ?
डेलिभरीको id (UUID), इभेन्टको नाम, ISO 8601 मा occurred_at, र id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status र token_ready भएको connection object। केही इभेन्टमा शीर्ष-स्तरको थप फिल्ड हुन्छ: 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"
}channel इभेन्टमा के हुन्छ?
उही इन्भेलप, तर connection को सट्टा channel object सहित। यो 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। channel का लागि 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"
}
}disconnection का कारणहरूको अर्थ के हो?
connection.disconnected मा reason Meta को account_update वेबहुकको disconnection_info मा राखिएको कोड हो, जुन Meta ले WhatsApp Business एप र Cloud API दुवैका नम्बरका लागि समावेश गर्छ। कुनै कारण नदिँदा यो 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 मा बडीकै id, र 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 लाई त्यस connection का लागि रेकर्ड गरिएको अन्तिम स्थितिसँग तुलना गर्नुहोस्, वा पुरानो हुन सक्ने इभेन्टमा कारबाही गर्नुअघि GET /connections/{id} वा GET /channels/{id} पढ्नुहोस्।
नम्बर टुट्दा प्लेटफर्मले के गर्नुपर्छ?
कारणमा आधारित कारबाही गर्नुहोस्। PRIMARY_INACTIVITY पछि, ग्राहकलाई WhatsApp Business एप खोलेर उही नम्बरका लागि नयाँ कनेक्ट सेसन पठाउन भन्नुहोस्। उही WhatsApp Business Account मा पुनः जडान गर्दा त्यसको connection ID सुरक्षित रहन्छ, तपाईंको वेबहुक गन्तव्य फेरि सेट हुन्छ, र connection.connected पठाइन्छ; त्यसपछि त्यसका क्रेडेन्सियल फेरि पढ्नुहोस्। connection.token_missing भने त्यस चक्रमा Meta ले टोकन जारी नगरेको जनाउँछ। टुटाइको account_update इभेन्ट Meta ले एपको आफ्नै कलब्याकमा मात्र पठाउँछ, तपाईंको यूआरएलमा होइन, त्यसैले यही इभेन्टले तपाईंको प्लेटफर्मलाई त्यसबारे बताउँछ।
सामाजिक खाता टुट्दा प्लेटफर्मले के गर्नुपर्छ?
channel.disconnected मा उही channel सँग नयाँ कनेक्ट सेसनले त्यही channel ID अन्तर्गत खातालाई फेरि साइन-इन गर्छ। channel.removed को अर्थ पहुँच गयो भन्ने हो: टोकन बिर्सिइन्छ र कुनै पनि वेबहुक गन्तव्य खाली गरिन्छ, त्यसैले ग्राहक फेरि जडान गर्दा गन्तव्य फेरि सेट गर्नुहोस्। निलम्बित नम्बर वा channel तपाईंको सदस्यता फेरि सक्रिय भएपछि एकपटक फेरि जडान गरेर फर्किन्छ।
सामान्य गल्तीहरू
- पुनःप्रयासलाई नयाँ इभेन्ट ठान्नु। यसको बडी र X-EC-Delivery दुवैमा उही id हुन्छ, त्यसैले प्रशोधन गरिएका id रेकर्ड गर्नुहोस्, नत्र एउटै टुटाइले ग्राहकलाई दुईपटक सूचित गर्न सक्छ।
- इभेन्टहरू आगमन क्रममा लागू गर्नु। पुनःप्रयास गरिएको इभेन्ट नयाँ इभेन्टपछि आइपुग्न सक्छ, त्यसैले कारबाही गर्नुअघि occurred_at तुलना गर्नुहोस्, वा connection पढ्नुहोस्।
- टाइपो सच्याउन इभेन्ट्स यूआरएल फेरि बचत गर्नु, ब्याकएन्डलाई अद्यावधिक नगरी। बचत गर्दा नयाँ हस्ताक्षर गर्ने सिक्रेट जारी हुन्छ, र तपाईंको एन्डपोइन्टले त्यो प्रयोग नगरेसम्म हरेक डेलिभरी प्रमाणीकरणमा असफल हुन्छ।
- उत्तर दिनुअघि काम गर्नु। 10 सेकेन्डभन्दा बढी लाग्ने ह्यान्डलर असफल गणिन्छ र इभेन्ट फेरि आउँछ, त्यसैले पहिले 2xx उत्तर दिनुहोस् र त्यसपछि प्रशोधन गर्नुहोस्।
easyCoexistence ले हरेक ग्राहकको WhatsApp नम्बर र सामाजिक खाता चौबिसै घण्टा हेर्छ, र जडान हुँदा, टुट्दा, हटाइँदा वा निलम्बन हुँदा तपाईंको प्लेटफर्मलाई हस्ताक्षरित इभेन्ट पठाउँछ, नम्बर टुट्दा Meta को कारणसहित। US$ 9 देखि US$ 0.75 सम्म प्रति कनेक्सन प्रति महिना, जडान थप्दै जाँदा घट्दै जान्छ, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
PRIMARY_INACTIVITY को अर्थ के हो?
यो Meta को कारण हो, जब Coexistence नम्बरको WhatsApp Business एप प्राथमिक उपकरणमा लगभग 14 दिनसम्म प्रयोग नभएको हुन्छ। त्यस ग्राहकका लागि नयाँ कनेक्ट सेसनले नम्बर फेरि जडान गर्छ।
के स्ट्याटस इभेन्टमा म्यासेजहरू हुन्छन्?
हुँदैन। यिनले कनेक्सनको स्थिति मात्र ढाक्छन्। नम्बरका म्यासेजहरू Meta बाट त्यसको आफ्नै वेबहुक गन्तव्यमा जान्छन्, र सामाजिक टिप्पणी तथा DM हरेक channel को गन्तव्यमा जान्छन्।
इभेन्ट यूआरएल कहाँ सेट गर्ने?
ड्यासबोर्डमा Profile, त्यसपछि Developers अन्तर्गत, वा MCP टुल set_partner_events_url मार्फत। हस्ताक्षर गर्ने सिक्रेट एकपटक मात्र देखाइन्छ, र यूआरएल फेरि बचत गर्दा नयाँ जारी हुन्छ।
के म channel इभेन्टहरू बेवास्ता गर्न सक्छु यदि म नम्बर मात्र ह्यान्डल गर्छु भने?
हो। channel.* इभेन्टका आफ्नै नाम हुन्छन् र connection को सट्टा channel object बोक्छन्, त्यसैले रिसिभरले connection बाट सुरु नहुने नामका कुनै पनि इभेन्ट छोड्न सक्छ।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको