Πώς να μάθετε πότε αποσυνδέεται η σύνδεση WhatsApp ή social ενός πελάτη;
Το easyCoexistence στέλνει υπογεγραμμένα γεγονότα κατάστασης όταν μια σύνδεση πελάτη συνδέεται, αποσυνδέεται, αφαιρείται ή αναστέλλεται. Ένας αριθμός WhatsApp στέλνει connection.connected, connection.disconnected με τον λόγο της Meta, connection.removed, connection.suspended ή connection.token_missing. Ένας λογαριασμός social στέλνει τα αντίστοιχα channel.*, χωρίς token_missing. Κάθε γεγονός είναι ένα JSON POST υπογεγραμμένο με X-EC-Signature και επαναλαμβάνεται με αυξανόμενα διαστήματα για περίπου 33 ώρες, έως ότου το endpoint σας απαντήσει με 2xx.
PRIMARY_INACTIVITY: ο λόγος της Meta όταν η κύρια συσκευή ήταν ανενεργή για περίπου 14 ημέρες, με αποτέλεσμα την αποσύνδεση ενός αριθμού Coexistence.
COMPANION_INACTIVITY: ο λόγος της Meta όταν μια συνοδευτική συσκευή ήταν ανενεργή για περίπου 30 ημέρες.
Το webhook που αναφέρει μια αποσύνδεση. Η Meta το στέλνει πάντα στην προεπιλεγμένη διεύθυνση επιστροφής κλήσης της εφαρμογής, ποτέ σε εναλλακτική διεύθυνση.
Πόσο συχνά ξαναδοκιμάζεται ένα γεγονός κατάστασης μετά από κάθε απάντηση εκτός 2xx, με διαστήματα από 1 λεπτό έως 24 ώρες, για περίπου 33 ώρες.
Ο παλαιότερος υπογεγραμμένος χρόνος t που ένα endpoint πρέπει να δέχεται σε γεγονός κατάστασης, με σύγκριση του HMAC σε σταθερό χρόνο.
Ποια γεγονότα κατάστασης υπάρχουν;
Εννέα, σε δύο οικογένειες που μοιράζονται ένα endpoint και ένα μυστικό υπογραφής. Οι αριθμοί χρησιμοποιούν connection.* και οι λογαριασμοί social χρησιμοποιούν channel.*, οπότε ένας δέκτης γραμμένος για αριθμούς μπορεί να παραλείπει τα γεγονότα channel με βάση το όνομά τους. Ορίστε το endpoint στον πίνακα ελέγχου, στο Profile και μετά στο Developers, ή με το εργαλείο MCP set_partner_events_url. Το μυστικό υπογραφής εμφανίζεται μία φορά, όταν αποθηκευτεί η διεύθυνση.
Τι μεταφέρει ένα γεγονός σύνδεσης;
Το id της παράδοσης (ένα UUID), το όνομα του γεγονότος, το occurred_at σε μορφή ISO 8601 και ένα αντικείμενο connection με τα πεδία id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status και token_ready. Ορισμένα γεγονότα προσθέτουν ένα πεδίο στο ανώτερο επίπεδο: reason στα connection.disconnected και connection.suspended, detected_by με τιμή health_check όταν ο δικός μας περιοδικός έλεγχος εντόπισε την αποσύνδεση και όχι το webhook της 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. Είναι η προβολή 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, καθώς μια σύνδεση social δίνει πάντα το δικό της token του πελάτη. Ένα 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"
}
}Τι σημαίνουν οι λόγοι αποσύνδεσης;
Το reason στο connection.disconnected είναι ο κωδικός που έβαλε η Meta στο disconnection_info του webhook account_update της. Η Meta τον περιλαμβάνει για αριθμούς τόσο στην εφαρμογή WhatsApp Business όσο και στο Cloud API. Είναι null όταν η 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 με το όνομα του γεγονότος, X-EC-Delivery με το ίδιο id με το σώμα και X-EC-Signature. Η υπογραφή έχει τη μορφή t=<unix>,v1=<hex>, όπου το v1 είναι το HMAC-SHA256 του t, μιας τελείας και του ακατέργαστου σώματος, με κλειδί το μυστικό υπογραφής του λογαριασμού σας, το οποίο αρχίζει με 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. Ένα γεγονός που συμβαίνει όσο δεν έχει οριστεί endpoint δεν μπαίνει ποτέ σε ουρά, και η αφαίρεση του endpoint σταματά ό,τι εκκρεμεί.
Γιατί να επεξεργάζεστε κάθε id μία φορά και να ελέγχετε το occurred_at;
Επειδή μια επανάληψη επαναλαμβάνει την παράδοση ακριβώς, με το ίδιο id στο σώμα και στο X-EC-Delivery, και επειδή ένα γεγονός που ξαναδοκιμάζεται μπορεί να φτάσει μετά από ένα νεότερο. Αποθηκεύστε τα id που έχετε επεξεργαστεί και παραλείψτε τις επαναλήψεις. Έπειτα συγκρίνετε το occurred_at με την τελευταία κατάσταση που καταγράψατε για τη σύνδεση, ή διαβάστε το GET /connections/{id} ή το GET /channels/{id} πριν ενεργήσετε σε ένα γεγονός που ίσως είναι παρωχημένο.
Τι πρέπει να κάνει μια πλατφόρμα όταν αποσυνδέεται ένας αριθμός;
Ενεργήστε με βάση τον λόγο. Μετά από PRIMARY_INACTIVITY, ζητήστε από τον πελάτη να ανοίξει την εφαρμογή WhatsApp Business και στείλτε του μια νέα συνεδρία σύνδεσης για τον ίδιο αριθμό. Η επανασύνδεση στον ίδιο λογαριασμό WhatsApp Business διατηρεί το ID σύνδεσής του, επαναφέρει τον προορισμό webhook σας και στέλνει connection.connected. Μετά από αυτό διαβάζετε ξανά τα στοιχεία του. Το connection.token_missing σημαίνει αντίθετα ότι η Meta δεν εξέδωσε token σε εκείνη την εκτέλεση. Η Meta στέλνει το account_update που συνοδεύει μια αποσύνδεση μόνο στο callback της ίδιας της εφαρμογής, ποτέ στη διεύθυνσή σας, οπότε αυτό το γεγονός είναι ο τρόπος με τον οποίο η πλατφόρμα σας το μαθαίνει.
Τι πρέπει να κάνει μια πλατφόρμα όταν αποσυνδέεται ένας λογαριασμός social;
Στο channel.disconnected, μια νέα συνεδρία σύνδεσης με το ίδιο κανάλι συνδέει ξανά τον λογαριασμό, με το ίδιο ID καναλιού. Το channel.removed σημαίνει ότι η πρόσβαση έχει χαθεί: το token ξεχνιέται και ο προορισμός webhook εκκαθαρίζεται, οπότε ορίστε ξανά τον προορισμό αν ο πελάτης επανασυνδεθεί. Ένας ανασταλμένος αριθμός ή κανάλι επανέρχεται με επανασύνδεση, αφού ενεργοποιηθεί ξανά η συνδρομή σας.
Συνηθισμένα λάθη
- Αντιμετώπιση μιας επανάληψης ως νέου γεγονότος. Έχει το ίδιο id στο σώμα και στο X-EC-Delivery. Γι' αυτό καταγράψτε τα id που έχετε επεξεργαστεί, αλλιώς μία αποσύνδεση μπορεί να ειδοποιήσει τον πελάτη δύο φορές.
- Εφαρμογή των γεγονότων με τη σειρά άφιξης. Ένα γεγονός που ξαναδοκιμάζεται μπορεί να φτάσει μετά από ένα νεότερο, οπότε συγκρίνετε το occurred_at ή διαβάστε τη σύνδεση πριν ενεργήσετε.
- Αποθήκευση ξανά της διεύθυνσης γεγονότων για διόρθωση τυπογραφικού λάθους χωρίς ενημέρωση του backend. Η αποθήκευση εκδίδει νέο μυστικό υπογραφής, και κάθε παράδοση αποτυγχάνει στον έλεγχο υπογραφής έως ότου το endpoint σας το χρησιμοποιεί.
- Η εκτέλεση της εργασίας πριν από την απάντηση. Ένας χειριστής που χρειάζεται πάνω από 10 δευτερόλεπτα μετράει ως αποτυχία και το γεγονός επιστρέφει. Απαντήστε πρώτα με 2xx και επεξεργαστείτε στη συνέχεια.
Το easyCoexistence παρακολουθεί τον αριθμό WhatsApp και τους λογαριασμούς social κάθε πελάτη όλο το εικοσιτετράωρο. Στέλνει στην πλατφόρμα σας υπογεγραμμένο γεγονός όταν ένας συνδέεται, αποσυνδέεται, αφαιρείται ή αναστέλλεται, με τον λόγο της Meta για κάθε αριθμό που αποσυνδέεται. US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Τι σημαίνει το PRIMARY_INACTIVITY;
Είναι ο λόγος της Meta για την αποσύνδεση ενός αριθμού Coexistence του οποίου η εφαρμογή WhatsApp Business έμεινε αχρησιμοποίητη στην κύρια συσκευή για περίπου 14 ημέρες. Μια νέα συνεδρία σύνδεσης για τον πελάτη επανασυνδέει τον αριθμό.
Τα γεγονότα κατάστασης περιλαμβάνουν μηνύματα;
Όχι. Καλύπτουν την κατάσταση μιας σύνδεσης. Τα μηνύματα ενός αριθμού πηγαίνουν από τη Meta στον δικό του προορισμό webhook, και τα σχόλια και τα DM των λογαριασμών social στον προορισμό κάθε καναλιού.
Πού ορίζω τη διεύθυνση γεγονότων;
Στον πίνακα ελέγχου, στο Profile και μετά στο Developers, ή με το εργαλείο MCP set_partner_events_url. Το μυστικό υπογραφής εμφανίζεται μία φορά, και η αποθήκευση της διεύθυνσης ξανά εκδίδει νέο.
Μπορώ να αγνοώ τα γεγονότα καναλιών αν διαχειρίζομαι μόνο αριθμούς;
Ναι. Τα channel.* έχουν δικά τους ονόματα και φέρουν αντικείμενο channel αντί για connection, οπότε ένας δέκτης μπορεί να παραλείπει κάθε γεγονός του οποίου το όνομα δεν αρχίζει με connection.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις