Codzienna obsługa zamówień, ustawienia administratora i konfiguracja telefonu z trackerem.
Aplikację otwiera się w przeglądarce pod adresem podanym przez administratora. Na stronie logowania podaj swój login i hasło i kliknij Zaloguj.
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.
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”.
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 karcie | Co znaczy |
|---|---|
| ✏️ ikonka przy karcie | Zamówienie zostało zmienione przez klienta SMS-em (nie w panelu). |
| ⚠️ ikonka przy karcie | Wykryto 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 towaru | Pojawia 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:
| Przycisk | Działanie |
|---|---|
| ✎ Edytuj | Otwiera formularz edycji danych zamówienia (patrz 1.5). |
| 📩 Potwierdź SMS-em | Po 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 odbioru | Użyj dopiero po skompletowaniu towaru. System wysyła wtedy drugi SMS z informacją, że zamówienie jest gotowe do odbioru. |
| 🚫 Anuluj | Oznacza zamówienie jako anulowane (nie usuwa go) - po potwierdzeniu zapyta dodatkowo, czy wysłać klientowi SMS z informacją o anulowaniu. |
| ✓ Odebrane | Przenosi 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.
borówki - 2kg.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:
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.
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.
| Status | Znaczenie |
|---|---|
| Czeka na przegląd | Nowe zgłoszenie rozpoznane przez AI. Wymaga Twojej decyzji. |
| Aktywne | Zatwierdzony szablon - system automatycznie tworzy na jego podstawie kolejne zamówienia do „Oczekujących” z wyprzedzeniem kilku dni (nie na cały okres na raz). |
| Wstrzymane | Tymczasowo zatrzymany szablon - nie generuje nowych zamówień, ale można go później wznowić. |
| Odrzucone | Zgłoszenie odrzucone bez zatwierdzania. |
| Anulowane | Trwale 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.
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.
Towar wybiera się ze wspólnego słownika towarów. Nowy towar dodaje administrator w Ustawienia → Towary (patrz 2.3).
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.
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.
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ą.
Cztery niezależne szablony wiadomości, każdy z osobnym formularzem i przyciskiem „Zapisz”:
| Szablon | Kiedy wysyłany |
|---|---|
| Treść potwierdzenia SMS | Po kliknięciu „📩 Potwierdź SMS-em” przy nowym, jeszcze niepotwierdzonym zamówieniu. |
| Treść potwierdzenia po zmianie zamówienia | Jak 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ówienia | Opcjonalnie, 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:
| Token | Co 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. |
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.
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.
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.
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.
| Pakiet | Okres | Limit |
|---|---|---|
| Mini | 7 dni | 50 zamówień |
| Mini | 30 dni | 200 zamówień |
| Standard | 7 dni | 200 zamówień |
| Standard | 30 dni | 800 zamówień |
Pakiety indywidualne mogą mieć większe limity i dodatkowe konta użytkowników.
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 opłaconego okresu panel może przejść w tryb tylko do odczytu. Nadal można zalogować się i przeglądać wcześniejsze dane, ale nowe zamówienia nie są przetwarzane do czasu przedłużenia subskrypcji.
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.
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).
Opisana szczegółowo w części 3 poniżej.
Opisane w sekcji 2.7.
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.
Konto można usunąć przyciskiem „Usuń” (poza własnym, aktualnie zalogowanym kontem - to jest zablokowane, żeby nie zostać przypadkiem bez dostępu).
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.
Dwie pod-zakładki: SMS i Tracker (ostatnie 100 wpisów w każdej).
Każdy SMS, który dotarł do serwera i przeszedł przez logikę filtrowania/AI, zostawia tu wpis - treść, numer nadawcy, data i wynikowy status:
| Status | Znaczenie |
|---|---|
| Zapisano zamówienie | SMS został poprawnie rozpoznany jako zamówienie i zapisany. |
| Anulowano istniejące zamówienie | Klient anulował SMS-em wcześniej złożone zamówienie. |
| 🔁 Zamówienie cykliczne - czeka na przegląd | AI rozpoznało wzorzec powtarzalny - trafiło do zakładki „Cykliczne”. |
| AI: to nie zamówienie | SMS 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 numeru | Ktoś próbował zmienić/anulować zamówienie SMS-em z numeru innego niż ten, na który je złożono. |
| 🚫 Odrzucono - numer zablokowany | SMS 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ści | Błą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.
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).
⚠ 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.
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:
Najszybszy i najmniej podatny na literówki sposób skonfigurowania telefonu:
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 trackerze | Wartość |
|---|---|
| Adres serwera | Adres pokazany w Ustawieniach jako „Adres serwera” (kończy się na
/sms.php) - dokładnie taki sam adres, jakim otwiera się aplikację w przeglądarce. |
| Token | Dł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. |
| Objaw | Prawdopodobna przyczyna / co sprawdzić |
|---|---|
| Brak jakichkolwiek nowych wpisów w Logi → Tracker | Telefon jest offline, aplikacja trackera została zatrzymana przez system Android (oszczędzanie baterii), 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ówienia | Sprawdź 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 skanowaniu | Najczęś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ługo | Telefon 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ą przetwarzane | Sprawdź, 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.