Sign inGet started

Używaj potwierdzeń odczytu, wskaźnika pisania i reakcji

Zapewnij szybkie reakcje w rozmowach z obsługą klienta, zachowując semantykę wiadomości i reakcji.

Wymagania wstępne

Odebrana wiadomość, uprawnienie do operowania nadawcą oraz obsługiwana interakcja usługowa.

1. Zdecyduj, co oznacza sygnał

Oznacz wiadomość przychodzącą jako przeczytaną, gdy Twój zespół przejął konwersację do swojego przepływu obsługi. WhatsApp oznacza również wcześniejsze wiadomości w tej konwersacji jako przeczytane, więc ta akcja potwierdza więcej niż tylko wskazaną wiadomość. Używaj wskaźnika pisania podczas przygotowywania odpowiedzi, a nie jako stałego sygnału.

2. Użyj opublikowanej operacji

Użyj Oznacz wiadomość jako przeczytaną, POST /v1/whatsapp/messages/{message_id}/read, dla odebranej wiadomości. WhatsApp oznacza tę wiadomość i każdą wcześniejszą wiadomość w konwersacji jako przeczytaną. Ustaw typing_indicator, gdy przygotowujesz odpowiedź. 202 potwierdza, że potwierdzenie odczytu zostało przyjęte do przetwarzania; nie dowodzi, że klient zobaczył wskaźnik. Nie ma webhooka dostarczenia potwierdzenia ani osobnej wiadomości do odpytywania.
Po zaakceptowaniu potwierdzenia przez Meta odebrana wiadomość może wyświetlać read_at, zachowując swój status received. Potwierdzenie nie tworzy płatnej wiadomości wychodzącej. Postępuj zgodnie z opublikowaną operacją potwierdzenia odczytu w kwestii wygasania wskaźnika pisania i dopuszczalnego wieku wiadomości.

3. Obsłuż zmiany reakcji

Subskrybuj whatsapp.reacted dla przychodzących zmian reakcji. Reakcja jest adnotacją do wskazanej wiadomości; nie jest kolejną wiadomością tekstową whatsapp.received. Wartość null emoji może oznaczać usunięcie. Zachowuj dokładne emoji zamiast normalizować odrębne wartości.

4. Oddzielaj historię od bieżącego stanu

Używaj logu reakcji do śledzenia zmian, a reakcji wiadomości do bieżącego stanu per nadawca. Nierozwiązane starsze odniesienie dostawcy może nie dać dopasowanej reakcji, więc brak wpisu nie dowodzi, że klient nigdy nie zareagował.

5. Przetestuj zakończenie interakcji

Przećwicz dodane, zastąpione i usunięte reakcje, opóźnione przetwarzanie oraz przerwaną odpowiedź. Upewnij się, że właściwa odpowiedź lub przekazanie do człowieka następuje po sygnale.

Rozwiązywanie problemów

Jeśli reakcja nie pojawia się na liście wiadomości, sprawdź zdarzenie reakcji i log powiązanych wiadomości. Jeśli wskaźnik pisania utrzymuje się w stanie Twojej aplikacji, sprawdź jego wygasanie niezależnie od stanu odczytu. Zobacz zdarzenia WhatsApp, aby poznać opublikowany kształt webhooka.

Następne kroki