Quiniela Tena — de hoja de cálculo a sistema automatizado
Empezó como una quiniela de fútbol entre compañeros de oficina y terminó siendo un sistema con generación de código en tiempo de ejecución, lectura de correo bancario, un bot de Telegram y un panel de participación que no mentía. Esto es cómo quedó armado por debajo y cómo se conectan sus piezas.
El problema no era el fútbol, era la operación
La quiniela corre en un grupo de WhatsApp de más de 60 personas, por temporada (Liga MX, Leagues Cup, Champions). Cada jornada hay que armar el formulario de pronósticos, revisar quién respondió, buscar los resultados, publicar un banner, detectar quién pagó, cobrarle al que no, y avisar quién ganó. Nada de eso es difícil de hacer una vez. Es difícil hacerlo bien, cada semana, durante meses, sin que a nadie se le pase un depósito o un pronóstico. Ese es el problema que vale la pena automatizar: no el cálculo de puntos, sino la operación alrededor de él.
Diez años de ajustes: de una hoja de Excel a cinco minutos de clics
Antes de que existiera una sola línea de código de Firestore o Apps Script, la quiniela ya llevaba años corriendo — a mano, con Excel, y con un equipo de tres personas repartiendo el trabajo. Así se fue moviendo esa línea entre "lo hace una persona a mano" y "lo hace el sistema solo":
Una hoja de Excel y un grupo de WhatsApp
Lista de partidos del fin de semana con columnas Local/Empate/Visita. Cada participante llenaba el archivo y lo regresaba; el organizador vaciaba cada respuesta a mano en una matriz de seguimiento y compartía la tabla actualizada como imagen en el grupo.
Google Forms, y el banner hecho a mano
Los pronósticos se mudan a un Google Form. En paralelo nace el banner visual: una base de datos de escudos armada en Excel, y una macro que generaba cada partido como imagen, uno por uno, hasta juntar los 20 de la jornada.
Drive + Apps Script generan el formulario solos
Con los banners ya subidos a Drive, un Apps Script arma el Google Form automáticamente — una pregunta por partido, banner incluido. El trabajo manual se reduce a darle formato visual al formulario ya generado.
De Excel a un sitio en Firebase
El hartazgo de ser el único que podía actualizar la tabla y compartirla lleva a buscar dónde alojar un sitio propio. Aparece Firebase, y con él Firestore. La primera versión solo muestra la tabla al público — el resultado todavía se captura a mano, en modo admin.
ESPN, 365Scores, y todo en un clic
La app empieza a leer la API de ESPN para listar los partidos del día, y la de 365Scores para el canal y la sede — el banner se arma solo. Con un clic más genera también el Apps Script completo de la jornada: formulario, sincronización, resultados y avisos, todo en el mismo script.
Una cuenta dedicada lee el banco por ti
Una cuenta de Google aparte, solo para notificaciones bancarias, alimenta un Apps Script que lee los correos de depósito y los sube a un dashboard. La asignación final a cada participante sigue siendo manual — pagos de varias jornadas de golpe o pagos hechos por otra persona no se resuelven solos.
Por qué Telegram, y no WhatsApp
El bot se construye sobre Telegram por costo — su API es gratis, la de WhatsApp Business no — y termina mandando 4 tipos de aviso: alguien se registra, alguien paga, se publica un resultado, y alguien gana la jornada. (La quiniela juega Liga MX, Leagues Cup y Champions desde el inicio.)
El resultado de todos esos ajustes, uno encima del otro durante años, se mide mejor en gente y en minutos que en líneas de código:
El organizador se tardaba cerca de una hora, desde buscar los partidos hasta compartir el formulario. El tesorero, otros 30 minutos variables entrando a la app del banco. El de seguimiento no tenía un tiempo fijo — era el rol más irregular de los tres, porque estar pendiente de cada marcador en tiempo real no siempre era posible, así que se terminaba actualizando todo de golpe en la noche. Hoy, una sola persona hace el equivalente al rol del organizador en unos 5 minutos de clics, y el seguimiento de resultados ya ni espera a que alguien se siente: ESPN avisa, el bot publica, y la app se actualiza sola.
Arquitectura: cinco piezas que no comparten código entre sí
El sistema vive repartido en servicios que no se hablan por import, solo por datos. Eso termina siendo la decisión de diseño más importante de todo el proyecto.
Panel web (SPA)
Es la misma app de Quiniela Tena — JavaScript sin framework, un solo archivo HTML. Lee y escribe un documento de Firestore por torneo vía REST, y es desde ahí donde se genera el código del Apps Script de cada jornada — no se comparte, se escribe.
Firestore
Un documento de estado por torneo (quiniela/state, quiniela/torneo_leaguescup…) con todo el payload serializado en un solo campo JSON. Las reglas permiten get por ID conocido pero bloquean list — no hay forma de enumerar torneos, solo de pedir el que ya conoces.
Apps Script generado
Un script distinto por jornada, subido directo a un proyecto de Apps Script vía su API REST (no mediante Drive ni copy-paste). Sincroniza el Google Form, consulta resultados, genera el banner y dispara los avisos de Telegram.
Bot de Telegram
Un único canal de salida para cuatro eventos distintos: alguien se registra, alguien paga, se publica un resultado, y — lo último que se agregó — hay un ganador de la jornada.
Depósitos (proyecto separado)
Otro proyecto de Apps Script, en otra cuenta de Google, sin nada compartido con el anterior. Lee el correo del banco cada 15 minutos, identifica al pagador por los últimos 4 dígitos de su cuenta, y escribe en una hoja de cálculo que alimenta un dashboard de cobranza.
Mapa de integraciones: cómo se mueven los datos entre sistemas
Ninguna de estas piezas comparte código, pero todas comparten datos en una secuencia muy concreta. Así se ve una jornada completa, de principio a fin, cruzando cinco servicios distintos:
Alguien responde el Google Form
Cada jornada tiene su propio formulario, generado y subido junto con el resto del código de esa jornada.
El Apps Script sincroniza esa respuesta a Firestore
Mismo documento de estado que lee y escribe el panel web — sin que el navegador tenga que estar abierto para que la sincronización ocurra.
Consulta la API de ESPN
En cuanto hay marcador real, el script lo trae automáticamente. Nadie busca resultados a mano, partido por partido.
Le pide a un servicio en Cloud Run que renderice el banner
Escudos, marcador y texto, convertidos en una imagen lista para compartir — el navegador nunca participa en esto.
Guarda el banner en Google Drive y lo publica en Telegram
Mismo canal que ya se usa para los demás avisos del bot.
En paralelo, Depósitos lee Gmail cada 15 minutos
Un proyecto de Apps Script aparte, en otra cuenta de Google, que identifica pagos directamente en los correos del banco.
Escribe cada depósito en una hoja de Google Sheets
Esa hoja alimenta un dashboard web de cobranza, y cualquier depósito nuevo dispara un aviso en el mismo canal de Telegram.
Siete pasos, cinco servicios (Forms, Firestore, ESPN, Cloud Run, Drive, Sheets, Telegram), y ningún humano en medio del camino.
El flujo de una jornada, de principio a fin
El mapa de arriba es la vista de sistemas. Esta es la vista de operación: qué pasaba antes a mano, jornada tras jornada, y qué de eso sigue siendo una decisión humana contra qué ya corre solo.
Elegir los partidos de la jornada
La única decisión que sigue siendo humana: qué partidos entran a esta jornada, capturados en el panel.
Antes del partido
Canal y horario de transmisión
Banner de recordatorio
Después del partido
Resultado, goleadores y tarjetas (ESPN)
Banner de resultado
Aviso en el grupo de Telegram
Antes, cada caja automática de este diagrama era una pestaña abierta a mano: revisar el resultado en ESPN, ver si hubo roja, buscar el canal, armar el banner en una herramienta de diseño, y subirlo al grupo — cuatro o cinco veces por jornada, partido por partido. Hoy la única caja que sigue siendo una persona es la primera.
El patrón que sostiene todo: generar código, no compartirlo
Apps Script no tiene un mecanismo real de librerías compartidas entre proyectos que valga la pena mantener para algo de este tamaño, y cada jornada necesita su propio formulario, su propia cola de sincronización y sus propios disparadores — con datos distintos (equipos, fechas, el torneo activo). La solución que terminó siendo más simple que pelearse contra esa limitación fue invertir el problema: en vez de desplegar un script reutilizable, el panel web construye el texto completo del script de Apps Script como una plantilla de JavaScript, con los datos de esa jornada ya insertados, y lo sube entero vía la API REST de Apps Script (PUT /v1/projects/{id}/content) cada vez que se activa una jornada.
El costo de ese patrón es que la lógica de negocio que importa — quién ganó, cuánto es el premio — no puede vivir en un solo lugar: existe una vez en el navegador (para mostrarla en el panel) y otra vez dentro de la plantilla que genera el Apps Script (para que el bot pueda calcularla sola, sin el navegador abierto). Son dos implementaciones de la misma regla, y mantenerlas sincronizadas es, con diferencia, la fuente más repetida de bugs en todo el proyecto.
Cómo se atrapan esos bugs antes de producción
Extraer la función generadora
Se aísla el código fuente de la función que construye el texto del Apps Script, por marcadores de inicio y fin, sin tocar el resto del bundle.
Correrla en un sandbox de Node (vm)
Con stubs de document.getElementById (un objeto con getter/setter que actúa como "sumidero" del texto generado) y de las globales que esa función necesita del resto de la app.
Verificar sintaxis con new Function()
El texto generado — el futuro Código.gs — se compila como función de JavaScript. Si hay un salto de línea crudo donde no debería, truena aquí, antes de subirse a ningún lado.
Ejecutarlo con globales de Apps Script simuladas
PropertiesService, UrlFetchApp y Logger simulados, con escenarios de prueba (empates, jornadas incompletas, premio con y sin pozo) para confirmar comportamiento, no solo sintaxis.
El mismo patrón sirvió para verificar, antes de subir nada, la función que calcula y anuncia al ganador de la jornada por Telegram — incluyendo el caso de empate (el premio se reparte) y la protección contra doble aviso si el disparador vuelve a correr sobre la misma jornada.
Tres cosas de Apps Script que cuestan una tarde de debugging si no las sabes
Los disparadores llaman sin argumentos
Un trigger por tiempo invoca la función con cero parámetros, siempre. Una función parametrizada registrada por error como trigger truena con Argumento no válido: value — un mensaje que no menciona para nada el problema real.
Las web apps se congelan en su versión desplegada
Pegar código nuevo en el editor y guardar no actualiza la URL /exec que usa un dashboard. Hace falta "Implementar → Nueva versión" explícitamente. El código del proyecto normal (triggers) sí usa la versión más reciente guardada — son dos reglas distintas dentro del mismo producto.
get sí, list no
Las reglas de Firestore de este proyecto permiten leer un documento por ID conocido, pero bloquean enumerar la colección (403). El diseño de datos tiene que asumir eso desde el principio: cada torneo necesita un ID fijo y conocido, nunca se descubre.
Dentro del bot: así se ve
El banner de resultado es real — lo generó el bot para la Jornada 16. El canal de Telegram y el dashboard de depósitos que siguen son recreaciones ilustrativas, con datos de ejemplo, no capturas reales.
Banner real · generado automáticamente al cerrar el resultado de la Jornada 16
✅ Nuevo registro
Jugador 23 se registró para la Jornada 16.
💰 Depósito detectado
De: Jugador 7 · Monto: $350.00
Cuenta: ****8831
⚽ Resultado
América 2 – 1 Cruz Azul
Jornada 16
🏆 Ganador de la Jornada 16
Jugador 11 con 14 aciertos.
Premio: $620 MXN.
Un solo canal, cuatro tipos de aviso
Reasignar siempre disponible, no solo cuando falla la detección
Lo que el bot ya hace solo
Arma el formulario de cada jornada
Equipos, fechas y banners listos sin copiar nada a mano.
Sincroniza los pronósticos
En cuanto alguien responde el formulario, sin revisión manual en el panel.
Publica resultados y banner
Consulta el resultado, genera el banner con escudos y marcador, y lo manda al grupo.
Detecta depósitos y avisa
Lee el correo del banco, identifica al pagador por cuenta, y avisa en el grupo quién pagó y cuánto — sin que nadie entre al banco a revisar.
Anuncia al ganador
En cuanto se completa el último resultado pendiente de la jornada, calcula quién tuvo más aciertos (reparte en caso de empate) y lo anuncia — una sola vez por jornada.
Ningún paso de esta lista necesita que alguien esté viendo un chat o entrando al banco. El trabajo de administrar la quiniela, jornada tras jornada, ya no existe como tal.