Zamówienie, koszyk, płatność, wysyłka, anulowanie lub rejestracja odbywają się w systemie źródłowym.
Events API
Wyślij zdarzenia ze sklepu lub ERP, aby uruchamiać automatyzacje na WhatsApp.
Użyj Events API, gdy twój system musi zgłosić do WPP Marketing informacje o koszyku, zamówieniu, płatności, wysyłce, anulowaniu lub utworzeniu klienta.
Events API odbiera zdarzenie handlowe i wykorzystuje skonfigurowane automatyzacje. Aby wysłać wiadomość bezpośrednio, użyj Messaging API. Aby śledzić dostarczenie, odczyty i błędy, użyj webhooki statusu.
Przepływ
Twój system zgłasza zdarzenie. WPP Marketing decyduje o automatyzacji.
Events API jest idealne dla sklepów niestandardowych, systemów ERP, back office'ów i integracji, które nie mają wtyczki typu plug-and-play.
Twój backend wysyła zdarzenie z tokenem, identyfikatorem, klientem, wartościami i dostępnymi linkami.
WPP Marketing sprawdza, czy dla tego zdarzenia i klienta istnieje aktywna automatyzacja.
Klient otrzymuje wiadomości WhatsApp dotyczące odzyskiwania, płatności, zamówienia, wysyłki, kampanii lub posprzedażowe.
Obsługiwane zdarzenia handlowe.
Końcowa nazewnictwo i pola obowiązkowe muszą być zgodne z dokumentacją Events API.
POST
cart.created
Rejestruje zamiar zakupu i umożliwia automatyzacje wstępnych działań follow-up.
Carrinho
POST
cart.abandoned
Uruchamia odzyskiwanie koszyka z przypomnieniem i linkiem powrotu, gdy dostępne.
Recuperação
POST
order.created
Informuje o utworzonym zamówieniu lub oczekującym na płatność dla wiadomości transakcyjnych.
Pedido
POST
order.paid
Potwierdza płatność i umożliwia wysłanie wiadomości potwierdzającej, instrukcji oraz kolejnych kroków.
Pagamento
POST
order.shipped
Wysyła aktualizacje wysyłki, śledzenia lub statusu logistycznego, aby zmniejszyć liczbę zgłoszeń ręcznych.
Envio
POST
order.cancelled
Rejestruje anulowanie zamówienia, aby wywołać komunikację skonfigurowaną dla tego zdarzenia.
Cancelamento
POST
customer.created
Zasilana baza kontaktów do powitań, zarządzania relacjami, etykiet i kampanii.
Cliente
Zalecane dane
Im lepsze wydarzenie, tym lepsza automatyzacja.
Events API musi otrzymywać wystarczające dane, aby zidentyfikować klienta, zakup, kwotę, status oraz przydatne linki do wiadomości.
Numer telefonu, imię, e‑mail, kraj i zewnętrzny identyfikator pomagają w deduplikacji i segmentacji.
Numer, zewnętrzne ID, suma, waluta, status, metoda płatności i pozycje sprawiają, że wiadomość jest bardziej użyteczna.
Strona checkout, płatności, śledzenia lub strona zamówienia mogą być używane w wiadomościach automatycznych.
Podaj external_id lub order.id i utrzymuj stabilne źródło. Deduplikacja uwzględnia konto, znormalizowane źródło, typ zdarzenia i zewnętrzny identyfikator. Powtarzające się zdarzenia zwracają HTTP 200 z informacją Duplicate event ignored. Ten endpoint nie używa nagłówka Idempotency-Key z Messaging API.
HTTP 200 potwierdza przetworzenie zdarzenia, nie dostarczenie wiadomości. Wysłanie wymaga aktywnej automatyzacji dla zdarzenia, poprawnych danych klienta i skonfigurowanego połączenia. Śledź wiadomość przez raporty i statusowe webhooks.
Utwórz credential z uprawnieniem events:write i wysyłaj zdarzenia z serwera. Trzymaj token poza frontendem i publicznymi repozytoriami. Użyj customer.phone dla numeru telefonu oraz obiektów customer i order zgodnie z przykładem i kontraktem OpenAPI.
Chcesz podłączyć niestandardowy sklep lub ERP?
Otwórz dokumentację Events API, aby zweryfikować payloady, uwierzytelnianie i przykłady przed wysłaniem zdarzeń do produkcji.