PUSH API

Skalowalna wysyłka transakcyjna i automatyzacja

Sekcja Mobile Push API umożliwia pełną integrację Twojego systemu z infrastrukturą MessageFlow. To rozwiązanie dedykowane do obsługi powiadomień transakcyjnych (np. statusy zamówień, kody 2FA) oraz realizacji automatycznych scenariuszy komunikacji bezpośrednio z poziomu kodu, z pominięciem interfejsu graficznego panelu.

Kluczowe możliwości kanału PUSH API

• Wysyłka Transakcyjna: Szybka realizacja pojedynczych komunikatów krytycznych czasowo (np. kody 2FA, alerty bezpieczeństwa, statusy zamówień) wysyłanych w reakcji na zdarzenie.

• Pełna Automatyzacja: Wyzwalanie powiadomień w czasie rzeczywistym w reakcji na zdarzenia w Twoim systemie (trigger-based messaging).

• Logi i Wyszukiwarka w Panelu: Mimo wysyłki realizowanej programistycznie, masz pełny wgląd w historię zdarzeń w interfejsie panelu. Wbudowana wyszukiwarka pozwala szybko namierzyć konkretną wysyłkę i zweryfikować jej status, co znacznie przyspiesza obsługę zgłoszeń (Customer Support) i weryfikację błędów.

• Webhooks & Raportowanie: Możliwość odbierania statusów doręczenia (DLR) bezpośrednio do Twojego systemu poprzez mechanizm callback/webhook.

• Adresowanie: Precyzyjne dotarcie do użytkownika przy użyciu unikalnego Device Token (ciąg znaków generowany przez aplikację, identyfikujący urządzenie).

Best Practice: Wysyłki Masowe API jest zoptymalizowane pod kątem szybkich powiadomień transakcyjnych (1:1). Do realizacji wysokowolumenowych kampanii marketingowych (bulk) zalecamy korzystanie z modułu Kampanie w panelu. Posiada on dedykowane mechanizmy zarządzania przepustowością, które gwarantują stabilność i szybkość dostarczania przy dużych bazach odbiorców.

Jak to działa?

Komunikacja odbywa się poprzez bezpieczne żądania HTTPS. Twój system przesyła payload (treść + odbiorcy) do MessageFlow, który waliduje zapytanie i przekazuje je do odpowiednich bramek (FCM dla Android / APNs dla iOS).

• Metoda: POST

• Endpoint: /v2.1/push

• Wymagane parametry: W żądaniu (body) należy przekazać tablicę tokenów urządzeń (device_tokens) oraz treść wiadomości.

Dokumentacja Deweloperska

Szczegółowy opis metod, struktury JSON, kodów błędów oraz przykłady implementacji (cURL, PHP, Python, Java) znajdziesz w naszej dokumentacji.

Specyfikacja Techniczna

Pamiętaj, że limity znaków (tytuł/treść) oraz formaty grafik obowiązują również przy wysyłce przez API. Pełną specyfikację znajdziesz w zakładce Overview.