De smb_app_state_sync-webhook
smb_app_state_sync bevat status uit de WhatsApp Business-app zelf, vooral de contactensynchronisatie die start wanneer een Coexistence-nummer verbinding maakt. Het staat los van history, dat gesprekken bevat, en bestaat alleen op Coexistence-nummers.
Coexistence-specifieke synchronisatievelden: dit veld en history.
Het tijdvenster na de aanmelding waarin synchronisatie moet starten.
Het equivalent op een nummer dat zonder Coexistence is aangemeld.
Wat het bevat
Appstatus, wat in de praktijk de contacten zijn die een bedrijf al op de telefoon had.
Elk contact met een WhatsApp-nummer kan met het platform worden gesynchroniseerd. Daardoor kan software een klant herkennen die al jaren in de telefoon van het bedrijf staat, in plaats van die als een nieuw nummer te behandelen. Dat verschilt van de gesprekken zelf, die via het history-veld binnenkomen. De twee zijn gescheiden omdat het ene een adresboek is en het andere een transcript.
Net als history bestaat dit alleen op Coexistence. Op een nummer dat nooit in een app zat, is er geen appstatus om te synchroniseren.
Wat het niet bevat
De eigen hulpmiddelen van de app, die geen weergave hebben aan de platformkant.
- Labels, die op het apparaat staan en niet door software kunnen worden gelezen.
- Snelle antwoorden en de begroetings- en afwezigheidsberichten.
- De catalogus, bestellingen en status.
- Kanalen en de geschiedenis van spraak- en videogesprekken.
Waarom dit belangrijk is voor een integratie
Omdat dit bepaalt of je systeem vanaf dag één weet wie er schrijft.
Zonder contactsynchronisatie komt elk inkomend bericht binnen als een telefoonnummer zonder naam. Het koppelen daarvan aan een klantrecord is dan jouw probleem. Met synchronisatie is de eigen contactenlijst van het bedrijf beschikbaar en is de koppeling grotendeels al gedaan.
Plan voor beide situaties, want een bedrijf kan synchronisatie weigeren of het tijdvenster missen. Een integratie die ervan uitgaat dat contacten bestaan, toont dan een muur van ruwe nummers aan iedereen die haar opent.
Veelgemaakte fouten
- Ervan uitgaan dat contacten beschikbaar zijn. Een bedrijf kan synchronisatie weigeren of het tijdvenster missen.
- Labels of snelle antwoorden in deze payload verwachten. Die blijven op het apparaat.
- Dit verwarren met history, dat gesprekken bevat en niet de contactenlijst.
EasyCoexistence abonneert zich op de operationele velden en legt de aanmeldingsvolgorde vast. Zo is op de tijdlijn zichtbaar wat een nummer wel of niet heeft gesynchroniseerd.
Veelgestelde vragen
Is dit hetzelfde als de history-synchronisatie?
Nee. Dit bevat appstatus, vooral contacten. history bevat de gesprekken.
Wordt dit vaker dan één keer uitgevoerd?
De eerste synchronisatie is een eenmalig onderdeel van de aanmelding, met hetzelfde tijdvenster van 24 uur als history.
Krijg ik labels?
Nee. Labels zijn een appfunctie zonder API-equivalent.
Bestaat dit op een normaal Cloud API-nummer?
Nee. Op zo'n nummer is er geen WhatsApp Business-appstatus om te synchroniseren.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op