amator.app
Public API + n8n

Telegram-Bot

Deine Spiele in der Gruppe, in der ihr euch sowieso absprecht. Der Bot postet jedes Spiel, hält die Aufstellung aktuell und lässt die Leute mit einem Tipp antworten.

Der Gruppen-Bot läuft noch nicht in der Produktion. Vorläufig lebt er auf dem Dev-Stack, deshalb funktionieren der Bot-Name und die Links auf dieser Seite erst, wenn es den Produktions-Bot gibt.

Wofür das gut ist

Die Amator-Spiele eines Organisators landen in der Telegram-Gruppe, und die Spieler antworten in der Gruppe. Niemand tippt eine Liste ab, niemand zählt Antworten — der Post selbst ist die Antwort auf „wer kommt am Samstag“.

Der Bot macht drei Dinge:

  • er postet jedes neue Spiel der Organisatoren, die mit der Gruppe verbunden sind;
  • er hält jeden Post aktuell — wer dabei ist, wer in der Reserve steht, wie viele Plätze frei sind;
  • er nimmt die Antworten der drei Tasten unter dem Post und schreibt sie direkt ins Spiel.

Alles passiert in der Gruppe und im privaten Chat des Bots. Woanders schreibt er nicht.

Für Organisatoren

Füge den Bot zur Gruppe hinzu

Füge the Amator bot der Telegram-Gruppe hinzu wie jedes andere Mitglied. Beim Eintreten sagt der Bot nichts — das ist Absicht, damit er nicht in ein laufendes Gespräch platzt.

Wenn das aktuelle Spiel angepinnt sein soll, gib ihm das Recht, Nachrichten anzupinnen. Ohne dieses Recht pinnt er einfach nie etwas an.

Schicke /bind

Schicke /bind in der Gruppe. Verbinden darf nur ein Gruppenadmin — der Bot fragt Telegram in diesem Moment nach deinem Status, statt der Nachricht selbst zu glauben.

Wenn dein Telegram mit genau einem Amator-Konto verknüpft ist und du allein organisierst, lautet die Antwort:

✅ Fertig! Deine Amator-Spiele werden in dieser Gruppe gepostet.

Screenshot

Eine Telegram-Gruppe, in der der Bot auf /bind mit einer Zeile antwortet: „✅ Fertig! Deine Amator-Spiele werden in dieser Gruppe gepostet.“

Was die Gruppe nach `/bind` sieht — eine kurze Bestätigung, sonst nichts.

Bist du außerdem Kapitän eines Vereins, fragt der Bot erst — Wessen Spiele sollen hier gepostet werden? — mit einer Taste pro Möglichkeit: Meine Spiele und Verein {owner}. Drücken darf nur, wer /bind geschickt hat. Die Frage wird danach zur Antwort umgeschrieben, sodass in der Gruppe eine Nachricht stehen bleibt und nicht drei.

Zwei Antworten heißen, dass erst etwas zu erledigen ist:

Antwortwas zu tun ist
Verknüpfe zuerst dein Telegram mit Amator…Öffne den privaten Chat mit dem Bot und folge dem Link aus der App: Profil → Einstellungen → Verbundene Konten → Telegram.
Du schreibst als anonymer Admin…Schalte die Anonymität kurz aus oder nutze den Link aus der App.

Die Spiele kommen an

Von da an erscheint jedes neue Spiel dieses Organisators hier, Sekunden nachdem es angelegt wurde. Ein Spiel, das schon abgesagt oder vorbei ist, wird nie angekündigt.

Der Post, Zeile für Zeile

⚽ Mokotów · 7×7
🗓 Samstag, 24. Oktober · Treffen 14:45 · Spiel 15:00–17:00
📍 Orlik Cieszyńska · Mokotów, Warschau
💰 15 zł pro Person
📶 Anfänger – Erfahren
👤 Organisator: Vlad

Dabei (4/12) · Minimum 8
1. Vlad K.
2. Igor D.
3. Player
4. Guest (Bank)
Reserve (2)
1. Andrii F.
2. Tážū
Wird ein Platz frei, rückt der Erste aus der Reserve nach
Überlegen noch (2)
Bin raus (1)

⚠️ Noch 4 bis zum Minimum · frei: 8
Zum Anmelden öffne den Bot und tippe auf Start
Screenshot

Ein Spiel-Post in einer Telegram-Gruppe: Titel und Format, Datum mit Treffen und Spielzeit, Platz, Preis, Niveau, Organisator, darunter die nummerierte Aufstellung, die Reserve und die Statuszeile

Derselbe Post in einer echten Gruppe, mit den Antwort-Tasten darunter.
Zeilewas sie ist
TitelName und Format des Spiels. Durchgestrichen, wenn das Spiel abgesagt ist.
🗓der Tag, die Treffenzeit und Anfang und Ende des Spiels selbst.
📍Platz, Stadtteil und Stadt. Fällt weg, solange der Ort nicht öffentlich ist.
💰der Preis pro Person. Fällt weg, wenn es keinen gibt.
📶das Niveau, oder die Spanne, wenn das Spiel mehrere annimmt.
👤der Vorname des Organisators.
Dabei (angenommen/Maximum)wer dabei ist, der Reihe nach. · Minimum N kommt nur dazu, wenn das Spiel ein Minimum hat — und fällt weg, wenn Minimum und Maximum gleich sind, weil es dann nichts sagt. Ein Spieler mit (Bank) sitzt auf einem Gastplatz.
Reserve (N)die Warteschlange, wenn der Organisator automatisch annimmt. Die Kursivzeile darunter sagt, dass der Erste aus der Schlange auf den nächsten freien Platz rückt. Bei Annahme von Hand steht dort stattdessen Anfragen (N).
Überlegen noch / Bin rausdie zwei Antwortlisten. Namen stecken immer in einem aufklappbaren Zitat, auch ein einzelner, damit der Post kurz bleibt. Die zweite Liste trägt die Worte der ❌-Taste selbst.
Statuszeile⚠️ Noch N bis zum Minimum unter dem Minimum, ✅ Das Spiel findet statt ab dem Minimum oder Spieler gesucht, wenn es keines gibt — dahinter frei: N. Ein volles, geschlossenes, abgesagtes oder gespieltes Spiel ersetzt die ganze Zeile durch seine eigene: Keine Plätze frei · Reserve offen, 🔒 Anmeldung geschlossen., ❌ Spiel abgesagt, Das Spiel hat stattgefunden · Spieler: N.
AnmeldezeileZum Anmelden öffne den Bot und tippe auf Start, wobei die Mitte der Link ist. Nur solange das Spiel Antworten annimmt und ein Profil aus Telegram angelegt werden darf — siehe Mitspielen ohne App.

Lange Listen klappen ein: über acht Namen wandert die Liste in ein aufklappbares Zitat, und über vierzig wird der Rest zu … und N weitere. Wäre der Post für Telegram trotzdem zu lang, kürzt der Bot die Listen — zuerst Reserve, „überlegen noch“ und „bin raus“, die Aufstellung zuletzt.

Die Tasten

Tastewas sie tut
✅ Bin dabeiantwortet mit Ja. Da, solange das Spiel offen oder voll ist.
❌ Bin rausantwortet mit Nein.
⏳ Spätersetzt dich auf „überlegen noch“, damit der Organisator weiß, dass du es gesehen hast.
📋 Öffnenöffnet das Spiel — in der Mini App, wenn eine eingerichtet ist, sonst die Spielseite. Immer da.
📅 Alle Spieledie nächsten Spiele dieser Gruppe. Nur mit eingerichteter Mini App.
Screenshot

Die drei Antwort-Tasten unter einem Post — „✅ Bin dabei“, „❌ Bin raus“, „⏳ Später“ — und darunter „📋 Öffnen“

Die Tasten unter dem Post. Ein Druck ändert den Post und schreibt nie eine Nachricht in die Gruppe.

Ein Tastendruck schreibt keine Nachricht in die Gruppe. Stattdessen wird der Post geändert, sodass ein Spiel eine Nachricht bleibt, egal wie viele antworten.

Wie der Post aktualisiert wird

Jede Antwort, jede Änderung am Spiel und jede Erinnerung aktualisieren den Post. Der Bot fasst Änderungen zusammen — etwa fünf Sekunden nach der letzten und nie später als zwanzig Sekunden nach der ersten — sodass zwölf gleichzeitige Antworten eine Änderung ergeben und nicht zwölf. Hat sich im Text wirklich nichts geändert, macht er gar keinen Aufruf.

Ein paar Dinge kommen als Antwort unter dem Post und nicht als Änderung darin: eine neue Zeit, ein neuer Ort, die Erinnerung am Vortag und — höchstens einmal am Tag — ein Hinweis noch gesuchte Spieler mit einer einzigen Taste ✅ Bin dabei.

Telegram begrenzt, wie schnell ein Bot in einem Chat schreiben darf, deshalb hält er sich an eine Operation pro drei Sekunden und Gruppe. Im Ansturm warten Änderungen in der Schlange, statt zu scheitern.

Spielregeln

Hat der Organisator Regeln an das Spiel gehängt, bekommt ein Spieler sie nach ✅ Bin dabei im privaten Chat des Bots: die Spielzeile, Der Organisator bittet dich, die Spielregeln zu akzeptieren: und die Regeln selbst in einem aufklappbaren Zitat. Die letzte Nachricht trägt ✅ Ich akzeptiere und melde mich an und Nicht jetzt. Bis zum Akzeptieren wird nichts gespeichert; und ändern sich die Regeln dazwischen, zeigt der Bot die neue Fassung, statt die alte anzunehmen.

Trennen

/unbind in der Gruppe stoppt die Posts:

Fertig. In dieser Gruppe werden keine Spiele mehr gepostet.

Trennen kann nur ein Gruppenadmin oder die Person, die die Spiele verbunden hat. Posts, die schon da sind, bleiben stehen — der Bot hört nur auf, sie zu ändern.

Den Bot aus der Gruppe zu entfernen hat denselben Effekt, und auch zum Abschied sagt er nichts.

Für Spieler

Zum Antworten musst du nichts installieren. Tippe unter dem Post auf ✅ Bin dabei, ❌ Bin raus oder ⏳ Später, und die Liste im Post wird neu geschrieben.

Es sich anders überlegen ist dieselbe Bewegung: tippe eine andere Taste. Der Post wird geändert, und in der Gruppe wird nichts verkündet.

Mitspielen ohne App

Ist dein Telegram nicht mit Amator verknüpft, öffnet der Bot seinen privaten Chat und bietet an, aus deinem Telegram-Konto ein Profil zu machen — ohne Passwort. Die Karte zeigt das Spiel, eine Begrüßung und eine Zeile Einwilligung:

Wenn du fortfährst, stimmst du den Nutzungsbedingungen und der Datenschutzerklärung zu und bestätigst, dass du mindestens 16 Jahre alt bist.

Häkchen gibt es nicht. Die Antwort sind drei Tasten:

Tastewas passiert
✅ Einverstanden — anmeldendas Profil wird erstellt und deine Antwort übernommen. Der Bot hält fest, in welcher Sprache die Karte gezeigt wurde und welchem Text genau du zugestimmt hast.
Ich habe schon ein Amator-Kontoes wird nichts erstellt. Der Bot erklärt, wie man Telegram in der App verknüpft — Profil → Einstellungen → Verbundene Konten → Telegram — und hält deine Antwort 24 Stunden, sodass sie direkt nach dem Verknüpfen zählt.
Ich bin noch keine 16es wird nichts erstellt. Amator gibt es ab 16 Jahren. Komm wieder, wenn du 16 bist.
Screenshot

Der private Chat des Bots mit der Anmeldekarte: die Spielzeile, eine Begrüßung, der Einwilligungssatz mit seinen zwei Links und die drei Tasten darunter

Die Karte im privaten Chat des Bots — für Spieler, deren Telegram noch nicht mit Amator verknüpft ist.

Der Schritt mit der Telefonnummer

Manche Spiele brauchen eine bestätigte Telefonnummer. Wenn nur sie fehlt, erledigt der Bot das im privaten Chat: er fragt einmal und zeigt die Taste Telefonnummer teilen.

Die Nummer muss über diese Taste kommen — Telegram schickt sie als Kontakt, und es muss deine eigene sein. Eine getippte Nummer nimmt der Bot nicht. Sobald sie bestätigt ist, wird deine Antwort aus der Gruppe im selben Schritt übernommen, und die Tastatur verschwindet.

Screenshot

Der private Chat des Bots, der nach einer Telefonnummer fragt, mit Telegrams eigener Taste „Telefonnummer teilen“ auf der Antworttastatur

Der Telefonschritt: eine Frage, eine Taste, und die Nummer schickt Telegram selbst.

Willst du sie nicht teilen, tu nichts: es wird nichts gespeichert, und du bist einfach nicht angemeldet. Beim nächsten ✅ Bin dabei fragt der Bot wieder.

Alle Befehle

Alle sechs Befehle funktionieren nur in einer Gruppe. Im privaten Chat hat der Bot kein Befehlsmenü, und ein dort getippter Befehl bekommt überhaupt keine Antwort — der private Chat ist für die Anmeldekarte, die Regeln und die Telefonnummer, und die beginnt der Bot selbst.

Befehlwer darfwas er antwortet
/gamesjeder in einer verbundenen Gruppedie nächsten Spiele hier, bis zu zehn, jede Zeile verlinkt ihren eigenen Post.
/nextjeder in einer verbundenen Gruppespringt zum Post des nächsten Spiels. Hat dieses Spiel hier noch keinen Post, schickt der Bot den Post selbst.
/helpjeder — der einzige Befehl, der auch in einer noch nicht verbundenen Gruppe antwortetwas der Bot tut, mit Links zu den Apps und zur Website.
/settingsGruppenadminsdie Post-Einstellungen dieser Gruppe, eine Taste pro verbundenem Organisator. Ohne Mini App antwortet er, wo sie in der App stehen. Wer kein Admin ist, bekommt gar keine Antwort.
/bindGruppenadminsverbindet einen Organisator oder einen Verein mit dieser Gruppe.
/unbindGruppenadmins, oder wer die Spiele verbunden hattrennt sie wieder.
Screenshot

Die Antwort des Bots auf /games: eine kurze Liste der nächsten Spiele dieser Gruppe, jede Zeile verlinkt ihren eigenen Post

`/games` in einer verbundenen Gruppe.

Der Bot antwortet höchstens alle dreißig Sekunden pro Gruppe und löscht seine eigene Antwort nach zehn Minuten, damit /games in einer lebhaften Gruppe nicht zum zweiten Gespräch wird.

Fragen

Was sieht der Bot in der Gruppe?

In einer Gruppe schaut der Bot auf ein Feld einer Nachricht — ihren Text — und nur, um zu sehen, ob sie mit einem der sechs Befehle beginnt. Alles andere fällt durch und wird nie wieder gelesen, nicht gespeichert und nirgendwohin geschickt. Nachrichteninhalte verlassen Telegram nicht.

Was zu Amator geht, ist schmal: die Id, der Typ und der Titel der Gruppe, die Id und der Adminstatus der Person, die einen Befehl ausgeführt hat, und bei einem Tastendruck deren Telegram-Id samt Spiel und Wahl. Spielernamen in Posts kommen schon datenschutzgefiltert aus Amator; der Bot bereitet sie nur für Telegram auf.

Was, wenn der Bot aus der Gruppe entfernt wird?

Posts, die schon in der Gruppe stehen, bleiben, und der Bot hört auf, sie zu ändern. Nichts wird gelöscht und nichts verkündet. Fügst du ihn wieder hinzu und schickst /bind, läuft alles wieder an.

In welchen Sprachen antwortet er?

In acht: Deutsch, Englisch, Polnisch, Ukrainisch, Russisch, Tschechisch, Spanisch und Französisch. Eine Antwort folgt in dieser Reihenfolge der Sprache der Anmeldesitzung, dann der Sprache deines Amator-Profils, dann deiner Telegram-Sprache, wenn sie eine der acht ist, dann der Sprache der Gruppe — und Englisch, wenn nichts davon passt.

Ein Post in der Gruppe steht immer in der Sprache, die für diese Verbindung gewählt wurde, nicht in der jedes Lesers. Das Befehlsmenü wird pro Sprache installiert, sodass jeder es in seiner sieht.