account_update-webhook ja kaikki yhteyden katkeamisen syyt
account_update on tapa, jolla Meta ilmoittaa yhteyden tilan muuttumisesta. Sen event-kenttä kertoo, mitä tapahtui, ja poistossa disconnection_info.reason kertoo syyn. Syy ratkaisee, palaako numero takaisin vai onko se menetetty.
Event, jonka Meta lähettää, kun sovellus poistetaan tililtä.
Nimetyt katkeamissyyt, jotka poisto voi sisältää.
Ensisijaisen laitteen käyttämättömyysjakso, joka saapuu arvona PRIMARY_INACTIVITY.
Mitä tapahtumia account_update sisältää?
PARTNER_REMOVED, kun sovellus poistetaan WhatsApp Business -tililtä. Tämä on luotettava yhteyden katkeamisen signaali ja se, jonka varaan kannattaa rakentaa sen sijaan, että katkeaminen päätellään kentän muuttumisesta epätodeksi.
ACCOUNT_OFFBOARDED, kun numero poistetaan kokonaan käytöstä. ACCOUNT_RECONNECTED, kun aiemmin poistettu yhteys palaa. Lisäksi valvontatapahtumat ACCOUNT_RESTRICTION ja ACCOUNT_VIOLATION sekä tapahtumat, joiden nimessä on DISABLED tai BAN.
Myös vahvistus- ja hyväksyntätulokset saapuvat tänne, ja tapahtumien nimissä on VERIFIED tai APPROVED. Käsittelijän tulee valita toiminto event-nimen perusteella ja käsitellä tuntemattomat nimet tiedoksiantona sen sijaan, että se epäonnistuisi, koska Meta lisää tapahtumia ilman ennakkoilmoitusta.
Mitkä ovat yhteyden katkeamisen syyt?
Niitä on kuusi, ja niiden merkitykset poikkeavat toisistaan huomattavasti.
PRIMARY_INACTIVITY tarkoittaa noin 14 päivän sääntöä: WhatsApp Business -sovellusta ei ole avattu ensisijaisella laitteella. Yhteys voidaan palauttaa, ja tämä on selvästi yleisin syy.
COMPANION_INACTIVITY tarkoittaa samaa kumppanilaitteella, mutta pidemmällä, noin 30 päivän ajanjaksolla.
BUSINESS_DOWNGRADE tarkoittaa, että numero siirtyi takaisin kuluttajille tarkoitettuun WhatsApp-sovellukseen. Tämä lopettaa Coexistencen, koska Coexistence edellyttää Business-sovellusta.
CHANGE_NUMBER tarkoittaa, että puhelinnumero vaihtui. USER_RE_REGISTERED tarkoittaa, että numero rekisteröitiin uudelleen uudella laitteella. ACCOUNT_DISCONNECTED tarkoittaa, että asiakas katkaisi yhteyden tarkoituksella tai valvonta katkaisi sen.
Syy saapuu myös yhdessä kentän disconnection_info.initiated_by kanssa. Se kertoo, tekikö katkaisun henkilö vai järjestelmä.
Miksi syy on tapahtumaa tärkeämpi?
Koska PARTNER_REMOVED ei yksin kerro, mitä pitäisi tehdä.
PRIMARY_INACTIVITY-syystä poistettu numero palaa takaisin: yritys avaa sovelluksen, yhdistää sen uudelleen ja kaikki jatkuu. Jos tätä käsitellään lähteneenä asiakkaana, seurauksena on peruutusviesti asiakkaalle, joka on edelleen asiakas.
BUSINESS_DOWNGRADE- tai ACCOUNT_DISCONNECTED-syystä poistettu numero on eri tilanne. Jos sitä käsitellään väliaikaisena, yhteys voi jäädä pysyvästi odottavaan tilaan.
Kun poisto saapuu ilman syytä, initiated_by toimii varamerkkinä: henkilön tekemä poisto vaikuttaa tarkoitukselliselta, kun taas selittämätön järjestelmän tekemä poisto ei. Tämä ero kannattaa käsitellä koodissa eikä myöhemmin tukikeskustelussa.
Yleiset virheet
- Kaikkien PARTNER_REMOVED-tapahtumien käsittely samalla tavalla. Syy erottaa kahden viikon hiljaisuuden asiakkaasta, joka lähti.
- Katkeamisen päättelemisen kentän muuttumisesta epätodeksi tämän tapahtuman sijaan. Näin syntyy vääriä hälytyksiä.
- Tuntemattoman event-nimen käsittely virheenä. Meta lisää tapahtumia, ja käsittelijän tulee ohittaa nimet, joita se ei tunne.
EasyCoexistence käsittelee kaikki nämä nimien perusteella, tallentaa syyn yhteyden aikajanalle ja erottaa palautettavan käyttämättömyydestä johtuvan poiston numerosta, joka on todella menetetty.
Usein kysytyt kysymykset
Onko PARTNER_REMOVED pysyvä?
Yleensä ei. Useimmissa tapauksissa mukana on PRIMARY_INACTIVITY, mikä tarkoittaa, ettei sovellusta avattu. Uudelleenyhdistäminen palauttaa kaiken.
Palauttaako uudelleenyhdistäminen webhook-kohteeni?
Ei, ja juuri tässä on ansa. Kohde on sovelluksen tilauksen ohitusasetus, ja se poistetaan sovelluksen mukana. Se on määritettävä uudelleen.
Mikä on COMPANION_INACTIVITY?
Sama käyttämättömyysperiaate kumppanilaitteella ensisijaisen laitteen sijaan, mutta pidemmällä, noin 30 päivän ajanjaksolla.
Voinko saada tämän tapahtuman ilman syytä?
Kyllä. Silloin disconnection_info.initiated_by on ainoa signaali siitä, oliko katkaisu tarkoituksellinen.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu