Caso de estudio · En producción

Asistente Ajedrez

Bot de WhatsApp + dashboard web para gestionar un negocio de clases de ajedrez internacionales. Pagos, agenda y alumnos — todo en lenguaje natural.

Industria Educación / Freelance
Tipo Bot WhatsApp + Dashboard web
Estado ✅ En producción
Stack Python · Flask · Twilio · Claude API
20+ alumnos internacionales gestionados desde WhatsApp
3 monedas (USD, GBP, ARS) en un solo sistema
0hs de carga manual de clases — sincroniza solo con Google Calendar

Gestionar un negocio de clases desde WhatsApp, sin morir en el intento

Como profesora de ajedrez con alumnos en Argentina, USA y UK, tenía un problema operativo real: cada mes necesitaba recordar quién debía, cuántas clases había dado, qué precio correspondía según el volumen contratado, y en qué moneda cobraba a cada familia. Todo esto lo manejaba entre conversaciones de WhatsApp y Google Calendar — sin un sistema que conectara los puntos.

La complejidad extra: algunas familias tienen varios hijos. El padre o madre paga por todos juntos, y el precio por clase baja según el total combinado. Calcular eso a fin de mes, para cada familia, era un proceso manual y propenso a errores.

No quería una planilla de cálculo. Quería poder escribir "Grace pagó 200 dólares por Wise" y que el sistema entendiera, registrara y respondiera.

Un asistente que entiende cómo hablás, no cómo programa un sistema

Asistente Ajedrez es un bot de WhatsApp conectado a un dashboard web. El bot interpreta mensajes en lenguaje natural usando la API de Claude (Haiku), los convierte en acciones concretas sobre la base de datos, y responde con información estructurada. El dashboard refleja todo en tiempo real y permite gestionar lo que no conviene hacer desde el celular.

Google Calendar es la fuente de verdad para el agendamiento. El sistema sincroniza automáticamente las clases del calendario y las asocia a los alumnos correctos — con fuzzy matching para nombres con variaciones o alias.

Así se ve en uso

Dashboard — tab Cobros con vista por responsable
Tab Cobros — quién debe, cuántas clases sin pagar y el monto en su moneda. Vista por responsable para familias con varios hijos.
Dashboard — tab Clases con chat embebido
Tab Clases + chat embebido en acción: ausente vs. cancelada, con el bot respondiendo en tiempo real.
Dashboard — tab Pagos con multi-moneda
Tab Pagos — historial completo con moneda, método de pago, clases cubiertas y totales por divisa.
Dashboard — tab Alumnos
Tab Alumnos — tabla completa con representante, país, moneda, modalidad y estado de pago del mes.
Dashboard — tab Gráficos en tema oscuro
Tab Gráficos en tema oscuro — clases por mes y evolución de ingresos convertidos a USD equivalente.

Lenguaje natural, respuestas estructuradas

El bot interpreta mensajes ambiguos, resuelve aliases y fuzzy matching de nombres, y mantiene contexto conversacional para flujos de varios pasos.

WhatsApp — agregar alumno y asignar representante
Agregar alumno y asignar representante
WhatsApp — configurar precios por volumen
Precios escalonados por volumen
WhatsApp — consultas de resumen y fuzzy matching
Resumen y fuzzy matching de nombres

Por qué cada tecnología

Python + Flask
Backend liviano y rápido de iterar — ideal para un proyecto que empezó como herramienta propia y creció orgánicamente
Twilio WhatsApp API
Integración robusta con WhatsApp Business para recibir y enviar mensajes vía webhooks, sin depender de soluciones no oficiales
Claude API (Haiku)
Interpreta mensajes en lenguaje natural y los convierte en intenciones estructuradas (JSON) que el backend ejecuta — rápido y de bajo costo por mensaje
Google Calendar API
Fuente de verdad para el agendamiento — la profesora ya usaba Calendar, así que el sistema se integra a su flujo existente en lugar de reemplazarlo
SQLite + Railway
Base de datos simple y sin configuración para un negocio de escala individual. Railway permite deploy directo desde GitHub con variables de entorno seguras
Fuzzy Matching
Los nombres de alumnos se escriben de muchas formas distintas en WhatsApp. El sistema usa similitud de texto para encontrar al alumno correcto aunque el nombre venga abreviado o con error tipográfico

¿Tu negocio también vive en WhatsApp y en planillas?

Si gestionás clientes, cobros o agenda de forma manual y querés un sistema que entienda cómo hablás, puedo construirte algo similar adaptado a tu rubro. Hablemos.