Instrukcja obsługi systemu „Zamówienia SMS”

Codzienna obsługa zamówień, ustawienia administratora i konfiguracja telefonu z trackerem.

O systemie: co robi i dla kogo jest przeznaczony

Co robi system „Zamówienia SMS”

„Zamówienia SMS” porządkują zamówienia, które klienci przesyłają zwykłymi wiadomościami SMS. Klient nie musi instalować aplikacji, zakładać konta ani korzystać z internetu. Pisze na numer telefonu, którego używasz do przyjmowania zamówień.

W skrócie system działa tak:

  1. Klient wysyła zwykły SMS z zamówieniem, np. nazwą towaru, ilością, terminem odbioru lub dostawy i dodatkowymi uwagami.
  2. Tracker w Twoim telefonie przekazuje wiadomość do systemu.
  3. AI odczytuje treść SMS-a i tworzy uporządkowane zamówienie w panelu.
  4. Pracownik sprawdza zamówienie i je zatwierdza. Klient dostaje SMS z potwierdzeniem.
  5. Po przygotowaniu towaru pracownik wybiera „Gotowe do odbioru”, a klient dostaje kolejny SMS.
  6. Po wydaniu lub dostarczeniu towaru zamówienie można oznaczyć jako odebrane i zachować w historii.

System ogranicza przepisywanie zamówień z telefonu do notesu, arkusza lub innego programu. Pomaga zmniejszyć liczbę pomyłek w ilościach i terminach, ułatwia pracę kilku osobom i daje jeden wspólny widok zamówień oczekujących, gotowych i zrealizowanych.

Dla kogo system może być przydatny

Najlepiej sprawdza się tam, gdzie klienci już dziś zamawiają telefonicznie lub SMS-em, a zamówienie można opisać za pomocą towaru, ilości, jednostki, terminu odbioru lub dostawy oraz krótkich uwag. Nie musi to być branża spożywcza.

Przykładowa branżaPrzykładowe zastosowanie
Gospodarstwa rolne i sadowniczeOwoce, warzywa, ziemniaki, jaja, miód, przetwory, zioła, grzyby i inne produkty sprzedawane bezpośrednio.
Sprzedawcy opałuWęgiel, pellet, drewno opałowe, brykiet i inne paliwa zamawiane na worki, palety, tony lub metry przestrzenne.
Ryby i owoce morzaŚwieże ryby, filety, skorupiaki i owoce morza zamawiane na wagę, sztuki lub skrzynki, z ustalonym terminem odbioru.
Piekarnie, cukiernie i garmażerkaPieczywo, ciasta, wypieki sezonowe, dania gotowe i zamówienia cykliczne dla stałych odbiorców.
Masarnie, sklepy mięsne i nabiałMięso, wędliny, sery, mleko i inne produkty zamawiane na wagę lub sztuki.
Kwiaciarnie, szkółki i centra ogrodniczeKwiaty, sadzonki, rośliny, ziemia, nawozy i zamówienia przygotowywane do odbioru.
Pasze i zaopatrzenie gospodarstwPasze, zboża, śruta, karma, nawozy i inne produkty zamawiane w workach, big-bagach, kilogramach lub tonach.
Lokalne hurtownie i dostawcyPowtarzalny asortyment zamawiany przez stałych klientów z określeniem ilości, terminu i sposobu odbioru lub dostawy.
Drewno, kruszywa i materiały sypkieDrewno, piasek, żwir, ziemia ogrodowa i podobne towary sprzedawane według ilości i terminu dostawy.
W praktyce system może pasować do wielu innych branż. Najważniejsze jest nie to, co sprzedajesz, ale czy klient może opisać zamówienie krótkim SMS-em, a pracownik potrzebuje je sprawnie uporządkować, potwierdzić i przygotować do odbioru lub dostawy.

Poziom trudności

Konfiguracja panelu (administrator): ★☆☆☆☆ (1 z 5 - bardzo łatwy). Dodanie towarów, dopasowanie treści SMS-ów i dodanie kont pracowników to kilka prostych kroków w Ustawieniach, bez wiedzy programistycznej ani znajomości baz danych.

Konfiguracja trackera (administrator): ★★★☆☆ (3 z 5 - umiarkowany). Samo parowanie telefonu przez kod QR jest proste, ale wymaga też podstawowej znajomości ustawień telefonu - instalacji aplikacji spoza Google Play oraz wyłączenia optymalizacji baterii/zarządzania aplikacjami w tle, żeby Android nie usypiał trackera (patrz część 3.4). Całość pierwszej konfiguracji zajmuje zwykle 15-20 minut - patrz Szybki start.

Codzienna obsługa (pracownik): ★☆☆☆☆ (1 z 5 - bardzo łatwy). System sam odczytuje SMS-y i tworzy z nich zamówienia - wystarczy sprawdzić rozpoznaną treść, zatwierdzić zamówienie i oznaczyć je jako gotowe do odbioru. Nic nie trzeba samodzielnie przepisywać ani liczyć.

Część 1 - Dla pracownika (codzienna obsługa zamówień)

1.1 Logowanie

Aplikację otwiera się w przeglądarce pod adresem podanym przez administratora. Na stronie logowania podaj swój login i hasło i kliknij Zaloguj.

Ze względów bezpieczeństwa, po 5 błędnych próbach dla tego samego loginu (albo 20 prób z tego samego adresu IP, niezależnie od loginu) logowanie zostaje na 15 minut zablokowane. Jeśli zobaczysz komunikat „Zbyt wiele nieudanych prób logowania”, po prostu odczekaj i spróbuj ponownie - albo poproś administratora o reset hasła w sekcji „Konta użytkowników”.

Widoczne zakładki na górnym pasku zależą od uprawnień Twojego konta - ustawia je administrator w Ustawienia → Konta użytkowników (patrz część 2). Jeśli brakuje Ci jakiejś zakładki, poproś administratora o nadanie dostępu.

Zapomniałeś/aś hasła? Jeśli jesteś administratorem, link „Zapomniałem hasła” pojawia się na stronie logowania dopiero po 4 błędnych próbach dla Twojego loginu (nie jest widoczny od razu) - kliknij go, a na adres e-mail przypisany do Twojego konta (patrz 2.7) przyjdzie link do samodzielnego ustawienia nowego hasła, ważny 60 minut. Jeśli jesteś kontem pracownika, hasło może zmienić Ci wyłącznie administrator (Ustawienia → Konta użytkowników).

1.2 Zakładka „Oczekujące”

To główny widok pracy - lista wszystkich zamówień, które jeszcze czekają na realizację, pogrupowana dniami odbioru (najbliższy dzień na górze). Zamówienia bez ustalonej daty odbioru trafiają do osobnej grupy „bez daty”.

1.3 Jak czytać kartę zamówienia

Każde zamówienie to osobna karta z polami: Data przyjęcia, Data odbioru, Klient, Telefon, lista Towarów i ilości oraz (jeśli podano) Pakowanie.

Oznaczenie na karcieCo znaczy
✏️ ikonka przy karcieZamówienie zostało zmienione przez klienta SMS-em (nie w panelu).
⚠️ ikonka przy karcieWykryto próbę edycji/anulowania tego zamówienia z innego numeru telefonu niż ten, na który złożono zamówienie - warto sprawdzić, o co chodzi.
🚫 „Zamówienie anulowane” (szare tło)Zamówienie anulowane (przez klienta SMS-em lub przez pracownika w panelu) - pozostaje widoczne aż do ręcznego usunięcia przyciskiem ×.
Checkbox przy pozycji towaruPojawia się tylko dla towarów śledzonych w Zatowarowaniu. Zaznaczony = towar dostępny na ten dzień; opis „X/Y kg” = dostępna jest tylko część zamówionej ilości (przydział częściowy); ikonka ↺ obok checkboxa pozwala wrócić do przydziału automatycznego po ręcznej korekcie; ⚠ = zamówione ilości przekraczają to, co wpisano w Zatowarowaniu na ten dzień.
🔁 „Wygenerowane z zamówienia cyklicznego #N”To zamówienie powstało automatycznie z zatwierdzonego szablonu cyklicznego (patrz zakładka „Cykliczne”).

Dostępne przyciski akcji na karcie:

PrzyciskDziałanie
✎ EdytujOtwiera formularz edycji danych zamówienia (patrz 1.5).
📩 Potwierdź SMS-emPo sprawdzeniu zamówienia zatwierdza je i wysyła klientowi SMS z potwierdzeniem treści zamówienia. Jeśli zamówienie było już potwierdzone, a później zmienione, system użyje osobnego szablonu potwierdzenia po zmianie.
📦 Gotowe do odbioruUżyj dopiero po skompletowaniu towaru. System wysyła wtedy drugi SMS z informacją, że zamówienie jest gotowe do odbioru.
🚫 AnulujOznacza zamówienie jako anulowane (nie usuwa go) - po potwierdzeniu zapyta dodatkowo, czy wysłać klientowi SMS z informacją o anulowaniu.
✓ OdebranePrzenosi zamówienie do zakładki „Zrealizowane”. Na liście Zrealizowanych ten sam przycisk zamienia się w ↩ Cofnij, gdyby trzeba było pomyłkowo zamknięte zamówienie przywrócić.
× (w rogu karty)Trwale usuwa zamówienie - potwierdzenie wymagane, operacji nie da się cofnąć.

Pod przyciskami może pojawić się dodatkowa linia informująca o statusie wysyłki SMS-a (np. „Potwierdzenie w kolejce do wysłania…”, „✓ Potwierdzenie SMS wysłane”, „⚠ Błąd wysyłki potwierdzenia”) - wysyłka SMS-ów faktycznie zachodzi dopiero, gdy telefon z zainstalowanym trackerem odpyta serwer o kolejkę (patrz część 3), więc status „w kolejce” bywa widoczny przez chwilę, zanim telefon go odbierze. Z powodu ograniczeń systemu Android dotyczących pracy aplikacji w tle, na wysłanie potwierdzenia SMS trzeba czasem poczekać do około 15 minut.

1.4 Dodawanie zamówienia ręcznie

  1. W zakładce „Oczekujące” kliknij + Dodaj zamówienie.
  2. Wypełnij pola: Klient, Telefon (opcjonalnie), Data odbioru, oraz obowiązkowe Towary i ilości - jedna pozycja w jednej linii, np.: borówki - 2kg.
  3. Opcjonalnie podaj sposób pakowania, np. „w woreczkach po 1kg”.
  4. Kliknij Dodaj zamówienie.
Jeśli nie podasz nazwy klienta, ale wpiszesz numer telefonu, aplikacja spróbuje sama znaleźć nazwę klienta na podstawie wcześniejszych zamówień z tego samego numeru.

1.5 Edycja zamówienia i blokowanie klienta

Po kliknięciu ✎ Edytuj możesz zmienić dowolne dane zamówienia (klient, telefon, data odbioru, towary, pakowanie) - widoczna jest też oryginalna treść SMS-a, z którego zamówienie powstało (jeśli dotyczy). Po zapisaniu zmian wcześniejszy status potwierdzenia lub gotowości może zostać wyzerowany, aby można było wysłać klientowi aktualną wiadomość.

Na dole formularza edycji znajduje się przycisk 🚫 Zablokuj klienta - otwiera okienko z dwiema opcjami:

1.6 Zakładka „Zrealizowane”

Lista zamówień oznaczonych jako odebrane, również odświeżana automatycznie co 30 sekund. Karty wyglądają tak samo jak w „Oczekujących”, ale zamiast „Data odbioru” pokazują Zrealizowano - datę i godzinę faktycznego zamknięcia zamówienia.

1.7 Zakładka „Cykliczne”

Kiedy AI rozpozna w treści SMS-a zamówienie o charakterze powtarzalnym (np. „co wtorek 2kg jabłek”), nie trafia ono od razu do „Oczekujących” - ląduje tutaj, w stanie Czeka na przegląd, i czeka na ręczne zatwierdzenie.

StatusZnaczenie
Czeka na przeglądNowe zgłoszenie rozpoznane przez AI. Wymaga Twojej decyzji.
AktywneZatwierdzony szablon - system automatycznie tworzy na jego podstawie kolejne zamówienia do „Oczekujących” z wyprzedzeniem kilku dni (nie na cały okres na raz).
WstrzymaneTymczasowo zatrzymany szablon - nie generuje nowych zamówień, ale można go później wznowić.
OdrzuconeZgłoszenie odrzucone bez zatwierdzania.
AnulowaneTrwale anulowany szablon.

Po kliknięciu w kartę szablonu rozwija się formularz z pełnymi danymi (klient, telefon, towary, typ powtarzania - „co ile dni” albo „konkretne dni tygodnia”, godziny odbioru, data startu/końca) - dane można poprawić przed zatwierdzeniem. Dostępne przyciski, zależnie od statusu:

Nowy szablon cykliczny można też założyć ręcznie przyciskiem + Dodaj zamówienie cykliczne u góry strony, bez czekania na rozpoznanie przez AI.

1.8 Zakładka „Zatowarowanie”

Tu wpisuje się, ile danego towaru jest faktycznie dostępne na dany dzień - system na tej podstawie automatycznie przydziela towar zamówieniom w „Oczekujących” chronologicznie (kto złożył zamówienie wcześniej, dostaje towar w pierwszej kolejności), z możliwością ręcznej korekty checkboxem przy każdej pozycji zamówienia. Towar, dla którego nic tu nie wpisano, jest traktowany jako nieograniczony - nie jest w ogóle śledzony.

Jeśli dla towaru nie ustawisz zatowarowania, system nie będzie ograniczał jego dostępnej ilości. Jeżeli chcesz chronić się przed przyjęciem zbyt dużej liczby zamówień, dodaj zatowarowanie dla tego produktu.

Towar wybiera się ze wspólnego słownika towarów. Nowy towar dodaje administrator w Ustawienia → Towary (patrz 2.3).

Część 2 - Dla administratora (Ustawienia)

Zakładka „Ustawienia” (ikonka w prawym górnym rogu) podzielona jest na kilka rozwijanych sekcji. Część z nich (Konfiguracja trackera, Konta użytkowników, Usuwanie danych) widoczna jest tylko dla administratora.

2.1 Rozpoznawanie zamówień (AI)

Filtrowanie SMS-ów

Tracker przekazuje odebrane SMS-y do systemu. Pole „Słowa kluczowe” określa, które wiadomości mają zostać przeanalizowane przez AI jako możliwe zamówienia. Słowa oddzielaj przecinkami. Warto używać możliwie konkretnych haseł, np. zamawiam, zamów, poproszę, aby ograniczyć analizę wiadomości niezwiązanych z zamówieniami.

Zalecamy używanie osobnego telefonu lub numeru przeznaczonego do obsługi zamówień. Tracker przekazuje odebrane wiadomości do systemu, dlatego prywatny telefon używany do innych rozmów i SMS-ów nie jest najlepszym wyborem.

Domyślna godzina odbioru

Stosowana, gdy klient w SMS-ie poda tylko dzień odbioru bez godziny (np. „odbiór w sobotę”) - AI uzupełni wtedy datę tą właśnie godziną.

2.2 Treści SMS do klienta

Cztery niezależne szablony wiadomości, każdy z osobnym formularzem i przyciskiem „Zapisz”:

SzablonKiedy wysyłany
Treść potwierdzenia SMSPo kliknięciu „📩 Potwierdź SMS-em” przy nowym, jeszcze niepotwierdzonym zamówieniu.
Treść potwierdzenia po zmianie zamówieniaJak wyżej, ale gdy zamówienie było już wcześniej potwierdzone, a potem zmienione (w panelu albo SMS-em przez klienta) - żeby klient nie pomylił tego z potwierdzeniem zupełnie nowego zamówienia.
Treść powiadomienia „Gotowe do odbioru”Po kliknięciu „📦 Gotowe do odbioru”.
Treść SMS-a o anulowaniu zamówieniaOpcjonalnie, do wyboru za każdym razem, po kliknięciu „🚫 Anuluj” w „Oczekujących”. Nie dotyczy sytuacji, gdy to sam klient anuluje zamówienie SMS-em - wtedy nic mu nie wysyłamy, bo już wie.

Dostępne tokeny, podstawiane automatycznie w każdym z powyższych szablonów:

TokenCo wstawia
{items}Lista towarów i ilości. Jeśli dany towar ma na ten dzień w Zatowarowaniu niedobór, do jego nazwy automatycznie doklejane jest „(dostępne X/Y kg)”.
{pickup}„Odbiór: DD.MM.RRRR GG:MM. ” (puste, jeśli brak ustalonej daty).
{packaging}„Pakowanie: …. ” (puste, jeśli brak informacji).
{client_name}Imię/nazwa klienta.
{phone}Numer telefonu klienta.

2.3 Towary i przeliczniki

Towary

Wspólny słownik nazw towarów (podlink „Zarządzaj towarami” → osobna strona) - korzysta z niego Zatowarowanie, przeliczniki jednostek oraz rozpoznawanie zamówień przez AI, dzięki czemu np. „borówki” i „borówek” napisane przez klienta zawsze trafiają pod tę samą nazwę. Nazwę wpisuje się w mianowniku liczby pojedynczej (np. „Borówka”). Każdemu towarowi można przypisać kolor - używany jest w liście towarów na kartach zamówień oraz na wykresie odbiorów. Towar można usunąć tylko wtedy, gdy nie jest już nigdzie używany.

Przelicznik opakowań na kg

Dla towarów podawanych w SMS-ach w sztukach/opakowaniach (np. „2 op”) można ustawić, ile kg odpowiada jednej takiej jednostce - dzięki temu wykres na „Oczekujących” pokazuje wagę zamiast samej liczby sztuk. Jeden towar może mieć kilka różnych jednostek naraz (np. malina: „op” = 0,5 kg i osobno „skrzynka” = 2 kg) - wystarczy dodać kolejny wiersz z tym samym towarem, ale inną nazwą jednostki. Towary bez przelicznika są liczone po prostu na sztuki.

2.4 Eksport danych

Pobiera listę zamówień jako plik CSV (otwiera się bezpośrednio w Excelu), z filtrem po dacie odbioru (od-do) i po statusie (wszystkie / tylko oczekujące / tylko zrealizowane / tylko anulowane). Zostaw daty puste, żeby nie ograniczać zakresu.

Eksport jest automatycznie wyłączony w trakcie trybu demo instancji (widać to po plakietce „✨ Tryb DEMO” w nagłówku aplikacji) - to zabezpieczenie danych demo, nie błąd.

2.5 Pakiet subskrypcyjny i limit zamówień

Każdy płatny pakiet ma określony czas ważności i limit zamówień. Informację o aktywnym pakiecie, pozostałym limicie i terminie jego zakończenia znajdziesz w panelu. Użytkownik nie musi edytować plików konfiguracyjnych ani ustawiać limitów ręcznie.

PakietOkresCenaLimit
Mini14 dni29 zł100 zamówień
Mini30 dni49 zł200 zamówień
Standard14 dni69 zł400 zamówień
Standard30 dni119 zł800 zamówień

Gdy limit zamówień skończy się przed końcem okresu, można dokupić jednorazowy dodatek do bieżącego pakietu (bez zmiany samego pakietu ani jego okresu, do dowolnego pakietu: Mini albo Standard): +50 zamówień za 15 zł, +200 zamówień za 45 zł.

Pakiety indywidualne mogą mieć większe limity i dodatkowe konta użytkowników.

Uruchomienie nowego konta demo może potrwać do 24 godzin od zgłoszenia.

Po wyczerpaniu limitu

Po wykorzystaniu wszystkich zamówień w aktywnym pakiecie system nie zapisuje nowych zamówień do czasu odnowienia lub aktywowania kolejnego pakietu. Dane już zapisane pozostają dostępne.

Po zakończeniu subskrypcji

Jeśli pakiet nie zostanie odnowiony po zakończeniu opłaconego okresu: pierwszego dnia po zakończeniu okresu panel działa jeszcze w pełni (łącznie z zapisem), ale pokazuje ostrzeżenie, że od jutra przejdzie w tryb tylko do odczytu. Od drugiego dnia po zakończeniu okresu panel jest zablokowany do zapisu (dotyczy całego panelu, nie tylko zamówień) i przestaje przetwarzać nowe SMS-y. Nadal można się zalogować i przeglądać wcześniejsze dane - nic nie zostaje usunięte, a pełna funkcjonalność wraca automatycznie po odnowieniu pakietu.

Jeśli pakiet pozostanie nieodnowiony przez cały miesiąc trybu tylko do odczytu, konto zostaje automatycznie zamknięte, a zapisane dane zamówień trwale usunięte (te same dane, które można też usunąć ręcznie - patrz 2.9: towary, ustawienia i konta użytkowników pozostają nietknięte). Logowanie przestaje wtedy działać - w jego miejscu pojawia się informacja o zamknięciu konta wraz z danymi kontaktowymi w sprawie ponownego uruchomienia. Odnowienie pakietu przed upływem tego miesiąca w całości zapobiega zamknięciu.

Po zakończeniu okresu demo

Po zakończeniu okna demo (patrz plakietka „✨ Tryb DEMO” w nagłówku, pokazująca liczbę pozostałych dni) system przestaje przetwarzać nowe wiadomości SMS - zarówno przychodzące, jak i wychodzące - a logowanie do panelu zostaje zablokowane (formularz logowania pokazuje komunikat o zakończeniu okresu demo zamiast pól login/hasło). Żadne dane nie zostają usunięte - przedłużenie okresu demo w config.php od razu przywraca pełny dostęp do panelu i normalne przetwarzanie SMS-ów, bez utraty czegokolwiek.

2.6 Dostęp i bezpieczeństwo

Obsługa AI

Klucz API AI jest dostarczany i konfigurowany automatycznie w ramach płatnej subskrypcji. Nie musisz zakładać osobnego konta u dostawcy AI, kupować własnego klucza ani wpisywać go w ustawieniach. Jeśli rozpoznawanie zamówień przestanie działać mimo aktywnej subskrypcji, sprawdź Logi i w razie potrzeby skontaktuj się ze wsparciem.

Zablokowani klienci

Link „Zarządzaj zablokowanymi” prowadzi do listy numerów pomijanych przy automatycznym przetwarzaniu SMS-ów przez AI (SMS jest odrzucany bez żadnej odpowiedzi, zanim w ogóle trafi do AI). Ręczne dodanie zamówienia w panelu dla zablokowanego numeru jest nadal możliwe. Numer można dodać ręcznie (pole + powód) albo - wygodniej - przyciskiem „🚫 Zablokuj klienta” przy edycji konkretnego zamówienia (patrz 1.5).

Konfiguracja trackera (QR)

Opisana szczegółowo w części 3 poniżej.

Konta użytkowników

Opisane w sekcji 2.7 - tam też administrator ustawia swój adres e-mail do samoobsługowego odzyskiwania hasła.

2.7 Konta użytkowników

Nowe konto (formularz „Dodaj nowe konto”: login, hasło i powtórzenie hasła) domyślnie dostaje dostęp tylko do zakładek Oczekujące i Zrealizowane. Resztę uprawnień ustawia się na liście istniejących kont - dla każdego zwykłego (nie-administratorskiego) konta widoczne są checkboxy dla każdej zakładki (Oczekujące, Zrealizowane, Cykliczne, Zatowarowanie, Logi, Ustawienia) i przycisk „Zapisz uprawnienia”. Używaj długich, unikalnych haseł. Zalecamy co najmniej 12 znaków. Konta administratora mają zawsze pełny dostęp do wszystkich zakładek - tego nie da się ograniczyć z poziomu tego ekranu.

Jeśli pracownik zapomni hasła, administrator może je zmienić bezpośrednio na tej liście - rozwiń „Zmień hasło tego pracownika” przy danym koncie, wpisz nowe hasło (min. 6 znaków) i potwierdź. Ta opcja dotyczy wyłącznie kont pracowników.

Przy własnym koncie administratora, zamiast checkboxów uprawnień, jest sekcja „E-mail do odzyskiwania hasła” - wpisz tam swój adres e-mail, żeby móc samodzielnie zresetować sobie hasło linkiem „Zapomniałem hasła” na stronie logowania (patrz 1.1), bez pomocy nikogo z zewnątrz. Bez ustawionego adresu ta funkcja nie zadziała dla Twojego konta.

Konto można usunąć przyciskiem „Usuń” (poza własnym, aktualnie zalogowanym kontem - to jest zablokowane, żeby nie zostać przypadkiem bez dostępu).

Liczba kont pracowników w pakiecie

Pakiet Mini obejmuje jedno konto (admin/user) - bez dodatkowych kont pracowników. Pakiet Standard pozwala dodać do 3 kont pracowników obok konta administratora. Pakiety indywidualne mają liczbę kont ustaloną osobno. Po osiągnięciu limitu formularz „Dodaj nowe konto” jest tymczasowo niedostępny - pojawia się w jego miejscu informacja o wykorzystanym limicie; usunięcie istniejącego konta pracownika zwalnia miejsce na kolejne.

2.8 Zakładka „Logi”

Dwie pod-zakładki: SMS i Tracker (ostatnie 100 wpisów w każdej).

Log SMS

Każdy SMS, który dotarł do serwera i przeszedł przez logikę filtrowania/AI, zostawia tu wpis - treść, numer nadawcy, data i wynikowy status:

StatusZnaczenie
Zapisano zamówienieSMS został poprawnie rozpoznany jako zamówienie i zapisany.
Anulowano istniejące zamówienieKlient anulował SMS-em wcześniej złożone zamówienie.
🔁 Zamówienie cykliczne - czeka na przeglądAI rozpoznało wzorzec powtarzalny - trafiło do zakładki „Cykliczne”.
AI: to nie zamówienieSMS przeszedł filtr słów kluczowych, ale AI uznało, że to jednak nie jest zamówienie.
Zignorowany (brak słowa kluczowego)SMS nie zawierał żadnego z ustawionych słów kluczowych - w ogóle nie trafił do AI.
⚠ Próba edycji z innego numeruKtoś próbował zmienić/anulować zamówienie SMS-em z numeru innego niż ten, na który je złożono.
🚫 Odrzucono - numer zablokowanySMS z zablokowanego numeru - odrzucony bez analizy AI.
⛔ Zablokowano - limit SMS z tego numeru / globalny limit SMS Zabezpieczenie antyspamowe - zbyt wiele SMS-ów w krótkim czasie (z jednego numeru albo łącznie od wszystkich).
⛔ Zablokowano - limit zamówień w trybie demo / okres demo się zakończyłOgraniczenia aktywne tylko na instancjach w trybie demonstracyjnym.
⛔ Zablokowano - limit zamówień w bieżącym okresie pakietu Wyczerpany limit zamówień w aktywnym pakiecie - patrz sekcja 2.5. Nowe zamówienia będą ponownie przyjmowane po odnowieniu lub aktywowaniu kolejnego pakietu.
🔒 Zablokowano - subskrypcja wygasła (tryb tylko do odczytu) Panel jest w trybie tylko do odczytu po zakończeniu subskrypcji - patrz sekcja 2.5.
Błąd AI / Nieautoryzowany / Brak treściBłąd techniczny podczas przetwarzania wiadomości. Jeśli problem powtarza się mimo aktywnej subskrypcji, skontaktuj się ze wsparciem.

Przy wpisie może być dostępna opcja „✎ Edytuj i przetwórz ponownie”. Administrator może również sprawdzić szczegóły diagnostyczne rozpoznawania AI, gdy trzeba ustalić, dlaczego wiadomość została błędnie zinterpretowana.

Log Tracker

Zdarzenia zgłaszane przez samą aplikację Android (nie dotyczące konkretnego SMS-a, tylko pracy trackera jako takiego) - z poziomem Info / Ostrzeżenie / Błąd. To pierwsze miejsce do sprawdzenia, gdy telefon „nie wysyła” SMS-ów do serwera (patrz część 3.5).

2.9 Usuwanie danych (strefa niebezpieczna)

Operacja nieodwracalna. Przeznaczona dla firm kończących korzystanie z programu. Usuwa trwale: wszystkie zamówienia, szablony zamówień cyklicznych, kolejkę wysyłki SMS-ów i cały log SMS (zakładka Logi). Zostaje bez zmian: towary, przeliczniki jednostek, zatowarowanie, wszystkie ustawienia z tej strony, konta użytkowników i lista zablokowanych numerów.

Przed usunięciem warto pobrać kopię danych w sekcji „Eksport danych” (2.4). Aby odblokować przycisk usuwania, trzeba wpisać dokładnie frazę USUŃ WSZYSTKO w polu potwierdzenia.

Ta sama operacja (z tymi samymi wyłączeniami) wykonuje się automatycznie po miesiącu nieodnowionej subskrypcji w trybie tylko do odczytu - patrz 2.5, „Po zakończeniu subskrypcji”.

Część 3 - Jak połączyć telefon z trackerem (Android)

3.1 Czym jest tracker i do czego służy

Tracker to osobna aplikacja Android („SMS Order Forwarder”), instalowana na telefonie z fizyczną kartą SIM, na którą klienci wysyłają SMS-y z zamówieniami. Aplikacja:

Klient składający zamówienie nie potrzebuje internetu. Twój telefon z trackerem musi jednak mieć dostęp do internetu, aby przekazywać zamówienia do panelu i pobierać wiadomości do wysłania.
Wysyłka SMS-ów do klientów jest kolejkowa, nie natychmiastowa - status „w kolejce” na karcie zamówienia (1.3) oznacza, że wiadomość czeka, aż telefon z trackerem odpyta serwer. Jeśli telefon jest offline albo aplikacja została zamknięta przez system, wysyłki się wstrzymują do czasu jej ponownego uruchomienia. Nawet gdy telefon jest online, system Android z powodów oszczędzania baterii ogranicza, jak często aplikacje mogą działać w tle, więc na wysłanie potwierdzenia SMS można poczekać do około 15 minut - to normalne i nie oznacza awarii.

3.2 Parowanie przez kod QR (zalecane)

Najszybszy i najmniej podatny na literówki sposób skonfigurowania telefonu:

  1. Zaloguj się jako administrator i przejdź do Ustawienia → „Dostęp i bezpieczeństwo” → sekcja „Konfiguracja trackera (QR)” - tam, jeśli tracker nie jest jeszcze zainstalowany na telefonie, znajdziesz też przycisk „📥 Pobierz aplikację trackera (APK)”. Aplikacja nie jest publikowana w Google Play, więc telefon przy instalacji poprosi o zgodę na instalację z nieznanego źródła - to normalne, dotyczy tej jednej aplikacji.
  2. Kliknij 📱 Pokaż kod QR - kod generowany jest w całości lokalnie w przeglądarce; token nigdy nie jest wysyłany do żadnego zewnętrznego serwisu.
  3. Na telefonie otwórz aplikację trackera i uruchom w niej funkcję skanowania ustawień (skanowanie kodu QR wbudowane w samą apkę trackera - nie zwykły aparat/skaner systemowy, patrz uwaga niżej).
  4. Zeskanuj kod wyświetlony na ekranie komputera/telefonu administratora - apka sama uzupełni pola „Adres serwera” i „Token”.
  5. Zapisz ustawienia w trackerze i sprawdź działanie (patrz 3.4).
Kod QR zawiera dane potrzebne do połączenia trackera z Twoim systemem. Traktuj go jak dane dostępowe: nie wysyłaj go osobom trzecim i nie publikuj zrzutów ekranu z kodem.

Kod QR jest ważny tylko w dniu wygenerowania. Jeśli konfigurujesz telefon później, wróć do Ustawień i wygeneruj nowy kod.

3.3 Konfiguracja ręczna (bez QR)

Jeśli skanowanie z jakiegoś powodu nie jest możliwe, w tej samej sekcji Ustawień rozwiń „Nie możesz zeskanować? Wpisz dane ręcznie w apce” i przepisz do trackera dwie wartości:

Pole w trackerzeWartość
Adres serweraAdres pokazany w Ustawieniach jako „Adres serwera” (kończy się na /sms.php) - dokładnie taki sam adres, jakim otwiera się aplikację w przeglądarce.
TokenDługi ciąg znaków pokazany w polu „Token”. Jest to poufny klucz dostępu trackera. Przepisz go dokładnie i nie udostępniaj go osobom trzecim.

3.4 Telefon nie usypia trackera - konfiguracja pracy w tle

Systemy Android (szczególnie u niektórych producentów) domyślnie agresywnie ograniczają albo całkowicie zatrzymują aplikacje działające w tle, żeby oszczędzać baterię - to najczęstsza przyczyna, dla której tracker z pozoru bez powodu przestaje odbierać albo wysyłać SMS-y (patrz też pierwszy wiersz tabeli w 3.6). Poniższe ustawienia trzeba skonfigurować RAZ, bezpośrednio w systemie telefonu z trackerem - nie w samej aplikacji.

  1. Wyłącz optymalizację baterii dla trackera - Ustawienia telefonu → Aplikacje → „SMS Order Forwarder” → Bateria (bywa też nazwane „Użycie baterii” albo „Zarządzanie baterią”) → wybierz „Brak ograniczeń”/„Nieograniczone” zamiast domyślnego „Zoptymalizowane”. Na niektórych telefonach ta opcja jest też dostępna z poziomu Ustawienia → Bateria → Optymalizacja baterii → znajdź aplikację na liście i zmień na „Nie optymalizuj”.
  2. Zezwól na autostart / uruchamianie w tle, jeśli telefon o to pyta przy pierwszym uruchomieniu aplikacji - szczególnie ważne na telefonach z nakładkami, które mają WŁASNY, dodatkowy mechanizm ograniczania aplikacji w tle, niezależny od standardowych ustawień systemu Android (patrz tabela niżej).
  3. Nie zamykaj aplikacji trackera przesunięciem z listy ostatnich aplikacji - na wielu telefonach system traktuje to jako świadome zamknięcie i przestaje budzić aplikację w tle, dopóki ktoś nie otworzy jej ręcznie ponownie.
  4. Zadbaj o stały dostęp telefonu do internetu (Wi-Fi albo transmisja danych) - bez tego tracker nie przekaże ani nie wyśle żadnej wiadomości, niezależnie od pozostałych ustawień (patrz ostrzeżenie w 3.1).
  5. Jeśli to telefon dedykowany wyłącznie do tej roli (zalecane), trzymaj go podłączonego do ładowarki i pomiń ewentualny tryb „oszczędzania energii”/„uśpienia” systemu - te tryby dodatkowo zaostrzają ograniczenia pracy w tle.
Producent / nakładkaGdzie szukać dodatkowych ustawień
Xiaomi / Redmi (MIUI / HyperOS)Ustawienia → Aplikacje → Zarządzaj aplikacjami → „SMS Order Forwarder” → włącz „Autostart”; dodatkowo w aplikacji „Zabezpieczenia” → Uprawnienia → Oszczędzanie baterii → ustaw „Brak ograniczeń”.
Huawei (EMUI / HarmonyOS)Ustawienia → Bateria → Uruchamianie aplikacji → znajdź trackera i wyłącz zarządzanie automatyczne, ręcznie włączając „Autostart”, „Uruchamianie drugoplanowe” i „Uruchamianie powiązane”.
Samsung (One UI)Ustawienia → Opieka o baterię i urządzenie → Bateria → Ograniczenia użycia w tle → upewnij się, że tracker NIE jest na liście „Uśpione aplikacje” ani „Głęboko uśpione aplikacje”.
Oppo / OnePlus (ColorOS / OxygenOS), Vivo (FuntouchOS/OriginOS)Ustawienia → Bateria → Zużycie baterii aplikacji → „SMS Order Forwarder” → zezwól na „Uruchamianie w tle” i wyłącz „Zoptymalizowane zużycie baterii” dla tej aplikacji.
Dokładne nazwy opcji i ścieżki w menu różnią się między wersjami systemu i nakładkami producentów - powyższe to najczęstsze umiejscowienie. Jeśli nie możesz znaleźć danej opcji, warto wyszukać w internecie frazę „[nazwa i model telefonu] jak wyłączyć optymalizację baterii dla aplikacji” - dla konkretnego modelu telefonu.

3.5 Jak sprawdzić, że tracker działa

  1. W aplikacji webowej przejdź do zakładki „Logi” → pod-zakładka Tracker. Po skonfigurowaniu telefonu i pierwszym połączeniu powinny zacząć pojawiać się tam wpisy (poziom Info) - to potwierdza, że telefon poprawnie łączy się z serwerem.
  2. Wyślij testowy SMS z zamówieniem na numer skonfigurowanej karty SIM (z treścią zawierającą jedno z ustawionych słów kluczowych, np. „zamawiam 1kg jabłek”). Po chwili sprawdź „Logi” → pod-zakładka SMS - powinien pojawić się nowy wpis ze statusem „Zapisano zamówienie”, a samo zamówienie - w zakładce „Oczekujące”.
  3. Kliknij przy tym zamówieniu „📩 Potwierdź SMS-em” i sprawdź, czy testowy telefon odbiorcy faktycznie dostał SMS zwrotny - to potwierdza, że działa też kierunek wychodzący (kolejka wysyłki).

3.6 Rozwiązywanie problemów

ObjawPrawdopodobna przyczyna / co sprawdzić
Brak jakichkolwiek nowych wpisów w Logi → TrackerTelefon jest offline, aplikacja trackera została zatrzymana przez system Android (oszczędzanie baterii - zob. 3.4), albo wpisany adres serwera/token jest błędny. Sprawdź w aplikacji trackera komunikat błędu, jeśli jakiś pokazuje.
SMS-y przychodzą do trackera, ale nie pojawiają się jako zamówieniaSprawdź Logi → SMS - status „Zignorowany (brak słowa kluczowego)” oznacza, że treść nie zawierała żadnego z ustawionych słów kluczowych (2.1); status „AI: to nie zamówienie” oznacza, że AI przeanalizowało SMS, ale nie uznało go za zamówienie - rozwiń „🔍 Debug AI” przy wpisie, żeby zobaczyć dokładne uzasadnienie.
Wszystkie SMS-y kończą się błędem „Błąd AI”Sprawdź, czy subskrypcja jest aktywna. Klucz AI jest dostarczany automatycznie w płatnym pakiecie, więc użytkownik nie konfiguruje go ręcznie. Jeśli problem nadal występuje, sprawdź Logi i skontaktuj się ze wsparciem.
Kod QR nie działa przy skanowaniuNajczęściej kod jest z poprzedniego dnia (kod ważny tylko „na dziś” - patrz 3.2) - wygeneruj nowy przyciskiem „Pokaż kod QR”. Upewnij się też, że skanujesz go wbudowaną funkcją skanowania w aplikacji trackera, nie zwykłym aparatem/czytnikiem QR systemu.
Potwierdzenia/powiadomienia SMS wiszą w statusie „w kolejce” bardzo długoTelefon z trackerem prawdopodobnie nie łączy się z serwerem - sprawdź jak w pierwszym wierszu tej tabeli.
SMS-y od konkretnego numeru w ogóle nie są przetwarzaneSprawdź, czy numer nie znajduje się na liście zablokowanych (Ustawienia → Zablokowani klienci, 2.6) - takie SMS-y są odrzucane jeszcze przed analizą AI, ze statusem „🚫 Odrzucono - numer zablokowany” w logu.

Jeśli żadna z powyższych podpowiedzi nie pomoże, skontaktuj się w sprawie wsparcia technicznego pod adresem zamowienia@ladybit.pl.