Lesebestätigungen, Tippanzeige und Reaktionen verwenden

Gestalten Sie Service-Austausche reaktionsschnell und bewahren Sie dabei die Semantik von Nachrichten und Reaktionen.

Voraussetzungen

Eine empfangene Nachricht, die Berechtigung zum Betrieb des Absenders und eine unterstützte Service-Interaktion.

1. Bedeutung des Signals festlegen

Markieren Sie eine eingehende Nachricht als gelesen, wenn Ihr Team die Konversation in seinen Service-Workflow übernommen hat. WhatsApp markiert auch frühere Nachrichten in dieser Konversation als gelesen, sodass diese Aktion mehr als nur die referenzierte Nachricht bestätigt. Verwenden Sie die Tippanzeige während der Vorbereitung einer Antwort, nicht als permanenten Indikator.

2. Die veröffentlichte Operation verwenden

Verwenden Sie Nachricht als gelesen markieren, POST /v1/whatsapp/messages/{message_id}/read, für eine empfangene Nachricht. WhatsApp markiert diese Nachricht und jede frühere Nachricht in der Konversation als gelesen. Setzen Sie typing_indicator, wenn Sie eine Antwort vorbereiten. Ein 202 bestätigt, dass die Lesebestätigung zur Verarbeitung angenommen wurde; es beweist nicht, dass der Kunde den Indikator gesehen hat. Es gibt keinen Zustellungs-Webhook für Lesebestätigungen und keine separate Nachricht zum Abfragen.

Nachdem Meta die Lesebestätigung akzeptiert hat, kann die empfangene Nachricht read_at anzeigen und gleichzeitig ihren received-Status behalten. Die Lesebestätigung erzeugt keine abrechenbare ausgehende Nachricht. Beachten Sie die veröffentlichte Lesebestätigungs-Operation für den Ablauf der Tippanzeige und das zulässige Nachrichtenalter.

3. Reaktionsänderungen verarbeiten

Abonnieren Sie whatsapp.reacted für eingehende Reaktionsänderungen. Eine Reaktion annotiert eine referenzierte Nachricht; sie ist keine weitere whatsapp.received-Textnachricht. Ein Emoji-Wert von null kann das Entfernen einer Reaktion darstellen. Bewahren Sie das exakte Emoji, anstatt unterschiedliche Werte zu normalisieren.

4. Verlauf und aktuellen Zustand trennen

Verwenden Sie das Reaktionsprotokoll für Änderungen und die Reaktionen der Nachricht für den aktuellen Zustand pro Absender. Eine unaufgelöste ältere Anbieter-Referenz kann dazu führen, dass keine passende Reaktion vorhanden ist. Das Fehlen eines Eintrags beweist also nicht, dass der Kunde nie reagiert hat.

5. Das Ende der Interaktion testen

Testen Sie hinzugefügte, ersetzte und entfernte Reaktionen, verzögerte Verarbeitung und eine unterbrochene Antwort. Stellen Sie sicher, dass die eigentliche Antwort oder die Übergabe an einen Menschen dem Signal folgt.

Fehlerbehebung

Wenn eine Reaktion in der Nachrichtenliste fehlt, prüfen Sie stattdessen das Reaktionsereignis und das Protokoll der referenzierten Nachrichten. Wenn die Tippanzeige in Ihrem Anwendungszustand bestehen bleibt, überprüfen Sie deren Ablauf getrennt vom Lesestatus. Siehe WhatsApp-Ereignisse für die veröffentlichte Webhook-Struktur.