Utiliser les accusés de lecture, la saisie en cours et les réactions
Rendez les échanges de service réactifs tout en préservant la sémantique des messages et des réactions.
Prérequis
Un message reçu, l'autorisation d'opérer l'expéditeur et une interaction de service prise en charge.
1. Définir la signification du signal
Marquez un message entrant comme lu lorsque votre équipe a intégré la conversation dans son flux de travail de service. WhatsApp marque également les messages antérieurs de cette conversation comme lus ; cette action accuse réception de plus que le seul message référencé. Utilisez la saisie en cours pendant la préparation d'une réponse, et non comme un indicateur permanent.
2. Utiliser l'opération publiée
Utilisez Marquer un message comme lu, POST /v1/whatsapp/messages/{message_id}/read, pour un message reçu. WhatsApp marque ce message et tous les messages antérieurs de la conversation comme lus. Définissez typing_indicator lorsque vous préparez une réponse. Un 202 confirme que l'accusé a été accepté pour traitement ; il ne prouve pas que le client a vu l'indicateur. Il n'existe ni webhook de livraison d'accusé ni message séparé à interroger.
Une fois que Meta a accepté l'accusé, le message reçu peut afficher read_at tout en conservant son statut received. L'accusé ne crée aucun message sortant facturable. Consultez l'opération publiée d'accusé de lecture pour l'expiration de la saisie en cours et l'ancienneté admissible des messages.
3. Gérer les changements de réaction
Abonnez-vous à whatsapp.reacted pour les changements de réaction entrants. Une réaction annote un message référencé ; ce n'est pas un autre message texte whatsapp.received. Un emoji null peut représenter une suppression. Conservez l'emoji exact plutôt que de normaliser des valeurs distinctes.
4. Séparer l'historique de l'état actuel
Utilisez le journal des réactions pour les changements et les réactions du message pour l'état actuel par expéditeur. Une référence fournisseur ancienne non résolue peut ne correspondre à aucune réaction ; l'absence d'une entrée ne prouve donc pas que le client n'a jamais réagi.
5. Tester la fin de l'interaction
Répétez les réactions ajoutées, remplacées et supprimées, le traitement différé et une réponse interrompue. Vérifiez que la réponse effective ou le transfert à un agent humain suit bien le signal.
Dépannage
Si une réaction est absente de la liste des messages, inspectez plutôt l'événement de réaction et le journal des messages référencés. Si la saisie en cours persiste dans l'état de votre application, examinez son expiration indépendamment de l'état de lecture. Consultez Événements WhatsApp pour la structure publiée du webhook.
Étapes suivantes
- Explorer la fonctionnalité WhatsApp associée.
- Trouver tous les guides et réponses expliquées WhatsApp.
- Préparer votre premier échange complet.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideConnecting WhatsApp to Bird: from buying a number to a live channelComprendre le conceptWhat is the 24-hour customer service window on WhatsApp?Utiliser l'outilWhatsApp message builderExplorer la fonctionnalitéWhatsApp
Essayez la pratique et obtenez un guide d'implémentation