KUTSUYA
Bot de Telegram para dos operadores: registrar ventas en clicks desde donde sea, en menos de 30 segundos.
Conocer al cliente. Quién es la marca y a quién le vende.
El cliente
Kutsuya es una tienda de sneakers en México que mueve pares por Instagram, entre fundador y socio. La operación entera vive en sus celulares — a veces desktop — y registrar cada venta en el Sheet, campo por campo, comía minutos. Construimos un bot de Telegram donde casi todo es un click: tallas, marcas, condición, status y compradores recurrentes salen como botones. Solo el precio se escribe. El Sheet del cliente se actualiza solo, igual desde el celular del fundador, el desktop del socio o un Telegram abierto en otra ciudad.
Lo que venían a resolver, contado sin tecnicismos.
Reto
- 01Dos operadores — fundador y socio — registrando desde donde estén, en cualquier dispositivo.
- 02Cada operación tiene 8+ campos: marca, modelo, talla, condición, costo, precio, comprador, status.
- 03Escribir todo a mano en el Sheet — mobile o desktop — comía minutos por cada venta.
- 04Riesgo de pisar cambios cuando ambos editaban la misma fila al mismo tiempo.
Qué cambió entre el primer día y el lanzamiento.
El antes y el después
CAPTURA MANUAL EN SHEET
- Buscar la fila correcta y escribir 8+ campos a mano
- Solo una persona a la vez sin pisar cambios
- Lento en el celular, igual de lento en el desktop
- Mismo flujo cada vez, sin atajos
CLICKS EN TELEGRAM
- Tallas, marcas, condición y status como botones
- Compradores recurrentes listos para un click
- Solo precio y nombres nuevos se escriben
- Fundador y socio operan en paralelo, sin conflictos
Cada feature pensada para que el cliente cierre la operación.
Lo que construimos
Clicks en vez de teclado
Tallas, marcas, condición del par, status del pedido y compradores recurrentes salen como botones en el chat. Solo el precio y los compradores nuevos se escriben. Una venta cierra en menos de 30 segundos, contra varios minutos llenando el Sheet a mano.
- Inline keyboards para tallas, marcas, condición y status
- Compradores recurrentes precargados; opción para uno nuevo
- Solo precio (y nombres nuevos) requieren teclado
- Validación campo por campo: no avanzas si falta info
Dos operadores, un solo Sheet
Fundador y socio operan el bot desde sus propios dispositivos al mismo tiempo. Whitelist por chat_id, escritura serializada al Sheet — ambos ven la misma verdad sin pisar cambios.
- Whitelist por chat_id para los dos operadores
- Cada operación queda firmada con su autor
- Cero conflictos de escritura al Sheet
- Mismo flujo en mobile y desktop
Cada par con su propio timeline
Cada zapato tiene su ciclo de vida visible: compra → en camino → en bodega → vendido. Cambias estado con un click en el botón correspondiente y el Sheet refleja el cambio al instante.
- Botones para mover entre status del flujo
- Histórico de cambios por par
- Filtra por status desde el Sheet
- Visibilidad por talla y modelo
El Sheet sigue siendo del cliente
La fuente de datos es Google Sheets, no nuestra base de datos. El bot escribe, los operadores abren la hoja desde cualquier navegador y leen, filtran o exportan sin depender del bot. Si Telegram se cae, los datos siguen ahí.
- Google Sheets como única fuente de verdad
- Acceso desde cualquier navegador
- Exportable a CSV o Excel cuando quieras
- Cero dependencia del bot para leer datos
Nuestros cinco pasos aplicados a este proyecto real.
Proceso
- 01Sem 1
Descubrimiento
Sesión con fundador y socio: cómo registran hoy, qué campos llenan, qué tallas y marcas manejan, quiénes son los compradores recurrentes. El mapa que después se convierte en botones.
- Mapa del Sheet actual
- Catálogos del cliente: tallas, marcas, compradores
- 02Sem 1
Diseño conversacional + presets
Mapeamos los catálogos del cliente (tallas, marcas, condición, status, compradores recurrentes) y los volvemos inline keyboards de Telegram. Para cada operación, definimos qué campos son click y cuáles requieren teclado.
- Mapa de comandos + presets
- Layouts de inline keyboards por operación
- 03Sem 2
Construcción
Implementación con python-telegram-bot. Cada comando con su ConversationHandler e inline keyboards precargados. Whitelist por chat_id para fundador y socio. Escritura serializada al Sheet vía gspread.
- Bot funcional en staging
- Sheet conectado por Service Account
- 04Sem 3
Lanzamiento
Deploy en Railway con polling. Acompañamos a fundador y socio la primera semana de uso real y ajustamos los presets (compradores recurrentes que faltaban, tallas no contempladas) según fricciones que aparecen en operación.
- Bot en producción para los dos operadores
- Manual conversacional + atajos comunes
- 05Sem 3+
Escala
Con datos reales de tres semanas, sumamos atajos para operaciones repetidas (combinaciones marca+modelo más vendidas) y un reporte semanal por chat con utilidad por par y rotación.
- Comandos /resumen y /stock
- Reporte semanal automático
- 01Sem 1
Descubrimiento
Sesión con fundador y socio: cómo registran hoy, qué campos llenan, qué tallas y marcas manejan, quiénes son los compradores recurrentes. El mapa que después se convierte en botones.
- Mapa del Sheet actual
- Catálogos del cliente: tallas, marcas, compradores
- 02Sem 1
Diseño conversacional + presets
Mapeamos los catálogos del cliente (tallas, marcas, condición, status, compradores recurrentes) y los volvemos inline keyboards de Telegram. Para cada operación, definimos qué campos son click y cuáles requieren teclado.
- Mapa de comandos + presets
- Layouts de inline keyboards por operación
- 03Sem 2
Construcción
Implementación con python-telegram-bot. Cada comando con su ConversationHandler e inline keyboards precargados. Whitelist por chat_id para fundador y socio. Escritura serializada al Sheet vía gspread.
- Bot funcional en staging
- Sheet conectado por Service Account
- 04Sem 3
Lanzamiento
Deploy en Railway con polling. Acompañamos a fundador y socio la primera semana de uso real y ajustamos los presets (compradores recurrentes que faltaban, tallas no contempladas) según fricciones que aparecen en operación.
- Bot en producción para los dos operadores
- Manual conversacional + atajos comunes
- 05Sem 3+
Escala
Con datos reales de tres semanas, sumamos atajos para operaciones repetidas (combinaciones marca+modelo más vendidas) y un reporte semanal por chat con utilidad por par y rotación.
- Comandos /resumen y /stock
- Reporte semanal automático
Los números que dejó el proyecto en producción.
Qué cambió
Una venta o compra cierra en menos de medio minuto, contra varios minutos llenando filas a mano.
Talla, marca, condición, status y compradores recurrentes son botones. Solo precio y nombres nuevos se escriben.
Ambos registran al mismo tiempo desde sus dispositivos. La escritura se serializa y el Sheet siempre queda consistente.
El bot retiene la operación hasta que todos los campos críticos estén llenos. Cero filas a medias en el Sheet.
Capturas del sitio en producción.
Cómo se ve
Las tecnologías que sostienen la operación.
Tecnologías
- Python 3.11
- python-telegram-bot
- InlineKeyboardMarkup
- Google Sheets API
- gspread
- Service Account
- Railway
- Whitelist por chat_id
- Logging estructurado
¿Algo así para tu negocio?
Si este case te hizo click, hablamos. Te respondemos en menos de un día hábil, sin compromiso.