← Blog
Caso de estudio · 2026

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.

Firestore Google Apps Script Telegram Bot API Cloud Run

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":

El inicio

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.

Primeros ajustes

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.

El primer script

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.

Nace la app

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.

Se conecta con el mundo

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.

Deja de perseguir depósitos

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.

El último canal

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:

Personas por jornada
3 → 1
organizador, tesorero y seguimiento, hoy en una sola persona
Tiempo por jornada
~1h40 → ~5 min
de buscar los partidos a compartir la URL del formulario
Seguimiento de resultados
Horas → tiempo real
antes se capturaba de noche, todos los partidos juntos

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:

01

Alguien responde el Google Form

Cada jornada tiene su propio formulario, generado y subido junto con el resto del código de esa jornada.

02

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.

03

Consulta la API de ESPN

En cuanto hay marcador real, el script lo trae automáticamente. Nadie busca resultados a mano, partido por partido.

04

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.

05

Guarda el banner en Google Drive y lo publica en Telegram

Mismo canal que ya se usa para los demás avisos del bot.

06

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.

07

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.

Manual

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

Automático

Canal y horario de transmisión

↓
Automático

Banner de recordatorio

Después del partido

Automático

Resultado, goleadores y tarjetas (ESPN)

↓
Automático

Banner de resultado

↓   mismo canal   ↓
Automático

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

01

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.

02

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.

03

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.

04

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

🤖
QuinielaBot
bot · Quiniela Tena

✅ Nuevo registro
Jugador 23 se registró para la Jornada 16.

10:04

💰 Depósito detectado
De: Jugador 7 · Monto: $350.00
Cuenta: ****8831

10:12

⚽ Resultado
América 2 – 1 Cruz Azul
Jornada 16

19:47

🏆 Ganador de la Jornada 16
Jugador 11 con 14 aciertos.
Premio: $620 MXN.

21:03

Un solo canal, cuatro tipos de aviso

Panel de Depósitos — Jornada 16 🔄 Buscar correos
HoraMontoCuentaAsignado a
09:58$350****8831Jugador 7Pagado
08:21$300****2290SIN IDENTIFICAR Nombre…Asignar
07:40$300****5510Jugador 19 Jugador 19Reasignar

Reasignar siempre disponible, no solo cuando falla la detección

Lo que el bot ya hace solo

01

Arma el formulario de cada jornada

Equipos, fechas y banners listos sin copiar nada a mano.

02

Sincroniza los pronósticos

En cuanto alguien responde el formulario, sin revisión manual en el panel.

03

Publica resultados y banner

Consulta el resultado, genera el banner con escudos y marcador, y lo manda al grupo.

04

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.

05

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.