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.

Skonfiguruj na panelu Zobacz Events API

Webhook POST https://seusistema.com/webhooks/wpp

{
  "id": "evt_0123456789abcdef",
  "event": "MESSAGE_DELIVERED",
  "timestamp": "2026-09-15T10:30:00Z",
  "message": {
    "id": "msg_123",
    "status": "delivered",
    "phone": "5511999999999"
  }
}

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.

Webhook informuje o wyniku wiadomości; to nie jest żądanie wysyłki. Użyj Messaging API do wysyłania wiadomości i Events API do wywoływania automatyzacji za pomocą obsługiwanych zdarzeń handlowych.

01 Podajesz adres URL

Zarejestruj w panelu HTTPS endpoint swojego systemu, aby odbierać zwroty.

02 Wybierz zdarzenia

Włącz tylko te statusy, które Twój system musi obsługiwać, aby uniknąć szumów operacyjnych.

03 Status się zmienia

Tworzenie, dostarczenie, odczyt lub błąd są normalizowane w ten sam sposób, niezależnie od wybranego połączenia.

04 Odbieraj i śledź

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.

HTTPS

Zarejestruj publiczny adres URL HTTPS i włącz zdarzenia w panelu. Obecny kontrakt nie wysyła podpisu HMAC; skonfiguruj odpowiednie zabezpieczenia i walidację dla odbiorcy, nie zakładając istnienia nieistniejącego podpisu.

Szybka odpowiedź

Odpowiedz HTTP 2xx w ciągu 15 sekund i przetwarzaj długotrwałe zadania w wewnętrznej kolejce. Przekierowania nie są śledzone.

Idempotentność

Użyj identyfikatora zdarzenia, wysyłanego także w Webhook-Id, aby uniknąć podwójnego przetwarzania i akceptować zdarzenia poza kolejnością. Webhook-Attempt wskazuje numer próby. Tylko włączone zdarzenia są rejestrowane i wysyłane.

Dzienniki

Wyświetl próby i odpowiedzi HTTP w GET /webhooks z uprawnieniem webhooks:read. Zakończone, dostarczone lub trwale nieudane rekordy przechowywane są przez 30 dni. Chroń dane osobowe i treść wiadomości w swoich własnych logach.

Nowe próby

Błędy połączenia, timeouty oraz odpowiedzi 408, 425, 429 lub 5xx mogą spowodować łącznie do siedmiu prób, w odstępach 1, 5 i 15 minut oraz 1, 6 i 24 godzin. Retry-After jest respektowany do 24 godzin. Inne błędy 4xx kończą dostarczanie.

Oddzielenie

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.

Skonfiguruj webhooki