Sign inGet started

Leesbevestigingen, typindicatoren en reacties gebruiken

Maak service-uitwisselingen responsief en behoud de semantiek van berichten en reacties.

Vereisten

Een ontvangen bericht, toestemming om de afzender te beheren en een ondersteunde service-interactie.

1. Bepaal wat het signaal betekent

Markeer een inkomend bericht als gelezen wanneer je team het gesprek in zijn serviceworkflow heeft opgenomen. WhatsApp markeert ook eerdere berichten in dat gesprek als gelezen, dus deze actie bevestigt meer dan alleen het verwezen bericht. Gebruik de typindicator tijdens het voorbereiden van een antwoord, niet als permanente indicator.

2. Gebruik de gepubliceerde operatie

Gebruik Een bericht als gelezen markeren, POST /v1/whatsapp/messages/{message_id}/read, voor een ontvangen bericht. WhatsApp markeert dat bericht en elk eerder bericht in het gesprek als gelezen. Stel typing_indicator in wanneer je een antwoord voorbereidt. Een 202 bevestigt dat de leesbevestiging is geaccepteerd voor verwerking; het bewijst niet dat de klant de indicator heeft gezien. Er is geen webhook voor bezorging van leesbevestigingen en geen apart bericht om te pollen.
Nadat Meta de bevestiging heeft geaccepteerd, kan het ontvangen bericht read_at tonen terwijl het zijn received-status behoudt. De bevestiging genereert geen factureerbaar uitgaand bericht. Volg de gepubliceerde leesbevestigingsoperatie voor de vervaltijd van typindicatoren en de toegestane berichtleeftijd.

3. Reactiewijzigingen afhandelen

Abonneer je op whatsapp.reacted voor inkomende reactiewijzigingen. Een reactie annoteert een verwezen bericht; het is geen nieuw whatsapp.received-tekstbericht. Een null-emoji kan verwijdering vertegenwoordigen. Bewaar de exacte emoji in plaats van verschillende waarden te normaliseren.

4. Houd geschiedenis en huidige status gescheiden

Gebruik het reactielog voor wijzigingen en de reacties van het bericht voor de huidige status per afzender. Een onopgeloste oudere providerverwijzing kan geen gekoppelde reactie opleveren, dus de afwezigheid van een vermelding bewijst niet dat de klant nooit heeft gereageerd.

5. Test het einde van de interactie

Oefen met toegevoegde, vervangen en verwijderde reacties, vertraagde verwerking en een onderbroken antwoord. Zorg dat het daadwerkelijke antwoord of de overdracht aan een medewerker op het signaal volgt.

Probleemoplossing

Als een reactie ontbreekt in de berichtenlijst, bekijk dan het reactie-event en het log van verwezen berichten. Als de typindicator actief blijft in je applicatiestatus, controleer dan de vervaltijd los van de leesstatus. Zie WhatsApp-events voor de gepubliceerde webhookvorm.

Vervolgstappen