Webhook smb_app_state_sync
smb_app_state_sync przenosi stan z samej aplikacji WhatsApp Business, przede wszystkim synchronizację kontaktów uruchamianą po połączeniu numeru Coexistence. Jest oddzielony od historii, która przenosi rozmowy, i występuje wyłącznie na numerach Coexistence.
Pola synchronizacji właściwe dla Coexistence: to pole i history.
Okno po onboardingu, w którym musi rozpocząć się synchronizacja.
Odpowiednik na numerze onboardowanym bez Coexistence.
Co zawiera
Stan po stronie aplikacji, czyli w praktyce kontakty, które firma miała już w telefonie.
Każdy kontakt z numerem WhatsApp może zostać zsynchronizowany z platformą. Dzięki temu oprogramowanie rozpoznaje klienta, który od lat znajdował się w telefonie firmy, zamiast traktować go jak nowy numer. To coś innego niż same rozmowy, które trafiają do pola history, a oba elementy są oddzielne, ponieważ jeden jest książką adresową, a drugi transkrypcją.
Podobnie jak history, ten element występuje wyłącznie w Coexistence. Na numerze, który nigdy nie był używany w aplikacji, nie ma stanu aplikacji do zsynchronizowania.
Czego nie zawiera
Własne narzędzia robocze aplikacji, które nie mają odpowiednika po stronie platformy.
- Etykiety, które są przechowywane na urządzeniu i nie mogą być odczytane przez oprogramowanie.
- Szybkie odpowiedzi oraz wiadomości powitalne i wiadomości o nieobecności.
- Katalog, zamówienia i status.
- Kanały oraz historia połączeń głosowych i wideo.
Dlaczego ma to znaczenie dla integracji
Ponieważ decyduje o tym, czy Twój system wie od pierwszego dnia, kto pisze.
Bez synchronizacji kontaktów każda przychodząca wiadomość pojawia się jako numer telefonu bez nazwy, a dopasowanie go do rekordu klienta staje się Twoim problemem. Dzięki synchronizacji dostępna jest własna lista kontaktów firmy, więc dopasowanie jest w większości wykonane.
Warto zaplanować oba scenariusze, ponieważ firma może odmówić synchronizacji albo przegapić okno. Integracja zakładająca, że kontakty istnieją, pokaże wtedy ścianę surowych numerów każdej osobie, która ją otworzy.
Typowe błędy
- Zakładanie, że kontakty będą dostępne. Firma może odmówić synchronizacji albo przegapić swoje okno.
- Oczekiwanie etykiet lub szybkich odpowiedzi w tym payloadzie. Pozostają na urządzeniu.
- Mylenie tego elementu z history, które przenosi rozmowy, a nie listę kontaktów.
EasyCoexistence subskrybuje pola operacyjne i zapisuje sekwencję onboardingu, dzięki czemu na osi czasu widać, co dany numer zsynchronizował, a czego nie.
Najczęściej zadawane pytania
Czy to jest to samo co synchronizacja history?
Nie. To pole przenosi stan aplikacji, przede wszystkim kontakty. history przenosi rozmowy.
Czy uruchamia się więcej niż raz?
Początkowa synchronizacja jest jednorazową częścią onboardingu i ma takie samo 24-godzinne okno jak history.
Czy otrzymam etykiety?
Nie. Etykiety są funkcją aplikacji i nie mają odpowiednika w API.
Czy występuje na zwykłym numerze Cloud API?
Nie. Na takim numerze nie ma stanu aplikacji WhatsApp Business do zsynchronizowania.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w