amator.app
API pública + n8n

Bot de Telegram

Tus partidos en el mismo grupo donde ya os organizáis. El bot publica cada partido, mantiene la lista de quién juega al día y deja responder con un toque.

El bot de grupos todavía no está en producción. Por ahora vive en el entorno de desarrollo, así que el nombre del bot y los enlaces de esta página no funcionarán hasta que exista el bot de producción.

Para qué sirve

Los partidos de un organizador en Amator se publican en el grupo de Telegram y los jugadores responden en el grupo. Nadie copia una lista, nadie cuenta respuestas: la publicación misma es la respuesta a «quién viene el sábado».

El bot hace tres cosas:

  • publica cada partido nuevo de los organizadores conectados al grupo;
  • mantiene cada publicación al día: quién juega, quién está en la reserva, cuántas plazas quedan;
  • recoge las respuestas de los tres botones y las escribe directamente en el partido.

Todo pasa en el grupo y en el chat privado del bot. En ningún otro sitio escribe.

Para organizadores

Añade el bot al grupo

Añade the Amator bot al grupo de Telegram como a cualquier otro miembro. Al entrar no dice nada: es a propósito, para no cortar una conversación.

Si quieres que el partido en curso quede fijado, dale permiso para fijar mensajes. Sin ese permiso simplemente nunca fija nada.

Envía /bind

Envía /bind en el grupo. Solo un administrador puede conectar el grupo: el bot le pregunta a Telegram por tu estado en ese momento, en vez de creerse el mensaje.

Si tu Telegram está vinculado a una sola cuenta de Amator y organizas tú solo, la respuesta es:

✅ ¡Listo! Tus partidos de Amator se publicarán en este grupo.

Screenshot

Un grupo de Telegram en el que el bot responde a /bind con una línea: «✅ ¡Listo! Tus partidos de Amator se publicarán en este grupo.»

Lo que ve el grupo después de `/bind`: una confirmación corta y nada más.

Si además eres capitán de un club, el bot pregunta primero — ¿De quién son los partidos que se publicarán aquí? — con un botón por opción: Mis partidos y Club {owner}. Solo puede pulsar quien envió /bind. Después la pregunta se reescribe como respuesta, así que en el grupo queda un mensaje y no tres.

Dos respuestas significan que antes hay algo que arreglar:

respuestaqué hacer
Primero vincula tu Telegram con Amator…Abre el chat privado con el bot y sigue el enlace de la app: Perfil → Ajustes → Cuentas conectadas → Telegram.
Escribes como administrador anónimo…Desactiva el anonimato un momento o usa el enlace de la app.

Los partidos empiezan a llegar

Desde ese momento, cada partido nuevo de ese organizador aparece aquí a los pocos segundos de crearse. Un partido ya cancelado o ya jugado nunca se anuncia.

La publicación, línea a línea

⚽ Mokotów · 7×7
🗓 sábado, 24 de octubre · quedada 14:45 · partido 15:00–17:00
📍 Orlik Cieszyńska · Mokotów, Varsovia
💰 15 zł por persona
📶 Principiante – Avanzado
👤 Organizador: Vlad

Juegan (4/12) · mínimo 8
1. Vlad K.
2. Igor D.
3. Player
4. Guest (banquillo)
Reserva (2)
1. Andrii F.
2. Tážū
Cuando se libere una plaza, el primero de la reserva pasa a jugar
Lo están pensando (2)
No voy (1)

⚠️ Faltan 4 para el mínimo · libres: 8
Para apuntarte, abre el bot y pulsa Start
Screenshot

Una publicación de partido en un grupo de Telegram: título y formato, fecha con la quedada y la hora de juego, instalación, precio, nivel, organizador y, debajo, la alineación numerada, la reserva y la línea de estado

La misma publicación en un grupo real, con los botones de respuesta debajo.
líneaqué es
títuloel nombre del partido y su formato. Tachado cuando el partido está cancelado.
🗓el día, la hora de la quedada y el inicio y el fin del partido.
📍instalación, barrio y ciudad. Se omite mientras el lugar no sea público.
💰el precio por persona. Se omite si no hay.
📶el nivel, o el rango cuando el partido acepta varios.
👤el nombre del organizador.
Juegan (aceptados/máximo)quién está dentro, por orden. · mínimo N solo se añade cuando el partido tiene mínimo, y desaparece cuando el mínimo es igual al máximo, porque entonces no dice nada. Un jugador marcado como (banquillo) ocupa una plaza de invitado.
Reserva (N)la cola, cuando el organizador acepta jugadores automáticamente. La línea en cursiva de debajo explica que el primero de la cola entra en la siguiente plaza libre. Con aceptación manual ahí dice Solicitudes (N).
Lo están pensando / No voylas dos listas de respuestas. Los nombres van siempre plegados en una cita desplegable, aunque sea uno solo, para que la publicación quede corta. La segunda lista lleva en el encabezado las palabras del propio botón ❌.
línea de estado⚠️ Faltan N para el mínimo por debajo del mínimo, ✅ El partido se juega desde el mínimo, o Buscando jugadores cuando no hay mínimo, y detrás libres: N. Un partido completo, cerrado, cancelado o ya jugado sustituye toda la línea por la suya: Sin plazas · hay reserva, 🔒 Inscripción cerrada., ❌ Partido cancelado, El partido se jugó · jugadores: N.
línea de inscripciónPara apuntarte, abre el bot y pulsa Start, donde el centro es el enlace. Solo mientras el partido acepte respuestas y se pueda crear un perfil desde Telegram: ver apuntarse sin la app.

Las listas largas se pliegan: a partir de ocho nombres la lista pasa a una cita desplegable, y a partir de cuarenta la cola se convierte en … y N más. Si la publicación aún resulta demasiado larga para Telegram, el bot recorta las listas: primero la reserva, los que lo están pensando y los que no van; la alineación, al final.

Los botones

botónqué hace
✅ Voyresponde que sí. Está mientras el partido esté abierto o completo.
❌ No voyresponde que no.
⏳ Más tardete pone en «lo están pensando», para que el organizador sepa que lo has visto.
📋 Abrirabre el partido: en la Mini App si está configurada y, si no, su página en la web. Está siempre.
📅 Todos los partidoslos próximos partidos de este grupo. Solo con una Mini App configurada.
Screenshot

Los tres botones de respuesta bajo una publicación — «✅ Voy», «❌ No voy», «⏳ Más tarde» — y debajo «📋 Abrir»

Los botones bajo la publicación. Pulsar uno edita la publicación; nunca añade un mensaje al grupo.

Pulsar un botón no escribe ningún mensaje en el grupo. Se edita la propia publicación, así que un partido sigue siendo un mensaje por mucha gente que responda.

Cómo se actualiza la publicación

Cada respuesta, cada cambio en el partido y cada recordatorio actualizan la publicación. El bot agrupa los cambios —unos cinco segundos después del último y nunca más de veinte segundos después del primero—, así que doce personas respondiendo a la vez producen una edición y no doce. Si el texto no ha cambiado de verdad, no hace ninguna llamada.

Algunas cosas llegan como respuesta debajo de la publicación y no como edición: otra hora, otro lugar, el recordatorio del día antes y —como mucho una vez al día— un aviso de faltan jugadores con un único botón ✅ Voy.

Telegram limita la velocidad a la que un bot puede escribir en un chat, así que el bot se queda en una operación cada tres segundos por grupo. En una avalancha las ediciones hacen cola en vez de fallar.

Reglas del partido

Si el organizador ha añadido reglas al partido, el jugador que pulse ✅ Voy las recibe en el chat privado del bot: la línea del partido, El organizador te pide que aceptes las reglas del partido: y las reglas en una cita desplegable. El último mensaje lleva ✅ Acepto y me apunto y Ahora no. Nada se guarda hasta que acepta; y si las reglas cambian mientras tanto, el bot muestra la nueva versión en vez de aceptar la antigua.

Desconectar

/unbind en el grupo detiene las publicaciones:

Listo. Ya no se publicarán partidos en este grupo.

Solo un administrador del grupo, o quien conectó los partidos, puede desconectarlos. Las publicaciones que ya están se quedan donde están: el bot simplemente deja de editarlas.

Quitar el bot del grupo tiene el mismo efecto, y tampoco dice nada al salir.

Para jugadores

Para responder no tienes que instalar nada. Pulsa ✅ Voy, ❌ No voy o ⏳ Más tarde bajo la publicación y la lista se actualiza.

Cambiar de idea es el mismo gesto: pulsa otro botón. La publicación se edita y en el grupo no se anuncia nada.

Apuntarse sin la app

Si tu Telegram no está vinculado a Amator, el bot abre su chat privado y te ofrece crear un perfil con tu cuenta de Telegram, sin contraseña. La tarjeta muestra el partido, un saludo y una línea de consentimiento:

Al continuar, aceptas las Condiciones de uso y la Política de privacidad y confirmas que tienes 16 años o más.

No hay casillas que marcar. La respuesta son tres botones:

botónqué pasa
✅ Acepto, apúntamese crea el perfil y se aplica tu respuesta. El bot registra en qué idioma se mostró la tarjeta y el texto exacto que aceptaste.
Ya tengo una cuenta de Amatorno se crea nada. El bot explica cómo vincular Telegram en la app — Perfil → Ajustes → Cuentas conectadas → Telegram — y guarda tu respuesta 24 horas, así que cuenta en cuanto la vincules.
Aún no tengo 16no se crea nada. Amator está disponible a partir de los 16 años. Vuelve cuando los cumplas.
Screenshot

El chat privado del bot con la tarjeta de inscripción: la línea del partido, un saludo, la frase de consentimiento con sus dos enlaces y los tres botones debajo

La tarjeta en el chat privado del bot, para quien todavía no tiene su Telegram vinculado a Amator.

El paso del teléfono

Algunos partidos necesitan un número de teléfono verificado. Cuando es lo único que falta, el bot lo remata en el chat privado: lo pide una vez y muestra el botón Compartir número de teléfono.

El número tiene que llegar por ese botón: Telegram lo envía como contacto y tiene que ser el tuyo. Escrito a mano el bot no lo acepta. En cuanto queda verificado, la respuesta que diste en el grupo se aplica en el mismo paso y el teclado desaparece.

Screenshot

El chat privado del bot pidiendo un número de teléfono, con el botón propio de Telegram «Compartir número de teléfono» en el teclado de respuesta

El paso del teléfono: una pregunta, un botón, y el número lo envía Telegram.

Si prefieres no compartirlo, no hagas nada: no se guarda nada y simplemente no quedas apuntado. La próxima vez que pulses ✅ Voy, el bot lo vuelve a pedir.

Todos los comandos

Los seis comandos funcionan solo en un grupo. El bot no tiene menú de comandos en el chat privado, y un comando escrito ahí no recibe ninguna respuesta: el chat privado es para la tarjeta de inscripción, las reglas y el teléfono, y eso lo empieza el bot.

comandoquién puedequé responde
/gamescualquiera en un grupo conectadolos próximos partidos de aquí, hasta diez, con cada línea enlazando a su publicación.
/nextcualquiera en un grupo conectadosalta a la publicación del próximo partido. Si ese partido aún no tiene publicación aquí, el bot envía la publicación.
/helpcualquiera: el único comando que responde también en un grupo todavía sin conectarqué hace el bot, con enlaces a las apps y a la web.
/settingsadministradores del grupolos ajustes de publicación de este grupo, un botón por organizador conectado. Sin Mini App responde dónde están en la app. Quien no es administrador no recibe respuesta alguna.
/bindadministradores del grupoconecta un organizador o un club a este grupo.
/unbindadministradores del grupo, o quien conectó los partidoslos desconecta.
Screenshot

La respuesta del bot a /games: una lista corta de los próximos partidos de este grupo, con cada línea enlazando a su publicación

`/games` en un grupo conectado.

El bot responde como mucho una vez cada treinta segundos por grupo y borra su propia respuesta a los diez minutos, así que /games en un grupo con mucho movimiento no se convierte en una segunda conversación.

Preguntas

¿Qué ve el bot en el grupo?

En un grupo el bot mira un solo campo de cada mensaje —su texto— y solo para ver si empieza por uno de los seis comandos. Todo lo demás pasa de largo y nunca se vuelve a leer, ni se guarda, ni se envía a ninguna parte. El contenido de los mensajes no sale de Telegram.

Lo que sí viaja a Amator es poco: el id del grupo, su tipo y su título, el id y la condición de administrador de quien ejecutó un comando y, cuando alguien pulsa un botón, su id de Telegram con el partido y la elección. Los nombres de los jugadores en las publicaciones llegan de Amator ya filtrados por privacidad; el bot solo los prepara para Telegram.

¿Y si quitan el bot del grupo?

Las publicaciones que ya están en el grupo se quedan, y el bot deja de editarlas. No se borra nada y no se anuncia nada. Si lo vuelves a añadir y envías /bind, todo arranca otra vez.

¿En qué idiomas responde?

En ocho: español, inglés, polaco, ucraniano, ruso, checo, alemán y francés. Una respuesta sigue, por este orden, el idioma de la sesión de inscripción, luego el de tu perfil de Amator, luego el de tu Telegram si es uno de los ocho, y luego el del grupo; y el inglés si no encaja ninguno.

Una publicación de grupo va siempre en el idioma elegido para esa conexión, no en el de cada lector. El menú de comandos se instala por idioma, así que cada persona lo ve en el suyo.