WhatsApp-webhookvelden en waar ze naartoe gaan

Wat bevat elk veld?

messages bevat alles wat een klant naar het nummer stuurt: tekst, mediaverwijzingen, antwoorden en reacties. smb_message_echoes bevat wat je team vanuit de WhatsApp Business-app verstuurt. Dit bestaat alleen op een Coexistence-nummer en laat software de antwoorden van een medewerker zien.

account_update bevat de verbindingsstatus: PARTNER_REMOVED wanneer de app van het account wordt verwijderd, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED en gebeurtenissen rond beperkingen of overtredingen. phone_number_quality_update bevat wijzigingen in kwaliteitsbeoordeling en verwerkingscapaciteit. account_alerts bevat waarschuwingen die Meta aan het account richt, en account_review_update bevat de uitkomst van een beoordeling.

business_capability_update bevat wijzigingen in berichtlimieten en mogelijkheden, en phone_number_name_update bevat goedkeuringen en afwijzingen van de weergavenaam.

Waarom is deze splitsing architectonisch belangrijk?

Omdat ze bepaalt of gespreksinhoud ooit een provider bereikt.

De override stuurt de twee berichtvelden rechtstreeks vanuit Meta naar je endpoint. De zes operationele velden blijven naar de provider gaan. Daardoor zijn een dashboard en waarschuwingen mogelijk zonder dat iemand een bericht hoeft te bewaren.

Daarom kan de bewering dat we geen berichten opslaan structureel zijn, en niet alleen een beleidsregel. Als de berichtvelden ergens anders worden afgeleverd, bestaat er geen codepad waarop ze kunnen worden opgeslagen. In ons geval valt een account zonder override terug op de standaardcallback, waar de handler deze gebeurtenissen laat vallen zonder ze op te slaan.

Welke velden moet je handler verwachten?

Alleen de twee berichtvelden als de override is ingesteld. Het is verstandig je handler alles andere te laten negeren in plaats van daarop te laten falen.

Meta voegt in de loop van de tijd velden toe en een payload kan zonder waarschuwing nieuwe sleutels krijgen. Een handler die op de veldnaam schakelt en onbekende velden negeert, blijft werken. Een handler die een vaste vorm veronderstelt, faalt bij de eerste onbekende gebeurtenis.

Het is ook verstandig smb_message_echoes expliciet af te handelen in plaats van het als ruis te behandelen. Zonder dit veld weet software niet dat een medewerker al heeft geantwoord, waardoor een klant twee antwoorden op dezelfde vraag kan krijgen.

Veelgemaakte fouten

• Uitgaan van een generieke payload. Elke gebeurtenis noemt zijn veld en de handler moet daarop schakelen.
• smb_message_echoes negeren. Zonder dit veld reageert software boven op een medewerker die al heeft geantwoord.
• Falen op onbekende velden in plaats van ze over te slaan. Meta voegt velden toe zonder het te vragen.

Veelgestelde vragen

Lees verder