Sign inGet started

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