# SMS API

#### Automatyzacja i krytyczne powiadomienia

Sekcja SMS API umożliwia pełną integrację Twojego oprogramowania z infrastrukturą MessageFlow. To rozwiązanie dedykowane do obsługi ruchu transakcyjnego (kody OTP, statusy zamówień) oraz realizacji automatycznych scenariuszy komunikacji bezpośrednio z poziomu kodu.

## Kluczowe możliwości API

* **Pełna widoczność w Panelu**: Wszystkie operacje API nie są "czarną skrzynką". Wiadomości wychodzące oraz przychodzące realizowane przez integrację są widoczne w interfejsie panelu, identycznie jak kampanie.
  * Korzyść: Twój dział Obsługi Klienta może samodzielnie sprawdzić, czy SMS z kodem dotarł do użytkownika, bez konieczności angażowania programistów i przeszukiwania logów serwera.
* **Direct Connections (Jakość Enterprise)**: Korzystamy z bezpośrednich, certyfikowanych połączeń z operatorami komórkowymi. Gwarantuje to najwyższą dostarczalność i eliminuje ryzyko tzw. *grey routingu* (gubienia wiadomości przez tanich pośredników).
* **MessageFlow Priority (Add-on)**: Dla wiadomości krytycznych czasowo (np. kody 2FA, alerty bankowe, reset haseł) oferujemy dodatkową, wydzieloną infrastrukturę.
  * Twoje powiadomienia są przetwarzane poza standardową kolejką wysyłek masowych (marketingowych).
  * *Uwaga: Usługa dostępna jako dodatkowo płatny moduł. Więcej informacji:* [messageflow-priority](https://docs.messageflow.com/pl/zaawansowane-funkcjonalnosci/messageflow-priority "mention")
* **Webhooks & Raportowanie (DLR)**: Twój system otrzymuje informacje zwrotne w czasie rzeczywistym. Skonfiguruj `webhookUrl`, aby automatycznie odbierać statusy doręczenia (Delivered, Undelivered, Expired) bezpośrednio do swojej bazy danych.
* **Wysyłka Dwukierunkowa (2-Way)**: API obsługuje odbieranie wiadomości przychodzących na dedykowane numery (Short Code/Long Number), co pozwala na budowanie interaktywnych botów SMS.

### Developer Experience (DX)

Naszym celem jest maksymalne skrócenie czasu integracji ("Time-to-Hello-World").

* Standard: RESTful API oparte o przejrzysty format JSON.
* Gotowe biblioteki (Snippets): Nie musisz pisać kodu od zera. W dokumentacji znajdziesz gotowe fragmenty "Copy-paste" dla najpopularniejszych języków: **Shell (cURL), Python, PHP, Java, C#, Node.js, Go, Ruby, Swift** i innych.

#### Jak to działa?

Komunikacja odbywa się poprzez bezpieczne żądania HTTPS.

* **Metoda**: `POST`
* **Endpoint**: `https://api.messageflow.com/v2.1/sms`
* **Uwierzytelnianie**: Wymagane nagłówki `Application-Key` oraz `Authorization` (tokeny wygenerujesz w zakładce Konto -> API).

Przykładowy Payload (JSON): W żądaniu przesyłasz treść, odbiorców oraz opcjonalne parametry (np. datę wysyłki).

```json
{
  "sender": "TwojaFirma",
  "message": "Twój kod autoryzacyjny to: 1234",
  "phoneNumbers": [
    "48111222333"
  ],
  "priority": true
}
```

\[*Powyższy kod jest uproszczonym przykładem. Pełną strukturę znajdziesz w* [*dokumentacji API*](https://dev.messageflow.com/#/operations/SendSmsV2_1)]

{% hint style="info" %}
**Best Practice: Kody OTP** 

Wysyłasz hasła jednorazowe? Zalecamy skorzystanie z dodatku [messageflow-priority](https://docs.messageflow.com/pl/zaawansowane-funkcjonalnosci/messageflow-priority "mention"). Zapewnia to natychmiastowe przetworzenie żądania przez naszą platformę, bez oczekiwania w kolejce komunikatów marketingowych.
{% endhint %}

### Dokumentacja Deweloperska

Szczegółowy opis wszystkich metod, kodów błędów oraz pełną listę parametrów znajdziesz w naszym portalu dla programistów: 

[Przejdź do MessageFlow API Docs >>](https://dev.messageflow.com/#/operations/SendSmsV2)