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

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

{
  "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]

Best Practice: Kody OTP Wysyłasz hasła jednorazowe? Zalecamy skorzystanie z dodatku MessageFlow Priority. Zapewnia to natychmiastowe przetworzenie żądania przez naszą platformę, bez oczekiwania w kolejce komunikatów marketingowych.

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