SMS może potwierdzić rezerwację, przypomnieć o terminie lub powiadomić obsługę o ważnym zdarzeniu. Integracja z SMSAPI pozwala uruchamiać takie wiadomości z aplikacji, bez ręcznego kopiowania numerów do panelu. Warto od razu zaplanować historię wysyłki, koszty i reakcję na błędy.
W tym poradniku
Wysyłaj SMS w odpowiedzi na konkretną sytuację
Najpierw wybierz zdarzenia: potwierdzenie wizyty, zmiana terminu, gotowe zamówienie albo alert wymagający reakcji pracownika. Dla każdego określ odbiorcę, treść i warunek wysłania. Przypomnienie powinno korzystać z aktualnego stanu rezerwacji, a nie wyłącznie z daty zapisanej podczas jej utworzenia.
Przykładowy proces: klient rezerwuje usługę, system zapisuje potwierdzony termin, a zadanie wysyłki przygotowuje SMS. Po anulowaniu rezerwacji przyszłe przypomnienie jest pomijane. To zasada projektowa aplikacji, którą trzeba zaimplementować niezależnie od wyboru operatora SMS.
Połącz aplikację z API po stronie serwera
Dokumentacja SMSAPI opisuje autoryzację tokenem oraz wysyłkę przez HTTPS. Token powinien być przechowywany na serwerze, poza repozytorium i kodem przeglądarki. W aplikacji PHP lub Python konfigurację połączenia oddziel od treści wiadomości i reguł biznesowych.
Panel powinien określać, kto może zmieniać szablony, wysyłać wiadomości ręcznie i przeglądać historię. Kontroluj te uprawnienia również na serwerze. Samo ukrycie przycisku nie blokuje nieuprawnionego żądania. W logach nie zapisuj tokenu ani niepotrzebnych danych odbiorcy.
Zapisz identyfikator i śledź status
Odpowiedź API może zawierać identyfikator wiadomości, a raporty callback przekazują aktualizacje statusu. Przyjęcie SMS do wysyłki nie oznacza jego doręczenia. Raport powiąż z zapisaną wiadomością, a powtórzony callback obsłuż bez tworzenia kolejnego wpisu wysyłki.
Gdy połączenie kończy się timeoutem, nie zakładaj od razu, że wiadomość nie została przyjęta. Bezwarunkowe ponowienie może wysłać drugi SMS. Własna kolejka powinna rozróżniać błąd, potwierdzony sukces i wynik wymagający sprawdzenia. Ustal też, kto reaguje na nierozstrzygnięte przypadki.
Sprawdzaj treść po podstawieniu danych
Długość i kodowanie wpływają na liczbę części SMS, a tym samym koszt wysyłki. Polskie znaki mogą zmienić dostępny limit znaków. Oceniaj gotową wiadomość po uzupełnieniu nazwy usługi, daty i linku; krótki szablon może stać się znacznie dłuższy po podstawieniu danych.
Testuj integrację przed włączeniem harmonogramu
SMSAPI opisuje tryb test=1, który zwraca odpowiedź bez wysłania wiadomości. Pomaga sprawdzić część integracji, ale nie potwierdza rzeczywistego doręczenia. Osobny, kontrolowany test na uzgodnionym numerze jest potrzebny do oceny całej ścieżki.
- sprawdź brak tokenu, nieprawidłowy numer i odmowę API,
- przetestuj zmianę oraz anulowanie sprawy przed wysyłką,
- sprawdź powtórne uruchomienie tego samego zadania,
- zapisuj czas i rezultat każdej próby bez ujawniania sekretów,
- ustal limity wysyłki oraz zasady ręcznej interwencji.
Jeśli potrzebujesz kilku kanałów, zacznij od projektu całego systemu powiadomień. SMSAPI może być jego modułem, połączonym z rezerwacjami, sklepem albo indywidualną aplikacją firmową.
Potrzebujesz pomocy?