Bot Telegram
Tes matchs dans le groupe où vous vous organisez déjà. Le bot publie chaque match, tient à jour la liste de ceux qui jouent et permet de répondre d’un seul geste.
Le bot de groupes n’est pas encore en production. Pour l’instant il tourne sur l’environnement de développement, donc le nom du bot et les liens de cette page ne fonctionneront qu’une fois le bot de production en place.
À quoi ça sert
Les matchs Amator d’un organisateur sont publiés dans le groupe Telegram, et les joueurs répondent dans le groupe. Personne ne recopie une liste, personne ne compte les réponses : la publication elle-même est la réponse à « qui vient samedi ».
Le bot fait trois choses :
- il publie chaque nouveau match des organisateurs connectés au groupe ;
- il tient chaque publication à jour — qui joue, qui est en réserve, combien de places restent ;
- il prend les réponses des trois boutons sous la publication et les écrit directement dans le match.
Tout se passe dans le groupe et dans le chat privé du bot. Il n’écrit nulle part ailleurs.
Pour les organisateurs
Ajoute le bot au groupe
Ajoute the Amator bot au groupe Telegram comme n’importe quel autre membre. En arrivant, le bot ne dit rien : c’est voulu, pour ne pas couper une conversation.
Si tu veux que le match en cours soit épinglé, donne-lui le droit d’épingler des messages. Sans ce droit, il n’épingle simplement jamais.
Envoie /bind
Envoie /bind dans le groupe. Seul un admin peut connecter le groupe : le bot demande ton statut à Telegram à cet instant, au lieu de croire le message.
Si ton Telegram est relié à un seul compte Amator et que tu organises seul, la réponse est :
✅ C’est fait ! Tes matchs Amator seront publiés dans ce groupe.
Un groupe Telegram où le bot répond à /bind par une seule ligne : « ✅ C’est fait ! Tes matchs Amator seront publiés dans ce groupe. »
Si tu es aussi capitaine d’un club, le bot demande d’abord — Les matchs de qui faut-il publier ici ? — avec un bouton par choix : Mes matchs et Club {owner}. Seule la personne qui a envoyé /bind peut appuyer. La question est ensuite réécrite en réponse, si bien qu’il reste un message dans le groupe et non trois.
Deux réponses veulent dire qu’il y a d’abord quelque chose à régler :
| réponse | quoi faire |
|---|---|
| Relie d’abord ton Telegram à Amator… | Ouvre le chat privé avec le bot et suis le lien de l’app : Profil → Réglages → Comptes connectés → Telegram. |
| Tu écris en tant qu’admin anonyme… | Désactive l’anonymat un instant ou utilise le lien de l’app. |
Les matchs commencent à arriver
À partir de là, chaque nouveau match de cet organisateur apparaît ici quelques secondes après sa création. Un match déjà annulé ou déjà joué n’est jamais annoncé.
La publication, ligne par ligne
⚽ Mokotów · 7×7
🗓 samedi 24 octobre · rendez-vous 14:45 · match 15:00–17:00
📍 Orlik Cieszyńska · Mokotów, Varsovie
💰 15 zł par personne
📶 Débutant – Confirmé
👤 Organisateur : Vlad
Jouent (4/12) · minimum 8
1. Vlad K.
2. Igor D.
3. Player
4. Guest (remplaçant)
Réserve (2)
1. Andrii F.
2. Tážū
Quand une place se libère, le premier de la réserve passe dans l’équipe
Hésitent (2)
Je ne viens pas (1)
⚠️ Encore 4 pour le minimum · libres : 8
Pour t’inscrire, ouvre le bot et appuie sur StartUne publication de match dans un groupe Telegram : titre et format, date avec le rendez-vous et l’heure de jeu, terrain, prix, niveau, organisateur, puis la composition numérotée, la réserve et la ligne d’état
| ligne | ce que c’est |
|---|---|
| titre | le nom du match et son format. Barré quand le match est annulé. |
| 🗓 | le jour, l’heure du rendez-vous et le début et la fin du match. |
| 📍 | terrain, quartier et ville. Omis tant que le lieu n’est pas public. |
| 💰 | le prix par personne. Omis s’il n’y en a pas. |
| 📶 | le niveau, ou la fourchette quand le match en accepte plusieurs. |
| 👤 | le prénom de l’organisateur. |
| Jouent (acceptés/maximum) | qui est dedans, dans l’ordre. · minimum N n’est ajouté que si le match a un minimum — et disparaît quand le minimum égale le maximum, parce qu’il ne dit alors rien. Un joueur marqué (remplaçant) occupe une place d’invité. |
| Réserve (N) | la file, quand l’organisateur accepte les joueurs automatiquement. La ligne en italique en dessous explique que le premier de la file prend la prochaine place libre. Avec une acceptation manuelle, on lit Demandes (N) à la place. |
| Hésitent / Je ne viens pas | les deux listes de réponses. Les prénoms sont toujours pliés dans une citation dépliable, même un seul, pour que la publication reste courte. La seconde liste porte en titre les mots du bouton ❌ lui-même. |
| ligne d’état | ⚠️ Encore N pour le minimum sous le minimum, ✅ Le match aura lieu à partir du minimum, ou Recherche de joueurs quand il n’y a pas de minimum — suivi de libres : N. Un match complet, fermé, annulé ou déjà joué remplace toute la ligne par la sienne : Complet · réserve ouverte, 🔒 Inscriptions closes., ❌ Match annulé, Le match a eu lieu · joueurs : N. |
| ligne d’inscription | Pour t’inscrire, ouvre le bot et appuie sur Start, où le milieu est le lien. Seulement tant que le match accepte des réponses et qu’un profil peut être créé depuis Telegram — voir s’inscrire sans l’app. |
Les listes longues se plient : au-delà de huit prénoms la liste passe dans une citation dépliable, et au-delà de quarante la fin devient … et N de plus. Si la publication reste trop longue pour Telegram, le bot raccourcit les listes — d’abord la réserve, les hésitants et les absents, la composition en dernier.
Les boutons
| bouton | ce qu’il fait |
|---|---|
| ✅ Je viens | répond oui. Présent tant que le match est ouvert ou complet. |
| ❌ Je ne viens pas | répond non. |
| ⏳ Plus tard | te met dans « hésitent », pour que l’organisateur sache que tu as vu. |
| 📋 Ouvrir | ouvre le match — dans la Mini App si elle est configurée, sinon la page du match. Toujours présent. |
| 📅 Tous les matchs | les prochains matchs de ce groupe. Seulement avec une Mini App configurée. |
Les trois boutons de réponse sous une publication — « ✅ Je viens », « ❌ Je ne viens pas », « ⏳ Plus tard » — et en dessous « 📋 Ouvrir »
Appuyer sur un bouton n’écrit aucun message dans le groupe. C’est la publication qui est modifiée, si bien qu’un match reste un message, quel que soit le nombre de réponses.
Comment la publication se met à jour
Chaque réponse, chaque changement du match et chaque rappel mettent la publication à jour. Le bot regroupe les changements — environ cinq secondes après le dernier, et jamais plus de vingt secondes après le premier — si bien que douze personnes qui répondent en même temps donnent une modification et non douze. Si le texte n’a vraiment pas changé, il ne fait aucun appel.
Quelques choses arrivent en réponse sous la publication plutôt qu’en modification : un nouvel horaire, un nouveau lieu, le rappel de la veille et — au plus une fois par jour — une alerte joueurs encore nécessaires avec un seul bouton ✅ Je viens.
Telegram limite la vitesse à laquelle un bot peut écrire dans un chat, donc le bot s’en tient à une opération toutes les trois secondes par groupe. En cas d’afflux, les modifications attendent en file au lieu d’échouer.
Les règles du match
Si l’organisateur a joint des règles au match, le joueur qui appuie sur ✅ Je viens les reçoit dans le chat privé du bot : la ligne du match, L’organisateur te demande d’accepter les règles du match : et les règles elles-mêmes dans une citation dépliable. Le dernier message porte ✅ J’accepte et je m’inscris et Pas maintenant. Rien n’est enregistré avant l’acceptation ; et si les règles changent entre-temps, le bot montre la nouvelle version au lieu d’accepter l’ancienne.
Déconnecter
/unbind dans le groupe arrête les publications :
C’est fait. Les matchs ne seront plus publiés dans ce groupe.
Seul un admin du groupe, ou la personne qui a connecté les matchs, peut les déconnecter. Les publications déjà là restent où elles sont — le bot cesse simplement de les modifier.
Retirer le bot du groupe a le même effet, et là encore il ne dit rien en partant.
Pour les joueurs
Pour répondre, tu n’as rien à installer. Appuie sur ✅ Je viens, ❌ Je ne viens pas ou ⏳ Plus tard sous la publication, et la liste se met à jour.
Changer d’avis est le même geste : appuie sur un autre bouton. La publication est modifiée, et rien n’est annoncé dans le groupe.
S’inscrire sans l’app
Si ton Telegram n’est pas relié à Amator, le bot ouvre son chat privé et propose de créer un profil à partir de ton compte Telegram, sans mot de passe. La carte montre le match, un bonjour et une ligne de consentement :
En continuant, tu acceptes les Conditions d’utilisation et la Politique de confidentialité et tu confirmes avoir au moins 16 ans.
Il n’y a aucune case à cocher. La réponse, ce sont trois boutons :
| bouton | ce qui se passe |
|---|---|
| ✅ J’accepte — m’inscrire | le profil est créé et ta réponse est appliquée. Le bot note dans quelle langue la carte a été montrée et le texte exact que tu as accepté. |
| J’ai déjà un compte Amator | rien n’est créé. Le bot explique comment associer Telegram dans l’app — Profil → Réglages → Comptes connectés → Telegram — et garde ta réponse 24 heures, pour qu’elle compte dès l’association. |
| Je n’ai pas encore 16 ans | rien n’est créé. Amator est accessible à partir de 16 ans. Reviens quand tu auras 16 ans. |
Le chat privé du bot avec la carte d’inscription : la ligne du match, un bonjour, la phrase de consentement avec ses deux liens et les trois boutons en dessous
L’étape du téléphone
Certains matchs demandent un numéro de téléphone vérifié. Quand il ne manque que ça, le bot termine dans le chat privé : il demande une fois et montre le bouton Partager le numéro de téléphone.
Le numéro doit venir de ce bouton — Telegram l’envoie comme contact, et il doit être le tien. Tapé à la main, le bot ne l’accepte pas. Dès qu’il est vérifié, la réponse donnée dans le groupe est appliquée dans la même étape, et le clavier disparaît.
Le chat privé du bot demandant un numéro de téléphone, avec le bouton de Telegram « Partager le numéro de téléphone » sur le clavier de réponse
Si tu préfères ne pas le partager, ne fais rien : rien n’est enregistré et tu n’es simplement pas inscrit. La prochaine fois que tu appuies sur ✅ Je viens, le bot redemande.
Toutes les commandes
Les six commandes fonctionnent uniquement dans un groupe. Le bot n’a pas de menu de commandes en privé, et une commande tapée dans le chat privé n’obtient aucune réponse : le chat privé sert à la carte d’inscription, aux règles et au téléphone, et c’est le bot qui les lance.
| commande | qui peut | ce qu’elle répond |
|---|---|---|
/games | n’importe qui dans un groupe connecté | les prochains matchs ici, jusqu’à dix, chaque ligne menant à sa publication. |
/next | n’importe qui dans un groupe connecté | saute à la publication du prochain match. Si ce match n’a pas encore de publication ici, le bot envoie la publication. |
/help | n’importe qui — la seule commande qui répond aussi dans un groupe pas encore connecté | ce que fait le bot, avec les liens vers les apps et le site. |
/settings | admins du groupe | les réglages de publication de ce groupe, un bouton par organisateur connecté. Sans Mini App, il répond où les trouver dans l’app. Qui n’est pas admin n’obtient aucune réponse. |
/bind | admins du groupe | connecte un organisateur ou un club à ce groupe. |
/unbind | admins du groupe, ou la personne qui a connecté les matchs | les déconnecte. |
La réponse du bot à /games : une courte liste des prochains matchs de ce groupe, chaque ligne menant à sa publication
Le bot répond au plus une fois toutes les trente secondes par groupe et supprime sa propre réponse au bout de dix minutes, pour que /games dans un groupe animé ne devienne pas une seconde conversation.
Questions
Que voit le bot dans le groupe ?
Dans un groupe, le bot regarde un seul champ d’un message — son texte — et seulement pour voir s’il commence par l’une des six commandes. Tout le reste passe et n’est jamais relu, ni enregistré, ni envoyé ailleurs. Le contenu des messages ne quitte pas Telegram.
Ce qui part vers Amator est étroit : l’id du groupe, son type et son titre, l’id et le statut d’admin de la personne qui a lancé une commande et, quand quelqu’un appuie sur un bouton, son id Telegram avec le match et le choix. Les prénoms des joueurs dans les publications arrivent d’Amator déjà filtrés pour la confidentialité ; le bot ne fait que les préparer pour Telegram.
Et si le bot est retiré du groupe ?
Les publications déjà dans le groupe restent, et le bot cesse de les modifier. Rien n’est supprimé et rien n’est annoncé. Si tu le rajoutes et envoies /bind, tout repart.
Dans quelles langues répond-il ?
Dans huit : français, anglais, polonais, ukrainien, russe, tchèque, allemand et espagnol. Une réponse suit, dans cet ordre, la langue de la session d’inscription, puis celle de ton profil Amator, puis celle de ton Telegram si elle fait partie des huit, puis celle du groupe — et l’anglais si rien ne correspond.
Une publication de groupe est toujours écrite dans la langue choisie pour cette connexion, pas dans celle de chaque lecteur. Le menu de commandes est installé par langue, donc chacun le voit dans la sienne.