Zarejestruj w panelu HTTPS endpoint swojego systemu, aby odbierać zwroty.
Webhooki statusu
Otrzymuj w swoim systemie statusy wiadomości WhatsApp.
Skonfiguruj adres URL do odbierania ustandaryzowanych zdarzeń tworzenia, dostarczenia, odczytu i błędów oraz sprawdzaj historię dostaw przez API niezależnie od wybranego połączenia.
Przepływ
WPP Marketing powiadamia twój system, gdy zmieni się status.
Webhooki statusu są przydatne do audytu, uzgodnień, wewnętrznych pulpitów, wsparcia i reguł w twoim systemie.
Włącz tylko te statusy, które Twój system musi obsługiwać, aby uniknąć szumów operacyjnych.
Tworzenie, dostarczenie, odczyt lub błąd są normalizowane w ten sam sposób, niezależnie od wybranego połączenia.
Twój endpoint przetwarza payload, a historia dostaw staje się dostępna w panelu i przez GET /webhooks.
Dostępne zdarzenia i zapytanie o dostawy.
Wszystkie cztery zdarzenia używają tego samego kontraktu na dowolnym połączeniu, a API umożliwia zapytanie o wynik każdej próby dostarczenia.
POST
MESSAGE_CREATED
Wiadomość została utworzona w przepływie i otrzymała identyfikator do śledzenia.
Criação
POST
MESSAGE_DELIVERED
Wiadomość została dostarczona do odbiorcy, gdy kanał zwrócił potwierdzenie.
Entrega
POST
MESSAGE_READ
Wiadomość została odczytana, gdy potwierdzenie odczytu jest dostępne.
Leitura
POST
MESSAGE_ERROR
Wiadomość napotkała błąd podczas wysyłania, walidacji lub przetwarzania.
Erro
GET
/webhooks
Wyświetl historię dostaw ze statusem, próbami, odpowiedzią HTTP i stronicowaniem. Wymaga zakresu webhooks:read.
Logs
Dobre praktyki
Przygotuj swój endpoint do odbierania powtarzających się i przychodzących w niewłaściwej kolejności zdarzeń.
Webhooks to dostawy między systemami. Twój backend powinien szybko odpowiadać, zapisywać logi i przetwarzać idempotentnie.
Użyj bezpiecznego, publicznego i stabilnego adresu URL, aby odbierać zdarzenia zwrotne.
Odpowiedz kodem HTTP 200 lub 204 po otrzymaniu zdarzenia i przetwarzaj długotrwałe zadania w wewnętrznej kolejce.
Używaj identyfikatorów wiadomości i zdarzeń, aby zapobiec duplikacji przy ponownych dostawach.
Zarejestruj payload, datę, status HTTP i wynik przetwarzania do audytu.
Użyj MESSAGE_ERROR, aby powiadomić dział wsparcia lub operacje o błędach zwróconych przez dowolne połączenie.
Webhooki statusu to odpowiedzi od WPP Marketing. Aby wysyłać zdarzenia handlowe sklepu, użyj Events API.
Chcesz śledzić dostawy i błędy w swoim systemie?
Skonfiguruj URL w panelu, wybierz statusy i śledź dostawy w raporcie webhooków.