Kako saznati kada se WhatsApp ili društvena veza klijenta prekine
easyCoexistence šalje potpisane statusne događaje kada se veza klijenta uspostavi, prekine, ukloni ili suspenduje. WhatsApp broj šalje connection.connected, connection.disconnected sa Metinim razlogom, connection.removed, connection.suspended ili connection.token_missing; društveni nalog šalje odgovarajuće channel.* događaje, bez token_missing. Svaki je JSON POST potpisan sa X-EC-Signature i ponovo se pokušava, uz rastuće razmake, oko 33 sata, dok vaš endpoint ne odgovori sa 2xx.
PRIMARY_INACTIVITY: Metin razlog kada je primarni uređaj bio neaktivan oko 14 dana, pa se Coexistence broj isključuje.
COMPANION_INACTIVITY: Metin razlog kada je pomoćni uređaj bio neaktivan oko 30 dana.
Webhook koji prijavljuje prekid veze. Meta ga uvek šalje na podrazumevani callback URL aplikacije, nikad na zamenski.
Koliko se često statusni događaj pokušava ponovo posle svakog odgovora van 2xx, sa razmacima od 1 minut do 24 sata, tokom oko 33 sata.
Najstariji potpisani vremenski žig t koji endpoint treba da prihvati za statusni događaj, uz poređenje HMAC-a u konstantnom vremenu.
Koji statusni događaji postoje?
Devet, u dve porodice koje dele jedan endpoint i jedan tajni ključ za potpisivanje. Brojevi koriste connection.*, a društveni nalozi channel.*, pa prijemnik napisan za brojeve može po imenu preskočiti channel događaje. Endpoint postavite na kontrolnoj tabli, u delu Profile, zatim Developers, ili MCP alatom set_partner_events_url; tajni ključ za potpisivanje prikazuje se samo jednom, kada se URL sačuva.
Šta nosi događaj veze?
ID isporuke, UUID; ime događaja; occurred_at u ISO 8601; i objekat connection sa id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status i token_ready. Neki događaji dodaju polje na najvišem nivou: reason na connection.disconnected i connection.suspended, detected_by sa vrednošću health_check kada je periodična provera u easyCoexistence-u otkrila prekid, a ne Metin webhook, i connect_session_id kada ga je proizvela connect session.
{
"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"
}Šta nosi događaj kanala?
Isti omotač, sa objektom channel umesto connection. To je prikaz GET /channels/{id}: id, channel za mrežu, external_ref, connect_session_id, name, username, external_id, status, token_ready, webhook_url, disconnected_reason, last_checked_at i created_at. Za kanale nema token_missing, jer prijava preko društvene mreže uvek daje klijentov sopstveni token, a channel.connected koji potiče iz connect session-a na najvišem nivou takođe nosi 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"
}
}Šta znače razlozi prekida?
reason na connection.disconnected je kod koji je Meta stavila u disconnection_info svog account_update webhook-a, a Meta ga uključuje za brojeve i u aplikaciji WhatsApp Business i u Cloud API-ju. Null je kada Meta nije dala nijedan. Kodovi iz Metine reference:
PRIMARY_INACTIVITY: telefon sa aplikacijom WhatsApp Business bio je neaktivan oko 14 dana, po pravilu od 14 dana. Nova connect session ponovo povezuje broj.ACCOUNT_DISCONNECTED: nalog je prekinut Metinom merom ili od strane klijenta, koji je možda uklonio pristup ili obrisao nalog.COMPANION_INACTIVITY: pomoćni uređaj bio je neaktivan oko 30 dana.BUSINESS_DOWNGRADE: broj je bio registrovan u potrošačkoj aplikaciji WhatsApp.CHANGE_NUMBERiUSER_RE_REGISTERED: klijent je promenio broj ili ga ponovo registrovao na novom uređaju.
Koja zaglavlja dolaze uz statusni događaj?
Pet, pri svakom pokušaju: Content-Type application/json, User-Agent easyCoexistence-webhooks/1, X-EC-Event sa imenom događaja, X-EC-Delivery sa istim id-om kao u telu i X-EC-Signature. Potpis glasi t=<unix>,v1=<hex>, gde je v1 HMAC-SHA256 od t, tačke i sirovog tela, ključem vašeg naloga koji počinje sa whsec_. Svaki pokušaj se potpisuje ispočetka, pa ponovni pokušaj nosi novi t nad istim telom.
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 200Kako se neuspele isporuke ponovo pokušavaju?
Prvi pokušaj ide čim se događaj desi. Odgovor van 2xx, odsustvo odgovora u roku od 10 sekundi, mrežna greška ili preusmeravanje računaju se kao neuspeh, pa se događaj ponovo pokušava sa rastućim razmacima, od 1 minut do 24 sata, ukupno sedam pokušaja tokom oko 33 sata, pre nego što se odbaci. Isporuke idu samo na HTTPS adresu koja se razrešava u javnu IP adresu. Događaj koji se desi dok endpoint nije postavljen se nikad ne stavlja u red čekanja, a uklanjanje endpointa zaustavlja sve što čeka.
Zašto obraditi svaki id jednom i proveriti occurred_at?
Zato što ponovni pokušaj ponavlja isporuku tačno, sa istim id-om u telu i u X-EC-Delivery, i zato što ponovljen događaj može stići posle novijeg. Sačuvajte id-ove koje ste obradili i preskačite ponavljanja. Zatim uporedite occurred_at sa poslednjim stanjem koje ste zabeležili za tu vezu, ili pročitajte GET /connections/{id} ili GET /channels/{id} pre nego što reagujete na događaj koji bi mogao biti zastareo.
Šta platforma treba da uradi kada broj otpadne?
Reaguje na razlog. Posle PRIMARY_INACTIVITY zamolite klijenta da otvori aplikaciju WhatsApp Business i pošaljite mu novu connect session za isti broj. Ponovno povezivanje na istom WhatsApp Business nalogu zadržava ID veze, ponovo postavlja odredište webhooka i šalje connection.connected, posle čega ponovo čitate njegove akreditive. connection.token_missing znači da Meta nije izdala token u tom pokušaju. Meta šalje account_update iza prekida samo na callback aplikacije, nikad na vaš URL, pa je ovaj događaj način na koji vaša platforma sazna za to.
Šta platforma treba da uradi kada društveni nalog otpadne?
Na channel.disconnected, nova connect session sa istim kanalom ponovo prijavljuje nalog, pod istim ID-om kanala. channel.removed znači da pristup više ne postoji: token se zaboravlja i odredište webhooka se briše, pa ga ponovo postavite ako se klijent ponovo poveže. Suspendovan broj ili kanal vraća se ponovnim povezivanjem kada je vaša pretplata ponovo aktivna.
Česte greške
- Tretiranje ponovnog pokušaja kao novog događaja. Nosi isti id u telu i u X-EC-Delivery, pa beležite obrađene id-ove, inače jedan prekid može dva puta obavestiti klijenta.
- Primenjivanje događaja po redosledu dolaska. Ponovljen događaj može stići posle novijeg, pa uporedite occurred_at ili pročitajte vezu pre nego što reagujete.
- Ponovno čuvanje URL-a za događaje radi ispravke tipfelera bez ažuriranja backend-a. Čuvanje izdaje novi tajni ključ za potpisivanje, pa svaka isporuka pada u proveri potpisa dok vaš endpoint ne počne da ga koristi.
- Obavljanje posla pre odgovora. Obrada koja traje duže od 10 sekundi računa se kao neuspeh i događaj se vraća, zato prvo odgovorite sa 2xx, pa obrađujte.
easyCoexistence neprekidno prati WhatsApp broj i društvene naloge svakog klijenta i šalje vašoj platformi potpisan događaj kada se veza uspostavi, prekine, ukloni ili suspenduje, sa Metinim razlogom za broj koji se prekine. Od US$ 9 do US$ 0,75 po vezi mesečno, sa smanjenjem kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Šta znači PRIMARY_INACTIVITY?
To je Metin razlog za prekid Coexistence broja čija je aplikacija WhatsApp Business ostala neiskorišćena na primarnom uređaju oko 14 dana. Nova connect session za tog klijenta ponovo povezuje broj.
Da li statusni događaji sadrže poruke?
Ne. Pokrivaju status veze. Poruke broja idu od Mete na njegovo sopstveno odredište webhooka, a komentari i DM poruke sa društvenih mreža na odredište svakog kanala.
Gde postavljam URL za događaje?
Na kontrolnoj tabli, u delu Profile, pa Developers, ili MCP alatom set_partner_events_url. Tajni ključ za potpisivanje prikazuje se jednom, a ponovnim čuvanjem URL-a izdaje se novi.
Mogu li ignorisati channel događaje ako obrađujem samo brojeve?
Da. channel.* događaji imaju sopstvena imena i nose objekat channel umesto connection, pa prijemnik može preskočiti svaki događaj čije ime ne počinje sa connection.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na