# 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).

{% hint style="success" %}
**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.
{% endhint %}

### 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.

{% hint style="info" %}
**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](https://dev.messageflow.com/#/operations/PushCreate).
{% endhint %}

{% hint style="success" %}
**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](https://docs.messageflow.com/pl/mobile-push/overview#specyfikacja-techniczna).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.messageflow.com/pl/mobile-push/push-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.