SMS API dla firm z webhookami i raportem dostarczenia

Wysyłasz wiadomość jednym zapytaniem, a o statusie dowiadujesz się z webhooka. Bez umów o minimalnej liczbie wiadomości.

Zobacz wiadomość Zobacz cennik

POST https://api.powiadomienie.pl/wiadomosci
Authorization: Bearer TWOJ_KLUCZ

{
  "telefon": "+48XXXXXXXXX",
  "szablon": "przypomnienie_wizyta",
  "dane": { "data": "jutro", "godzina": "9:30" }
}

202 Accepted
{ "id": "msg_81f2", "status": "przyjeta" }

Jak wygląda wysyłka

Zapytanie zawiera numer odbiorcy, szablon i dane do podstawienia. Odpowiedź zwraca identyfikator wiadomości, a status dostarczenia dostajesz osobno, gdy tylko się zmieni.

Klucz API generujesz w panelu i możesz go w każdej chwili wymienić.

Przykład zapytania

Wysyłka to jedno zapytanie POST z kluczem API w nagłówku. W treści przekazujesz numer odbiorcy, identyfikator szablonu i zmienne, na przykład imię, datę i godzinę wizyty. Odpowiedź zwraca identyfikator wiadomości, liczbę segmentów i koszt w pakiecie, więc od razu wiesz, ile wiadomość zużyła.

Tryb testowy przyjmuje to samo zapytanie, zapisuje wiadomość i pokazuje podgląd bez wysyłki do odbiorcy. Możesz podłączyć sklep lub system rezerwacji w jedno popołudnie i sprawdzić cały przepływ, zanim pierwszy klient dostanie wiadomość.

Webhooki i statusy

Każda zmiana statusu, od przyjęcia po dostarczenie lub błąd, trafia na adres Twojego systemu. Dzięki temu nie musisz odpytywać API w pętli.

status przyjęta, wysłana, dostarczona, niedostarczona
identyfikator Twojego zdarzenia w każdym powiadomieniu
ponowna wysyłka webhooka po błędzie

Dla kogo jest API

API wybierają firmy z własnym sklepem, systemem rezerwacji lub aplikacją, które mają wysyłać wiadomości bez ręcznej pracy. Jest dostępne w planie Biznes i Skala, razem z automatami zdarzeń.

Ile kosztuje SMS API

API nie jest dodatkiem do rachunku. Wchodzi w skład planu Biznes (225 PLN netto miesięcznie przy rozliczeniu rocznym, 449 PLN przy miesięcznym) z pakietem 1 500 SMS oraz planu Skala z pakietem 6 000 SMS. Wiadomości ponad pakiet naliczamy z góry po stawce planu, a polskie litery skracają segment do 70 znaków, o czym informuje licznik w edytorze.

Najczęstsze zastosowania to kody odbioru paczek, potwierdzenia rezerwacji, przypomnienia o płatności i alerty o zmianie statusu zlecenia. Jeśli zastanawiasz się, czy wystarczy sam panel, przeczytaj porównanie SMS API i bramki SMS. Pełne stawki są w cenniku.

Pytania i odpowiedzi

Nie. Jest częścią planów Biznes i Skala. Płacisz abonament, a wiadomości ponad pakiet naliczamy po stawce planu.

Tak, tryb testowy zapisuje wiadomość i pokazuje podgląd bez wysyłki do odbiorcy.

Klucz jest widoczny raz, można go odwołać i wygenerować nowy w panelu.

Tak. Sklep wysyła zapytanie przy zmianie statusu zamówienia, a Powiadomienie zwraca status dostarczenia webhookiem. Gotowe szablony dla zamówień opisuje strona o powiadomieniach dla sklepów internetowych.

Tak, jeśli korzystasz z automatów zdarzeń w panelu. API przydaje się wtedy, gdy wiadomość ma wychodzić z Twojej aplikacji lub sklepu, a ktoś po stronie firmy potrafi wysłać zapytanie REST.

Zobacz także: Bramka SMS dla firmy, która sama wysyła wiadomości do klientów Powiadomienia o zamówieniu dla sklepów internetowych Platforma powiadomień SMS, e-mail i push dla firm Cennik

Zobacz, jak wiadomość wygląda u Twojego klienta

Wpisz zdarzenie i treść, a podgląd SMS, e-maila i push pokaże licznik znaków i koszt. Bez karty i bez rejestracji.

Zobacz wiadomość Wybierz plan