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
- Poznaj powiązaną funkcję WhatsApp.
- Znajdź wszystkie przewodniki i wyjaśnienia dotyczące WhatsApp.
- Przygotuj swoją pierwszą pełną wymianę.
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Obejrzyj przewodnikConnecting WhatsApp to Bird: from buying a number to a live channelZrozum koncepcjęWhat is the 24-hour customer service window on WhatsApp?Użyj narzędziaWhatsApp message builderPoznaj możliwościWhatsApp
Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy