Webhooki WhatsApp: kierowanie wiadomości na własny serwer

Co właściwie Meta wysyła do webhooka?

Zdarzenia są pogrupowane, a rozróżnienie między nimi decyduje o architekturze.

Ścieżka wiadomości przenosi to, co wysyłają klienci, oraz w przypadku numeru Coexistence kopie tego, co Twój zespół wysyła z aplikacji WhatsApp Business. Są to pola messages i smb_message_echoes, które zawierają treść rozmów.

Ścieżka operacyjna przenosi wszystko pozostałe: account_update przy zmianie stanu połączenia, phone_number_quality_update przy zmianie jakości lub przepustowości, account_alerts, account_review_update, business_capability_update i phone_number_name_update. Nie zawierają one treści rozmów i na ich podstawie działa monitorowanie.

Dostawca, który umieszcza siebie na ścieżce wiadomości, otrzymuje pierwszą grupę. Ten, który tego nie robi, nie otrzymuje jej.

Jak Meta weryfikuje endpoint?

Wysyła żądanie GET, zanim zacznie dostarczać cokolwiek. Niepowodzenie tej weryfikacji jest najczęstszym powodem, dla którego pozornie ukończona konfiguracja nie otrzymuje wiadomości.

Meta wywołuje Twój URL z hub.mode ustawionym na subscribe, Twoim hub.verify_token oraz wartością hub.challenge. Twój endpoint musi zwrócić ten challenge jako surowe ciało odpowiedzi, bez opakowania w JSON i bez żadnych dodatków. Jeśli tego nie zrobi, Meta nigdy nie rozpocznie dostarczania, a żaden panel tego nie zasygnalizuje.

Endpoint musi również działać przez HTTPS. Endpoint zwracający cichy błąd 404 albo znajdujący się za warstwą uwierzytelniania odrzucającą Meta wygląda jak działająca konfiguracja aż do chwili, gdy pierwsza wiadomość nie nadejdzie.

Czy miejscem docelowym może być Twój własny serwer?

Tak, i właśnie to różni poszczególnych dostawców.

Meta pozwala aplikacji nadpisać miejsce, do którego dane konto WhatsApp Business dostarcza webhooki. Ustawiamy to nadpisanie na Twój URL, przenosząc zdarzenia ścieżki wiadomości z naszego wywołania zwrotnego do Ciebie. Zachowujemy zdarzenia operacyjne, ponieważ to z nich składają się panel i alerty.

Konsekwencja dotyczy architektury, a nie publikowanej przez nas zasady. Treść rozmów nie ma gdzie zostać zapisana po naszej stronie, ponieważ nigdy do nas nie trafia. Konto bez ustawionego nadpisania wraca do naszego domyślnego wywołania zwrotnego, gdzie obsługa odrzuca te zdarzenia bez ich zapisywania.

Co dzieje się z miejscem docelowym po ponownym połączeniu numeru?

Zostaje usunięte, choć prawie nikt nie planuje takiej awarii.

Miejsce docelowe nie jest właściwością numeru telefonu. To nadpisanie subskrypcji naszej aplikacji na konto WhatsApp Business. Gdy połączenie zostanie usunięte, z powodu reguły Meta dotyczącej czternastu dni nieaktywności albo z innego powodu, aplikacja jest odinstalowywana z tego konta, a nadpisanie znika razem z nią.

Ponowne połączenie przywraca wysyłanie i monitorowanie. Nie przywraca dostarczania na Twój serwer, a żaden komunikat nie zgłasza błędu, więc pierwszym sygnałem może być klient mówiący, że nikt mu nie odpowiedział. Ponownie ustawiamy nadpisanie przy każdym połączeniu, ponieważ zdarzyło się to rzeczywistemu numerowi, który połączył się poprawnie, a następnie zamilkł.

Typowe błędy

• Zwracanie JSON z weryfikacyjnego żądania GET. Meta oczekuje surowej wartości hub.challenge i niczego więcej.
• Używanie tymczasowego lub testowego URL-a. Meta nadal wysyła na ten adres, gdy narzędzie, które go wygenerowało, przestaje nasłuchiwać.
• Zakładanie, że miejsce docelowe przetrwa ponowne połączenie. Jest zapisane w subskrypcji aplikacji i zostaje odinstalowane razem z nią.
• Umieszczanie endpointu za uwierzytelnianiem, które odrzuca żądanie Meta.

Najczęściej zadawane pytania

Czytaj dalej