Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

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.

~14 days

PRIMARY_INACTIVITY: Metin razlog kada je primarni uređaj bio neaktivan oko 14 dana, pa se Coexistence broj isključuje.

~30 days

COMPANION_INACTIVITY: Metin razlog kada je pomoćni uređaj bio neaktivan oko 30 dana.

account_update

Webhook koji prijavljuje prekid veze. Meta ga uvek šalje na podrazumevani callback URL aplikacije, nikad na zamenski.

7 attempts

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.

5 minutes

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.

connection.connectedA number connected, came back after a drop, or got its customer token on a second run.
connection.disconnectedMeta dropped the link; reason carries Meta's code when known.
connection.removedRemoved with DELETE /connections/{id} or from the dashboard.
connection.suspendedYour subscription lapsed; reason names its state.
connection.token_missingConnected without a customer token: it receives, but cannot send yet.
channel.connectedA social account connected, one event per Page when a sign-in brings several.
channel.disconnectedThe network refused the token, or the owner withdrew access.
channel.removedRemoved with DELETE /channels/{id} or from the dashboard, or the owner removed the app on Meta.
channel.suspendedYour subscription lapsed.

Š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.

connection.disconnected
{
  "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.

channel.disconnected
{
  "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_NUMBER i USER_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.

Python: verify, then handle each id once
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

Kako 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.
Ovo radite uz EasyCoexistence

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