Przejdź do treści
Fridman
EN

Bot dla zespołu w terenie

Ludzie w Reefie nie logują się do żadnego panelu. Zmianę zaczynają i kończą w Telegramie jednym przyciskiem, z lokalizacją obiektu, wysyłają zdjęcia z pracy, proszą o środki czystości i sprawdzają swoje zarobki. Bota zbudowałem sam, a we wrześniu 2026 przebudowałem go od zera według zasady „jeden przycisk”.

Takie rozwiązanie przyda się każdej firmie, której ludzie pracują poza biurem: sprzątanie, ochrona, serwis, budowy. Bota dla zespołu buduję jako część systemu dla firmy, od 60 000 zł netto. Pracuję z Krakowa, zdalnie i na miejscu w całej Polsce.

1 100 h

pracy zarejestrowanej przez bota w sierpniu 2026, w 364 zmianach (stan na 21.09.2026)

Firma
Reefa, firma sprzątająca B2B z Krakowa i Katowic
Okres
czerwiec–październik 2026
Moja rola
Właściciel. Zaprojektowałem i zbudowałem bota; przebudowę sprawdzały niezależne przeglądy agentów AI.
Usługi
Podobne wdrożenie
od 60 000 złnetto

Jak to wygląda na ekranie

Tak wygląda zmiana od strony pracownika. Obok reguły, które bot stosuje za tym jednym przyciskiem.

Reguły za jednym przyciskiem

3 min
blokada podwójnego startu, z przyciskiem „Anuluj start”
90 s
okno, w którym powtórne naciśnięcie jest ignorowane
30 min
okno, w którym ponowny start trzeba potwierdzić
6 h
po tylu godzinach zakończenie zmiany wymaga potwierdzenia
14 h
zapomniana zmiana zamyka się sama, z długością równą medianie ostatnich zmian tej osoby na tym obiekcie
15 min
okno na zdjęcia po zakończeniu zmiany
20, 40, 60 min
alerty, gdy zmiana nie zaczęła się o czasie
5 min
co tyle działa kontrola w tle
Schemat rozmowy z botem. Obiekt, godzina i zdjęcia to przykłady, nie prawdziwe dane.

Dlaczego zwykły panel nie działa w terenie

Osoba, która sprząta biuro o szóstej rano, nie będzie logować się do panelu ani wypełniać formularza. Ma telefon i komunikator. Jeśli zapisanie zmiany wymaga więcej niż jednego naciśnięcia, część zmian po prostu nie zostanie zapisana i nie będzie wiadomo, ile godzin przepracowano na obiekcie.

Pierwsza wersja bota działała, ale ludzie mówili, że „pyta dwa razy”, a na jednym z obiektów ginęły zdjęcia. Oba problemy rozwiązałem, zaczynając od danych, a nie od kodu.

Czego biuro potrzebuje od ludzi w terenie

  • Kiedy ktoś zaczął i skończył pracę na obiekcie
  • Zdjęcia po każdej zmianie, przypisane do właściwej zmiany
  • Informacji, że ktoś się spóźnia, zanim zadzwoni klient
  • Próśb o środki czystości bez telefonów i SMS-ów
  • Tego samego po polsku i po rosyjsku, zależnie od osoby

Co zbudowałem

Bot jest częścią systemu opisanego w realizacji o panelu Reefy: wszystko, co pracownik zrobi w Telegramie, od razu widać w panelu.

  • Przebudowa „jeden przycisk”

    Audyt we wrześniu 2026 potwierdził 55 problemów. Przyczyna „pyta dwa razy”: druga lokalizacja wysłana kilka sekund później zmieniała stan zmiany. Napisałem bota od nowa jako router, bibliotekę i osobne scenariusze, z 19 testami na prawdziwych sekwencjach. Przed wdrożeniem 22 września kod przeszedł dwa niezależne przeglądy: 93 i 45 agentów AI.

  • Zdjęcia, które już nie giną

    W logach nie było żadnego błędu. Dopiero dane pokazały, że w 17 z 24 zmian na tym obiekcie ostatnie zdjęcie dochodziło 0–1 sekundy przed „Zakończ”, więc zamknięcie zmiany wyprzedzało wysyłkę albumu. Dodałem 15-⁠minutowe okno na zdjęcia, zakaz zamykania zmiany bez zdjęć (z osobnym przyciskiem „Zakończ bez zdjęć”), wyraźny komunikat o niezapisanym zdjęciu, unikalne nazwy plików i ponowienie wysyłki przy limicie Telegrama.

    działa samo

  • Język wybierany dla każdej osoby

    Koordynator wybiera polski albo rosyjski, zanim wyśle zaproszenie. Bot rozpoznaje przyciski w obu językach, więc zmiana języka niczego nie psuje. Przed wdrożeniem: 23 z 23 testów, przegląd 21 agentów i 22 poprawki.

  • Reguły zmian

    działa samo

    Blokada podwójnego startu na 3 minuty z przyciskiem „Anuluj start”, potwierdzenie końca po 6 godzinach, a zapomniana zmiana zamyka się sama po 14 godzinach z długością równą medianie ostatnich zmian tej osoby na tym obiekcie. Kontrola w tle co 5 minut.

  • Alerty o spóźnieniach

    działa samo

    Gdy zmiana nie zaczęła się o czasie, bot wysyła alert po 20, 40 i 60 minutach.

  • Zdjęcia dla kierownika i klienta

    działa samo

    Albumy trafiają do kierowników paczkami po 10 zdjęć, a klient widzi zdjęcia z każdej zmiany w zakładce „Zdjęcia” swojego portalu.

  • Bot grup na obiektach z apartamentami

    działa samo

    Ekipy piszą w grupie obiektu numer lokalu i wysyłają zdjęcia. Bot rozpoznaje obiekt po nazwie grupy i numer lokalu (także 4.2, 4-2 czy 12A.2). Gdy numeru brakuje, AI odczytuje go z drzwi na zdjęciu, a przy niepewności bot dopytuje w grupie. Podsumowanie dnia o 21:00.

  • Zgodność z raportami operatora

    Importer rezerwacji z PDF odczytał 31 z 31 wierszy i żadnego nie zostawił bez przypisania. Od 9 września dane z bota zgadzały się z raportami operatora apartamentów dzień po dniu, a wrzesień uzgodniłem w całości: 151 sprzątań.

  • Trzy osobne boty

    Bot zespołu, bot sprzedaży i mój bot zarządczy są rozdzielone, żeby wiadomości dla ludzi, handlowców i właściciela się nie mieszały.

  • Dokumenty przez bota zarządczego

    działa samo

    Przesyłam zdjęcie podpisanego dokumentu, a AI rozpoznaje pracownika, typ i miesiąc, zapisuje dokument w jego karcie i pyta o brakujące miesiące.

  • Zabezpieczenie wejścia

    Bot przyjmuje tylko wiadomości od Telegrama z tajnym kluczem. Test na żywo: bez klucza odpowiedź 403, kontrola w tle bez błędów.

Jak to jest połączone

Pracownik widzi jeden przycisk na każdy krok. Reguły, które za nim stoją, działają bez udziału biura.

  1. 1. Pracownik

    • Przycisk w Telegramie

      jeden na każdy krok

      decyduje człowiek

    • Lokalizacja

      sprawdzana przy obiekcie

    • Zdjęcia z pracy

  2. 2. Bot

    • Scenariusze zmian

      19 testów na prawdziwych sekwencjach

      działa samo

    • Reguły czasu

      3 min, 90 s, 6 h, 14 h

      działa samo

    • Okno na zdjęcia

      15 minut po zakończeniu

      działa samo

    • Język osoby

      polski albo rosyjski

      działa samo

  3. 3. Panel

    • Dziennik zmian

      godziny do rozliczeń

      działa samo

    • Zdjęcia przy zmianie

      działa samo

  4. 4. Wyniki

    • Kierownik

      albumy po 10 zdjęć

    • Klient

      zakładka „Zdjęcia” w portalu

    • Alerty o spóźnieniu

      po 20, 40 i 60 min

      działa samo

Pracownik naciska przycisk i wysyła zdjęcia. Bot pilnuje reguł zmian i zapisuje wszystko w panelu, skąd zdjęcia trafiają do kierownika i klienta, a alerty o spóźnieniach wychodzą same.

Legenda:działa samodecyduje człowiekdane, ludzie albo miejsce pracy

Liczby z systemu

Liczby z systemu, z datą pomiaru
Co mierzęWartość
Godziny zarejestrowane przez bota, czerwiecstan na 21.09.2026848 h, 251 zmian
Godziny zarejestrowane przez bota, lipiecstan na 21.09.2026960 h, 329 zmian
Godziny zarejestrowane przez bota, sierpieństan na 21.09.20261 100 h, 364 zmiany
Problemy potwierdzone w audycie przed przebudowąstan na 22.09.202655
Testy scenariuszy po przebudowiestan na 22.09.202619
Niezależne przeglądy kodu przed wdrożeniemstan na 22.09.20262 (93 i 45 agentów)
Zmiany z ostatnim zdjęciem 0–1 s przed końcemstan przed poprawkąstan na 9.08.202617 z 24 na jednym obiekcie
Testy wersji językowychstan na 2.10.202623 z 23
Sprzątania apartamentów uzgodnione z operatoremstan na 1.10.2026151 we wrześniu

Bot nie obejmuje jeszcze wszystkich obiektów. W czerwcu przechodziła przez niego mniej więcej połowa zaplanowanych wizyt, więc godziny z tabeli to tylko część pracy firmy.

Godziny liczę wyłącznie ze zmian trwających do 12 godzin.

Na czym to działa

Telegram Bot API
rozmowa z pracownikiem, przyciski, zdjęcia, lokalizacja
Supabase Edge Functions (Deno)
logika bota i kontrola w tle co 5 minut
Supabase: Postgres i Storage
zmiany, zdjęcia, uprawnienia
Anthropic Claude
numer lokalu ze zdjęcia drzwi, dokumenty, prośby o zakupy
Testy scenariuszy
19 sekwencji z prawdziwych zmian

Co z tego możesz mieć u siebie

  • Narzędzie tam, gdzie ludzie już są

    Twój zespół w terenie ma telefon i komunikator. Bot nie wymaga szkolenia, logowania ani instalowania kolejnej aplikacji, więc ludzie naprawdę z niego korzystają.

  • Diagnoza z danych, zanim zmienisz kod

    Zdjęcia nie ginęły przez błąd, który dałoby się znaleźć w kodzie. Wyszło to dopiero z czasów zapisanych w bazie. Zanim coś przebuduję u Ciebie, sprawdzam, co mówią dane.

  • Reguły zamiast przypominania

    Okno na zdjęcia, blokada podwójnego startu, samo zamykanie zapomnianej zmiany. Każda z tych reguł zastępuje telefon z biura.

  • Jeden przycisk na każdy krok

    Im mniej decyzji ma pracownik, tym mniej błędów w danych. Projektuję ekran tak, żeby w danym momencie dało się zrobić tylko właściwą rzecz.

Usługi, w których to robię

Inne realizacje

  • 13System operacyjny firmy usługowejJeden panel dla całej firmy: grafik i zmiany, finanse kilku podmiotów, kasa, bank, umowy z e-podpisem i raporty dla klientów.
  • 11Agenci AI, którzy prowadzą część firmy11 rutyn i agentów: doktor panelu, treści SEO, wzrost zapytań, moderacja, przetargi i poranny brief. Pięć z nich zapisuje decyzje w dzienniku, a wdrożenia mają automatyczne wycofanie.
  • +30%Wzrost organiczny reefa.plPlan 33 zmian SEO i GEO, 29 darmowych narzędzi, otwarty zbiór norm (460 kategorii z 2 338 wierszy danych) i rutyna treści. Kliknięcia z Google wzrosły w lipcu z 8,6 do 11,2 dziennie.
  • 3 dniKtoSprząta.pl — platforma branżowaKatalog firm z rejestrów publicznych, wyszukiwarka, która poprawia literówki, darmowy panel Pro dla firm i moderacja AI 3 razy dziennie.

Porozmawiajmy o Twojej firmie

30 minut, bez prezentacji sprzedażowej. Opowiadasz, gdzie ucieka czas i pieniądze, a ja mówię, co bym zrobił najpierw i ile to mniej więcej kosztuje.

Umów 30-minutową rozmowęNajpierw zrób diagnozę AI

albo napisz: ilya@fridman.pl