Webhook historii

Co dostarcza

Przenosi historię wiadomości jeden do jednego, którą numer miał już w aplikacji WhatsApp Business, aby oprogramowanie nie zaczynało pracy bez kontekstu na linii używanej przez firmę od lat.

Nie obejmuje rozmów grupowych. Na numerze Coexistence są one całkowicie wykluczone z API. Nie obejmuje też narzędzi aplikacji: etykiety, szybkie odpowiedzi oraz wiadomości powitalne i o nieobecności nie mają odpowiednika w API i pozostają na urządzeniu.

To pole istnieje tylko dla numerów Coexistence. Numer wdrożony zwykłą metodą nie ma wcześniejszej historii w aplikacji do przeniesienia, więc nie ma czego dostarczać.

Dlaczego uruchamia się tylko raz

Ponieważ transfer jest częścią onboardingu, a nie stałą funkcją.

Podczas Embedded Signup właściciel firmy decyduje, czy udostępnić istniejące rozmowy. Odpowiedź „tak” pozwala uruchomić synchronizację. Później nie ma ustawienia, które włącza ją ponownie, ani endpointu, który ją powtarza. Druga próba zwraca 2593107, a nie limit szybkości, który po czasie znika.

Obowiązuje też termin. Synchronizację trzeba rozpocząć w ciągu 24 godzin od onboardingu, a późniejsza próba zwraca 2593108. Niespełnienie któregokolwiek warunku oznacza odłączenie numeru i ponowne przejście całego procesu.

Co powinien z nim zrobić handler

Traktuj je jak pakiet, który dociera raz i może być duży, a nie jak kolejny ruch na ścieżce wiadomości.

• Potwierdź szybko i przetwarzaj asynchronicznie, tak jak każdą inną dostawę.
• Usuwaj duplikaty na podstawie identyfikatora wiadomości: historia i wiadomości bieżące mogą się nakładać w momencie onboardingu.
• Załóż, że może go nie być. Numer, którego właściciel odmówił udostępnienia historii, nic tu nie wyśle, a integracja musi działać w obu przypadkach.
• Nie uzależniaj od niego onboardingu. Połączenie działa, zanim transfer się zakończy.

Typowe błędy

• Budowanie integracji wymagającej obecności historii. Wiele numerów łączy się bez niej.
• Ponawianie synchronizacji po 2593107. To zdarzenie jednorazowe, więc ponowna próba zwróci ten sam błąd.
• Odkładanie decyzji o historii do rozpoczęcia prac nad integracją, zwykle po zamknięciu 24-godzinnego okna.

Najczęściej zadawane pytania

Czytaj dalej