amator.app
Publiczne API + n8n

Bot Telegram

Twoje gry w tej samej grupie, w której i tak się dogadujecie. Bot publikuje każdą grę, trzyma listę grających w aktualnym stanie i pozwala odpowiedzieć jednym tapnięciem.

Bot grupowy jeszcze nie działa na produkcji. Na razie chodzi na stacku deweloperskim, więc nazwa bota i linki z tej strony zaczną działać dopiero wtedy, gdy stanie bot produkcyjny.

Do czego to jest

Gry organizatora z Amator trafiają do grupy na Telegramie, a gracze odpowiadają w grupie. Nikt nie przepisuje listy, nikt nie liczy odpowiedzi — sam post jest odpowiedzią na pytanie „kto jest w sobotę”.

Bot robi trzy rzeczy:

  • publikuje każdą nową grę organizatorów podłączonych do grupy;
  • trzyma post w aktualnym stanie — kto gra, kto jest w rezerwie, ile miejsc zostało;
  • przyjmuje odpowiedzi z trzech przycisków pod postem i zapisuje je od razu w grze.

Wszystko dzieje się w grupie i na prywatnym czacie bota. Bot nie pisze nigdzie więcej.

Dla organizatora

Dodaj bota do grupy

Dodaj the Amator bot do grupy na Telegramie tak samo jak każdą inną osobę. Przy wejściu bot nic nie napisze — tak ma być, żeby nie wchodzić w środek rozmowy.

Jeśli chcesz, żeby bieżąca gra była przypięta, daj mu prawo przypinania wiadomości. Bez tego prawa po prostu nigdy nie przypina.

Wyślij /bind

Wyślij /bind w grupie. Podłączyć grupę może tylko administrator — bot pyta Telegram o Twój status w tym momencie, a nie wierzy samej wiadomości.

Jeśli Twój Telegram jest połączony z jednym kontem Amator i organizujesz sam, odpowiedź brzmi:

✅ Gotowe! Twoje gry z Amator będą publikowane w tej grupie.

Screenshot

Grupa na Telegramie, w której bot odpowiada na /bind jedną linią: „✅ Gotowe! Twoje gry z Amator będą publikowane w tej grupie.”

Co widzi grupa po `/bind` — jedno krótkie potwierdzenie i nic więcej.

Jeśli jesteś też kapitanem klubu, bot najpierw zapyta — Czyje gry publikować w tej grupie? — z przyciskiem na każdą opcję: Moje gry i Klub {owner}. Nacisnąć może tylko osoba, która wysłała /bind. Pytanie jest potem przepisywane na odpowiedź, więc w grupie zostaje jedna wiadomość, a nie trzy.

Dwie odpowiedzi znaczą, że najpierw trzeba coś poprawić:

odpowiedźco zrobić
Najpierw połącz Telegram z Amator…Otwórz prywatny czat z botem i skorzystaj z linku z aplikacji: Profil → Ustawienia → Połączone konta → Telegram.
Piszesz jako anonimowy administrator…Wyłącz anonimowość na chwilę albo użyj linku z aplikacji.

Gry zaczynają przychodzić

Od tej chwili każda nowa gra tego organizatora pojawia się tutaj w kilka sekund od utworzenia. Gra już odwołana albo zakończona nie jest ogłaszana nigdy.

Post linia po linii

⚽ Mokotów · 7×7
🗓 sobota, 24 października · zbiórka 14:45 · gra 15:00–17:00
📍 Orlik Cieszyńska · Mokotów, Warszawa
💰 15 zł od osoby
📶 Początkujący – Zaawansowany
👤 Organizator: Vlad

Grają (4/12) · minimum 8
1. Vlad K.
2. Igor D.
3. Player
4. Guest (rezerwowy)
Rezerwa (2)
1. Andrii F.
2. Tážū
Gdy zwolni się miejsce, pierwszy z rezerwy wchodzi do składu
Zastanawiają się (2)
Nie będę (1)

⚠️ Jeszcze 4 do minimum · wolne: 8
Aby się zapisać — otwórz bota i naciśnij Start
Screenshot

Post z grą w grupie na Telegramie: tytuł i format, data ze zbiórką i godzinami gry, obiekt, cena, poziom, organizator, a pod tym numerowany skład, rezerwa i linia stanu

Ten sam post w prawdziwej grupie, z przyciskami odpowiedzi pod nim.
liniaco to jest
tytułnazwa gry i jej format. Przekreślony, gdy gra jest odwołana.
🗓dzień, godzina zbiórki oraz początek i koniec samej gry.
📍obiekt, dzielnica i miasto. Pomijane, dopóki miejsce nie jest jawne.
💰cena od osoby. Pomijana, gdy gra jest bez opłaty.
📶poziom, a przy kilku poziomach — zakres.
👤imię organizatora.
Grają (przyjęci/maksimum)kto jest w składzie, po kolei. · minimum N dochodzi tylko wtedy, gdy gra ma minimum — i znika, gdy minimum równa się maksimum, bo wtedy nic nie mówi. Gracz z dopiskiem (rezerwowy) zajmuje miejsce gościa.
Rezerwa (N)kolejka, gdy organizator przyjmuje graczy automatycznie. Kursywa pod spodem mówi, że pierwszy z kolejki wchodzi na zwolnione miejsce. Przy ręcznym przyjmowaniu w tym miejscu są Zgłoszenia (N).
Zastanawiają się / Nie będędwie listy odpowiedzi. Imiona są zawsze schowane w rozwijanym cytacie, nawet jedno, żeby post został krótki. Druga lista ma w nagłówku słowa z samego przycisku ❌.
linia stanu⚠️ Jeszcze N do minimum poniżej minimum, ✅ Gra się odbędzie od minimum w górę albo Nabór graczy, gdy minimum nie ma — a za tym wolne: N. Gra pełna, zamknięta, odwołana albo zakończona zastępuje całą linię swoją: Brak miejsc · jest rezerwa, 🔒 Zapisy zamknięte., ❌ Gra odwołana, Gra się odbyła · graczy: N.
linia zapisuAby się zapisać — otwórz bota i naciśnij Start, gdzie środek jest linkiem. Tylko dopóki gra przyjmuje odpowiedzi i wolno zrobić profil z Telegrama — patrz dołączanie bez aplikacji.

Długie listy się zwijają: powyżej ośmiu imion lista idzie do rozwijanego cytatu, a powyżej czterdziestu ogon zamienia się w … i jeszcze N. Jeśli post i tak byłby za długi dla Telegrama, bot skraca listy — najpierw rezerwę, zastanawiających się i „nie będę”, skład na samym końcu.

Przyciski

przyciskco robi
✅ Będęodpowiada „tak”. Jest, dopóki gra jest otwarta albo pełna.
❌ Nie będęodpowiada „nie”.
⏳ Późniejwpisuje Cię do „zastanawiają się”, żeby organizator wiedział, że widziałeś grę.
📋 Otwórzotwiera grę — w Mini App, gdy jest podłączona, a jeśli nie, to stronę gry. Jest zawsze.
📅 Wszystkie grynajbliższe gry tej grupy. Tylko przy podłączonej Mini App.
Screenshot

Trzy przyciski odpowiedzi pod postem — „✅ Będę”, „❌ Nie będę”, „⏳ Później” — a pod nimi „📋 Otwórz”

Przyciski pod postem. Naciśnięcie zmienia post i nigdy nie dopisuje wiadomości w grupie.

Naciśnięcie przycisku nie pisze w grupie żadnej wiadomości. Zmienia się sam post, więc jedna gra zostaje jedną wiadomością, choćby odpowiedziało dwanaście osób.

Jak post się odświeża

Każda odpowiedź, każda zmiana w grze i każde przypomnienie odświeżają post. Bot zbiera zmiany razem — około pięć sekund po ostatniej i nie później niż dwadzieścia sekund po pierwszej — więc dwanaście osób odpowiadających naraz daje jedną zmianę, nie dwanaście. Jeśli w treści nic się realnie nie zmieniło, bot nie wykonuje żadnego wywołania.

Kilka rzeczy przychodzi jako odpowiedź pod postem, a nie jako zmiana w nim: inna godzina, inne miejsce, przypomnienie dzień wcześniej i — najwyżej raz na dobę — alert potrzeba jeszcze graczy z jednym przyciskiem ✅ Będę.

Telegram ogranicza, jak szybko bot może pisać w jednym czacie, więc bot trzyma się jednej operacji na trzy sekundy na grupę. Przy nawale zmiany czekają w kolejce, zamiast się nie udać.

Zasady gry

Jeśli organizator dołączył do gry zasady, gracz po naciśnięciu ✅ Będę dostaje je na prywatnym czacie bota: linia gry, Organizator prosi o akceptację zasad gry: i same zasady w rozwijanym cytacie. Ostatnia wiadomość ma przyciski ✅ Akceptuję i zapisuję się oraz Nie teraz. Nic nie jest zapisywane, dopóki gracz nie zaakceptuje; a jeśli zasady zmienią się w międzyczasie, bot pokazuje nową wersję, zamiast przyjmować starą.

Odłączanie

/unbind w grupie zatrzymuje publikowanie:

Gotowe. Gry nie będą już publikowane w tej grupie.

Odłączyć może tylko administrator grupy albo osoba, która podłączyła gry. Posty, które już są, zostają na miejscu — bot przestaje je tylko odświeżać.

Usunięcie bota z grupy działa tak samo i znowu nic nie zostaje napisane na pożegnanie.

Dla gracza

Żeby odpowiedzieć, nie musisz nic instalować. Naciśnij ✅ Będę, ❌ Nie będę albo ⏳ Później pod postem, a lista w poście się zaktualizuje.

Zmiana decyzji to ten sam ruch: naciśnij inny przycisk. Post się zmienia i nic nie jest ogłaszane w grupie.

Dołączanie bez aplikacji

Jeśli Twój Telegram nie jest połączony z Amator, bot otwiera prywatny czat i proponuje zrobienie profilu z Twojego konta Telegram — bez hasła. Karta pokazuje grę, powitanie i jedną linię zgody:

Kontynuując, akceptujesz Regulamin i Politykę prywatności oraz potwierdzasz, że masz ukończone 16 lat.

Nie ma żadnych checkboxów. Odpowiedzią są trzy przyciski:

przyciskco się dzieje
✅ Akceptuję — zapisz mnieprofil zostaje utworzony, a Twoja odpowiedź policzona. Bot zapisuje, w jakim języku karta była pokazana i na jaki dokładnie tekst się zgodziłeś.
Mam już konto Amatornic nie jest tworzone. Bot tłumaczy, jak połączyć Telegram w aplikacji — Profil → Ustawienia → Połączone konta → Telegram — i trzyma Twoją odpowiedź 24 godziny, więc zaliczy się od razu po połączeniu.
Nie mam jeszcze 16 latnic nie jest tworzone. Amator jest dostępny od 16 lat. Wróć, gdy skończysz 16 lat.
Screenshot

Prywatny czat bota z kartą zapisu: linia gry, powitanie, zdanie zgody z dwoma linkami i trzy przyciski pod nim

Karta na prywatnym czacie bota — dla gracza, którego Telegram nie jest jeszcze połączony z Amator.

Krok z numerem telefonu

Niektóre gry wymagają potwierdzonego numeru telefonu. Gdy brakuje tylko tego, bot dokańcza sprawę na prywatnym czacie: pyta raz i pokazuje przycisk Udostępnij numer telefonu.

Numer musi przyjść z tego przycisku — Telegram wysyła go jako kontakt i musi to być Twój własny. Wpisanego z ręki bot nie przyjmie. Po potwierdzeniu numeru Twoja odpowiedź z grupy zostaje policzona w tym samym kroku, a klawiatura znika.

Screenshot

Prywatny czat bota z prośbą o numer telefonu i przyciskiem Telegrama „Udostępnij numer telefonu” na klawiaturze odpowiedzi

Krok z telefonem: jedno pytanie, jeden przycisk, a numer wysyła sam Telegram.

Jeśli wolisz nie udostępniać numeru, nie rób nic: nic nie zostanie zapisane i po prostu nie będziesz zapisany na grę. Przy następnym ✅ Będę bot zapyta jeszcze raz.

Wszystkie komendy

Wszystkie sześć komend działa tylko w grupie. Bot nie ma menu komend na prywatnym czacie, a komenda napisana prywatnie nie dostaje żadnej odpowiedzi — prywatny czat jest od karty zapisu, zasad i numeru telefonu, a te bot zaczyna sam.

komendakto możeco odpowiada
/gameskażdy w podłączonej grupienajbliższe gry tutaj, do dziesięciu, każda linia linkuje do swojego postu.
/nextkażdy w podłączonej grupieprzeskakuje do postu najbliższej gry. Jeśli ta gra nie ma tu jeszcze postu, bot wysyła sam post.
/helpkażdy — jedyna komenda, która odpowiada też w grupie jeszcze niepodłączonejco robi bot, z linkami do aplikacji i strony.
/settingsadministratorzy grupyustawienia publikowania w tej grupie, jeden przycisk na każdego podłączonego organizatora. Bez Mini App odpowiada, gdzie te ustawienia są w aplikacji. Osoba bez praw administratora nie dostaje żadnej odpowiedzi.
/bindadministratorzy grupypodłącza organizatora albo klub do tej grupy.
/unbindadministratorzy grupy albo osoba, która podłączyła gryodłącza je.
Screenshot

Odpowiedź bota na /games: krótka lista najbliższych gier tej grupy, każda linia linkuje do swojego postu

`/games` w podłączonej grupie.

Bot odpowiada najwyżej raz na trzydzieści sekund na grupę i usuwa własną odpowiedź po dziesięciu minutach, więc /games w ruchliwej grupie nie zamienia się w drugą rozmowę.

Pytania

Co bot widzi w grupie?

W grupie bot patrzy na jedno pole wiadomości — jej tekst — i tylko po to, żeby sprawdzić, czy zaczyna się od jednej z sześciu komend. Wszystko inne przelatuje obok i nigdy nie jest czytane ponownie, zapisywane ani nikomu wysyłane. Treść wiadomości nie opuszcza Telegrama.

Do Amator idzie wąski zestaw: id grupy, jej typ i tytuł, id oraz status administratora osoby, która użyła komendy, a przy naciśnięciu przycisku — id tej osoby na Telegramie wraz z grą i wyborem. Imiona graczy w postach przychodzą z Amator już przefiltrowane pod kątem prywatności, a bot tylko przygotowuje je dla Telegrama.

Co, jeśli bot zostanie usunięty z grupy?

Posty, które już są w grupie, zostają, a bot przestaje je odświeżać. Nic nie jest usuwane i nic nie jest ogłaszane. Dodanie bota z powrotem i /bind uruchamia wszystko od nowa.

W jakich językach odpowiada?

W ośmiu: polskim, angielskim, ukraińskim, rosyjskim, czeskim, niemieckim, hiszpańskim i francuskim. Odpowiedź idzie po kolei za: językiem sesji zapisu, potem językiem profilu Amator, potem językiem Telegrama, jeśli jest jednym z ośmiu, a na końcu językiem grupy — a gdy nic z tego nie pasuje, angielskim.

Post w grupie jest zawsze w języku wybranym dla tego połączenia, a nie w języku każdego czytającego. Menu komend jest instalowane per język, więc każdy widzi je u siebie po swojemu.