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
- Verken de gerelateerde WhatsApp-mogelijkheid.
- Vind alle WhatsApp-handleidingen en uitleg.
- Bereid je eerste volledige uitwisseling voor.
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Bekijk de gidsConnecting WhatsApp to Bird: from buying a number to a live channelBegrijp het conceptWhat is the 24-hour customer service window on WhatsApp?Gebruik de toolWhatsApp message builderOntdek de mogelijkheidWhatsApp
Probeer de oefening en ontvang een implementatieoverzicht