easyCoexistence
Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

Pola webhooków WhatsApp i ich routing

Konto WhatsApp Business dostarcza zdarzenia jako nazwane pola. Dwa zawierają treść rozmów i trafiają do Twojego endpointu. Sześć przekazuje stan operacyjny i stanowi podstawę monitorowania. Wiedza o tym, które jest które, wpływa na architekturę.

  • Dwa pola wiadomości, sześć operacyjnych
  • Routing ustawia się dla każdego konta
  • Nazwane pola, nie ogólny payload
Rozpocznij bezpłatny okres próbny

Przez 7 dni nic nie zapłacisz. Anuluj w dowolnym momencie.

Bez przechowywania wiadomościAplikacja firmowa + Cloud APIMCP dla Claude i ChatGPTGotowe w 2 minuty
2

Pola ścieżki wiadomości: messages i smb_message_echoes.

6

Pola operacyjne pozostają do monitorowania.

1

Nadpisanie dla każdego konta WhatsApp Business decyduje o ich podziale.

Co zawiera każde pole?

messages zawiera wszystko, co klient wysyła na numer: tekst, odwołania do multimediów, odpowiedzi i reakcje. smb_message_echoes zawiera wiadomości wysyłane przez Twój zespół z aplikacji WhatsApp Business. To pole istnieje tylko dla numeru Coexistence i pozwala oprogramowaniu odczytać odpowiedzi człowieka.

account_update przekazuje stan połączenia: PARTNER_REMOVED, gdy aplikacja zostanie odinstalowana z konta, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED oraz zdarzenia dotyczące ograniczeń lub naruszeń. phone_number_quality_update przekazuje zmiany oceny jakości i przepustowości. account_alerts zawiera alerty zgłaszane przez Meta dla konta, a account_review_update przekazuje wynik weryfikacji.

business_capability_update przekazuje zmiany limitu wiadomości i możliwości, a phone_number_name_update zawiera akceptacje i odrzucenia nazwy wyświetlanej.

Dlaczego ten podział ma znaczenie dla architektury?

Decyduje o tym, czy treść rozmów kiedykolwiek trafia do dostawcy.

Nadpisanie wysyła dwa pola wiadomości bezpośrednio z Meta do Twojego endpointu. Sześć pól operacyjnych nadal trafia do dostawcy, co umożliwia działanie panelu i alertów bez przechowywania przez kogokolwiek wiadomości.

Dlatego twierdzenie o nieprzechowywaniu wiadomości może wynikać ze struktury, a nie z samej polityki. Jeśli pola wiadomości są dostarczane gdzie indziej, nie istnieje ścieżka kodu, na której można je zapisać. W naszym przypadku konto bez nadpisania korzysta z domyślnego callbacka, którego procedura obsługi odrzuca te zdarzenia bez ich zapisywania.

Jakich pól powinna oczekiwać Twoja procedura obsługi?

Tylko dwóch pól wiadomości, jeśli ustawiono nadpisanie. Warto jednak napisać procedurę tak, aby ignorowała wszystko inne, zamiast przerywać działanie.

Meta z czasem dodaje pola, a struktura payloadu może bez zapowiedzi zyskać nowe klucze. Procedura, która rozpoznaje nazwę pola i ignoruje nieznane elementy, nadal działa. Ta, która zakłada konkretną strukturę, zgłasza błąd przy pierwszym nieznanym zdarzeniu.

Warto też jawnie obsługiwać smb_message_echoes, zamiast traktować je jako szum. Bez tego oprogramowanie nie wie, że człowiek już odpowiedział, przez co klient może otrzymać dwie odpowiedzi na to samo pytanie.

Typowe błędy

  • Zakładanie ogólnego payloadu. Każde zdarzenie wskazuje swoje pole, a procedura powinna na tej podstawie wybrać obsługę.
  • Ignorowanie smb_message_echoes. Bez tego oprogramowanie odpowiada na wiadomość człowieka, który już udzielił odpowiedzi.
  • Przerywanie działania przy nieznanych polach zamiast ich pomijania. Meta dodaje pola bez pytania.
Z EasyCoexistence zrobisz to

EasyCoexistence subskrybuje pola operacyjne do monitorowania i kieruje dwa pola wiadomości do Twojego endpointu albo odrzuca je bez zapisywania, jeśli go nie ustawisz.

Najczęściej zadawane pytania

Czy mogę odbierać tylko niektóre pola?

Nadpisanie kieruje ścieżkę wiadomości do Ciebie. Podział pól operacyjnych jest stały, ponieważ na nim opiera się monitorowanie.

Czy smb_message_echoes istnieje na zwykłym numerze Cloud API?

Nie. Istnieje dlatego, że z numeru Coexistence wiadomości wysyła człowiek z aplikacji, a także oprogramowanie przez API.

Co dzieje się ze zdarzeniami wiadomości, jeśli nie ustawię miejsca docelowego?

Trafiają do naszego domyślnego callbacka i są odrzucane bez zapisywania.

Czy nazwy pól pochodzą od Meta, czy od Was?

Od Meta. Nie wymyśliliśmy żadnej z tych nazw, dlatego warto nauczyć się ich raz.

Czytaj dalej

The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.The phone_number_quality_update webhookWhat this webhook actually carries as of 2026, why the colour quality rating is not in it, and where the rating has to be read from instead.The WhatsApp Business Account, and why overrides live on itWhat a WABA holds, why webhook overrides are applied at this level rather than per number, and what that means when a connection is removed.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

Gotowy, aby zacząć?

Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.

Rozpocznij bezpłatny okres próbnyPrzez 7 dni nic nie zapłacisz. Anuluj w dowolnym momencie.

Zweryfikowano w

Pola webhooków WhatsApp