Telegram bot
Tvoje hry ve stejné skupině, kde se stejně domlouváte. Bot zveřejní každou hru, drží sestavu v aktuálním stavu a dá odpovědět jedním klepnutím.
Skupinový bot ještě neběží na produkci. Zatím žije na dev stacku, takže jméno bota a odkazy z této stránky začnou fungovat teprve ve chvíli, kdy vznikne produkční bot.
K čemu to je
Hry organizátora z Amatoru se zveřejní ve skupině na Telegramu a hráči odpovídají ve skupině. Nikdo nepřepisuje sestavu, nikdo nepočítá odpovědi — sám post je odpověď na otázku „kdo jde v sobotu“.
Bot dělá tři věci:
- zveřejňuje každou novou hru organizátorů propojených se skupinou;
- drží každý post v aktuálním stavu — kdo hraje, kdo je v rezervě, kolik míst je volných;
- bere odpovědi ze tří tlačítek pod postem a zapisuje je rovnou do hry.
Všechno se děje ve skupině a v soukromém chatu bota. Jinam bot nepíše.
Pro organizátora
Přidej bota do skupiny
Přidej the Amator bot do skupiny na Telegramu stejně jako kohokoli jiného. Při příchodu bot nic nenapíše — tak to má být, aby neskočil do rozjeté konverzace.
Jestli chceš, aby byla aktuální hra připnutá, dej mu právo připínat zprávy. Bez toho práva prostě nikdy nepřipíná.
Pošli /bind
Pošli /bind ve skupině. Skupinu může propojit jen správce — bot se na tvůj status zeptá Telegramu v ten moment, místo aby věřil samotné zprávě.
Jestli je tvůj Telegram propojený s jedním účtem Amator a organizuješ sám, odpověď zní:
✅ Hotovo! Tvoje hry z Amatoru se budou zveřejňovat v této skupině.
Skupina na Telegramu, ve které bot odpoví na /bind jedním řádkem: „✅ Hotovo! Tvoje hry z Amatoru se budou zveřejňovat v této skupině.“
Jestli jsi k tomu kapitán klubu, bot se nejdřív zeptá — Čí hry se mají zveřejňovat v této skupině? — s tlačítkem na každou možnost: Moje hry a Klub {owner}. Klepnout může jen ten, kdo poslal /bind. Otázka se potom přepíše na odpověď, takže ve skupině zůstane jedna zpráva, ne tři.
Dvě odpovědi znamenají, že se nejdřív musí něco spravit:
| odpověď | co udělat |
|---|---|
| Nejdřív propoj svůj Telegram s Amatorem… | Otevři soukromý chat s botem a použij odkaz z aplikace: Profil → Nastavení → Propojené účty → Telegram. |
| Píšeš jako anonymní správce… | Vypni na chvíli anonymitu, nebo použij odkaz z aplikace. |
Hry začnou chodit
Od té chvíle se tu každá nová hra toho organizátora objeví pár sekund po vytvoření. Hru, která je už zrušená nebo odehraná, bot neohlásí nikdy.
Post řádek po řádku
⚽ Mokotów · 7×7
🗓 sobota 24. října · sraz 14:45 · hra 15:00–17:00
📍 Orlik Cieszyńska · Mokotów, Varšava
💰 15 zł za osobu
📶 Začátečník – Pokročilý
👤 Organizátor: Vlad
Hrají (4/12) · minimum 8
1. Vlad K.
2. Igor D.
3. Player
4. Guest (náhradník)
Rezerva (2)
1. Andrii F.
2. Tážū
Když se uvolní místo, první z rezervy jde do sestavy
Přemýšlí (2)
Nejdu (1)
⚠️ Ještě 4 do minima · volno 8
Pro přihlášení otevři bota a klepni na StartPost hry ve skupině na Telegramu: název a formát, datum se srazem a časem hry, místo, cena, úroveň, organizátor, a pod tím číslovaná sestava, rezerva a stavový řádek
| řádek | co to je |
|---|---|
| název | název hry a její formát. Přeškrtnutý, když je hra zrušená. |
| 🗓 | den, čas srazu a začátek a konec samotné hry. |
| 📍 | místo, část města a město. Vynechá se, dokud není místo veřejné. |
| 💰 | cena za osobu. Vynechá se, když je hra bez platby. |
| 📶 | úroveň, a když hra bere víc úrovní, rozsah. |
| 👤 | jméno organizátora. |
| Hrají (přijatí/maximum) | kdo je v sestavě, po řadě. · minimum N se přidá jen tehdy, když hra minimum má — a zmizí, když se minimum rovná maximu, protože pak nic neříká. Hráč s poznámkou (náhradník) zabírá místo pro hosta. |
| Rezerva (N) | fronta, když organizátor přijímá hráče automaticky. Kurzíva pod ní říká, že první z fronty jde na uvolněné místo. Při ručním přijímání tam místo toho stojí Žádosti (N). |
| Přemýšlí / Nejdu | dva seznamy odpovědí. Jména jsou vždycky složená do rozbalovací citace, i jedno, aby post zůstal krátký. Druhý seznam má v záhlaví slova samotného tlačítka ❌. |
| stavový řádek | ⚠️ Ještě N do minima pod minimem, ✅ Hra se odehraje od minima výš nebo Nábor hráčů, když minimum není — a za tím volno N. Plná, zavřená, zrušená nebo odehraná hra nahradí celý řádek svým: Místa obsazena · je rezerva, 🔒 Přihlašování uzavřeno., ❌ Hra zrušena, Hra se odehrála · hráčů: N. |
| řádek přihlášení | Pro přihlášení otevři bota a klepni na Start, kde je prostřední část odkaz. Jen dokud hra bere odpovědi a profil z Telegramu se smí vytvořit — viz přihlášení bez aplikace. |
Dlouhé seznamy se složí: nad osm jmen jde seznam do rozbalovací citace a nad čtyřicet se konec změní na … a další N. Jestli by byl post pro Telegram i tak moc dlouhý, bot seznamy zkrátí — nejdřív rezervu, „přemýšlí“ a „nejdu“, sestavu až nakonec.
Tlačítka
| tlačítko | co dělá |
|---|---|
| ✅ Jdu | odpoví „ano“. Je tam, dokud je hra otevřená nebo plná. |
| ❌ Nejdu | odpoví „ne“. |
| ⏳ Později | zapíše tě do „přemýšlí“, aby organizátor věděl, že jsi hru viděl. |
| 📋 Otevřít | otevře hru — v Mini Appu, když je nastavený, jinak stránku hry. Je tam vždycky. |
| 📅 Všechny hry | nejbližší hry téhle skupiny. Jen při nastaveném Mini Appu. |
Tři tlačítka odpovědi pod postem — „✅ Jdu“, „❌ Nejdu“, „⏳ Později“ — a pod nimi „📋 Otevřít“
Klepnutí na tlačítko nenapíše do skupiny žádnou zprávu. Mění se sám post, takže jedna hra zůstane jednou zprávou, i když odpoví dvanáct lidí.
Jak se post aktualizuje
Každá odpověď, každá změna hry a každá připomínka post aktualizují. Bot změny sbírá dohromady — asi pět sekund po poslední a nejpozději dvacet sekund po první — takže dvanáct lidí, kteří odpoví naráz, znamená jednu změnu, ne dvanáct. Když se v textu doopravdy nic nezměnilo, bot neudělá ani jeden dotaz.
Pár věcí přijde jako odpověď pod postem, ne jako změna v něm: jiný čas, jiné místo, připomínka den dopředu a — nejvýš raz za den — upozornění ještě chybí hráči s jedním tlačítkem ✅ Jdu.
Telegram omezuje, jak rychle smí bot v jednom chatu psát, takže bot drží jednu operaci za tři sekundy na skupinu. V nápor jdou změny do fronty, místo aby spadly.
Pravidla hry
Když organizátor ke hře přiložil pravidla, hráč po ✅ Jdu je dostane v soukromém chatu bota: řádek hry, Organizátor tě žádá o přijetí pravidel hry: a samotná pravidla v rozbalovací citaci. Poslední zpráva nese ✅ Přijímám a přihlašuji se a Teď ne. Dokud hráč nepřijme, nic se neukládá; a jestli se pravidla mezitím změnila, bot ukáže novou verzi, místo aby přijal starou.
Odpojení
/unbind ve skupině zveřejňování zastaví:
Hotovo. Hry se už v této skupině zveřejňovat nebudou.
Odpojit může jen správce skupiny nebo ten, kdo hry propojil. Posty, které tam už jsou, zůstanou na místě — bot je jen přestane aktualizovat.
Odebrání bota ze skupiny má stejný účinek a na odchod taky nic nenapíše.
Pro hráče
Abys odpověděl, nemusíš nic instalovat. Klepni pod postem na ✅ Jdu, ❌ Nejdu nebo ⏳ Později a sestava v postu se přepíše.
Změnit rozhodnutí je tentýž pohyb: klepni na jiné tlačítko. Post se změní a ve skupině se nic neohlašuje.
Přihlášení bez aplikace
Jestli tvůj Telegram není propojený s Amatorem, bot otevře soukromý chat a nabídne, že ti z účtu na Telegramu udělá profil — bez hesla. Karta ukazuje hru, uvítání a jeden řádek souhlasu:
Pokračováním souhlasíš s Podmínkami používání a Zásadami ochrany osobních údajů a potvrzuješ, že ti je aspoň 16 let.
Žádná zaškrtávátka nejsou. Odpovědí jsou tři tlačítka:
| tlačítko | co se stane |
|---|---|
| ✅ Souhlasím — přihlásit se | profil je vytvořený a tvoje odpověď zapsaná. Bot si zapíše, v jakém jazyce byla karta ukázaná a s jakým přesně textem jsi souhlasil. |
| Už mám účet Amator | nic se nevytváří. Bot vysvětlí, jak Telegram propojit v aplikaci — Profil → Nastavení → Propojené účty → Telegram — a tvoji odpověď podrží 24 hodin, takže se započítá hned po propojení. |
| Ještě mi není 16 | nic se nevytváří. Amator je dostupný od 16 let. Vrať se, až ti bude 16. |
Soukromý chat bota s kartou přihlášení: řádek hry, uvítání, věta souhlasu s dvěma odkazy a tři tlačítka pod ní
Krok s telefonním číslem
Některé hry potřebují ověřené telefonní číslo. Když chybí jen ono, bot to dokončí v soukromém chatu: zeptá se jednou a ukáže tlačítko Sdílet telefonní číslo.
Číslo musí přijít z toho tlačítka — Telegram ho pošle jako kontakt a musí být tvoje vlastní. Napsané rukou bot nebere. Jak je číslo ověřené, tvoje odpověď ze skupiny se ve stejném kroku započítá a klávesnice zmizí.
Soukromý chat bota s prosbou o telefonní číslo a tlačítkem Telegramu „Sdílet telefonní číslo“ na klávesnici odpovědí
Jestli číslo sdílet nechceš, nedělej nic: nic se neuloží a jen nebudeš přihlášený. Až příště klepneš na ✅ Jdu, bot se zeptá znovu.
Všechny příkazy
Všech šest příkazů funguje jen ve skupině. Soukromé menu příkazů bot nemá a příkaz napsaný v soukromém chatu nedostane žádnou odpověď — soukromý chat je na kartu přihlášení, pravidla a telefonní číslo, a ty si bot začíná sám.
| příkaz | kdo smí | co odpoví |
|---|---|---|
/games | kdokoli v propojené skupině | nejbližší hry tady, nejvýš deset, každý řádek vede na svůj post. |
/next | kdokoli v propojené skupině | skočí na post nejbližší hry. Jestli ta hra tady post ještě nemá, bot pošle rovnou ten post. |
/help | kdokoli — jediný příkaz, který odpoví i ve skupině, která ještě není propojená | co bot umí, s odkazy na aplikace a web. |
/settings | správci skupiny | nastavení zveřejňování pro tuto skupinu, jedno tlačítko na každého propojeného organizátora. Bez Mini Appu odpoví, kde to nastavení v aplikaci je. Kdo není správce, nedostane odpověď vůbec. |
/bind | správci skupiny | propojí organizátora nebo klub s touto skupinou. |
/unbind | správci skupiny nebo ten, kdo hry propojil | odpojí je. |
Odpověď bota na /games: krátký seznam nejbližších her téhle skupiny, každý řádek vede na svůj post
Bot odpoví nejvýš raz za třicet sekund na skupinu a vlastní odpověď po deseti minutách smaže, takže /games v rušné skupině se nezmění na druhou konverzaci.
Otázky
Co bot ve skupině vidí?
Ve skupině se bot dívá na jedno pole zprávy — její text — a jen proto, aby zjistil, jestli nezačíná jedním ze šesti příkazů. Všechno ostatní propadne a nikdy se znovu nečte, neukládá ani nikam neposílá. Obsah zpráv Telegram neopouští.
Do Amatoru jde úzká sada: id skupiny, její typ a název, id a status správce u toho, kdo příkaz poslal, a když někdo klepne na tlačítko, jeho Telegram id spolu s hrou a volbou. Jména hráčů v postech přicházejí z Amatoru už přefiltrovaná s ohledem na soukromí a bot je jen připraví pro Telegram.
A když bota ze skupiny vyhodí?
Posty, které ve skupině už jsou, zůstanou a bot je přestane aktualizovat. Nic se nemaže a nic se neohlašuje. Když bota přidáš zpátky a pošleš /bind, všechno se rozjede znovu.
V jakých jazycích odpovídá?
V osmi: česky, anglicky, polsky, ukrajinsky, rusky, německy, španělsky a francouzsky. Odpověď jde v tomto pořadí za jazykem přihlašovací session, pak za jazykem profilu Amator, pak za jazykem Telegramu, pokud je jedním z osmi, a nakonec za jazykem skupiny — a když nesedí nic, anglicky.
Post ve skupině je vždycky v jazyce, který je vybraný pro to propojení, ne v jazyce každého, kdo ho čte. Menu příkazů se instaluje pro každý jazyk zvlášť, takže každý ho vidí po svém.